Add RunCode Cloud instructions

en/SUMMARY.md

@@ -2,15 +2,17 @@
 
 * [Introduction](README.md)
 * [Installation](installation/README.md)
-  * [Command Line](installation/README.md#command-line)
+  * [Installation (RunCode Cloud)](cloud_development_setup/README.md)
+  * [Installation (Chromebook)](chromebook_setup/README.md)
+  * [Installation (OS X/Windows/Linux)](installation/README.md#osx-windows-linux)
+  * [Command Line](installation/README.md#intro-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)

en/cloud_development_setup/README.md

@@ -0,0 +1,5 @@
+# RunCode Cloud Environment setup
+
+> **Note** If you already worked through the [installation steps](../installation/README.md), you do not need to also complete the RunCode Cloud Environment setup. Please skip straight to [Introduction to Python](../python_introduction/README.md). 
+
+{% include "/cloud_development_setup/instructions.md" %}

en/cloud_development_setup/instructions.md

@@ -0,0 +1,93 @@
+If you are using RunCode Cloud development environment, your installation experience will be a little different. You can ignore the rest of the installation instructions as you do not need to install anything locally, you just need to create three online accounts. 
+
+## Create a GitHub account
+Go to [GitHub.com](https://github.com/) and sign up for a new, free user account.Skip this step if you already did 
+this in the previous step so you could sign up for RunCode.
+
+## Create a RunCode account
+Go to [RunCode.io](https://runcode.io/) and sign up for a new, free user account. You need to have a 
+[Google.com](https://www.google.com/intl/en-GB/gmail/about/) account or [GitHub.com](https://github.com/) 
+which you can sign up with.
+
+## Create a PythonAnywhere account {#pythonanywhere-account}
+{% include "/deploy/signup_pythonanywhere.md" %}
+
+## Command Line
+To open the Ubuntu terminal on RunCode, go to Workspaces → New Workspace → Blank. This will open a new Visual Studio Code workspace which has an Ubuntu terminal in the bottom pane.
+
+Altenatively, you can go to Workspaces → New Workspace → Jupyter Lab. This will open a Python prompt which is depicted by `>>>`, you can type `exit()` to get back to the Ubuntu terminal.
+
+Ubuntu is a version of Linux so for all command line instructions later in the tutorial you can follow Linux instructions.
+
+## 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).
+
+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`. 
+
+To create a new `virtualenv` on RunCode, you first need to install the `virtualenv` module. To do so, first you need to update
+the packages in your environment
+>```
+>$ sudo apt-get update -y
+>```
+> then install `virtualenv` by running the command:
+>```
+>$ sudo apt-get install -y virtualenv
+>```
+
+> After this you can create the `virtualenv` run the command:
+>```
+>$ virtualenv -p python myvenv
+>```
+> and a new `virtualenv` with the name `myvenv` or whatever name you chose should be created in your `djangogirls` folder.
+
+## Working with a Virtual Environment
+>Start your virtual environment by running:
+>```
+>$ . myvenv/bin/activate
+>```
+
+### 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.9MB)
+Installing collected packages: Django
+Successfully installed Django-{{ book.django_version }}
+```
+
+That's it! You're now (finally) ready to create a Django application!

en/code_editor/README.md

@@ -8,4 +8,6 @@ You're about to write your first line of code, so it's time to download a code e
 
 > **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!
 
+> **Note** If you have followed [RunCode Setup](../cloud_development_setup/README.md) you can skip this section as Visual Studio Code is pre-installed on the platform.
+
 {% include "/code_editor/instructions.md" %}

en/django_installation/README.md

@@ -2,6 +2,8 @@
 
 > **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 RunCode, skip this chapter and make sure you follow the [RunCode Setup](../cloud_development_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" %}

en/django_installation/instructions.md

@@ -104,6 +104,7 @@ $ python3 -m venv myvenv
 
 <!--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).

en/django_start_project/README.md

@@ -252,6 +252,15 @@ or on Glitch:
 https://name-of-your-glitch-project.glitch.me
 ```
 
+If you are using RunCode cloud platform, the URL will look something like this:
+`https://8000-soft-limit-18855079.eu-ws4.runcode.io/`. To view your own instance, the URL will be like:
+
+{% filename %}browser{% endfilename %}
+```
+https://8000-the-name-of-your-runcode-instance.eu-ws4.runcode.io/
+```
+You can open this in another browser window and you should see the Django install worked page.
+
 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)

en/installation/README.md

@@ -14,33 +14,61 @@ If you are attending one of the [Django Girls events](https://djangogirls.org/ev
 - 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).
+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 needed (if you are using local desktop environment) or instructed on how to create online accounts only (if you are using cloud development). This page gathers all of the installation and sign-up instructions in one place (which is useful for some workshop formats).
+
+# Cloud Development
+In this tutorial, the cloud development platform we will be using will be [RunCode](https://runcode.io/). RunCode is a cloud development environment which people can use without the need to install Python, Django and Visual Studio Code editor locally on their machines. This cloud environment enables anyone to work from any device that has an internet connection, including cellphones, tablets, laptop or desktop.
+
+This removes the need for you to install packages on a borrowed laptop or the need for you to own a laptop to attend the workshop or follow this tutorial from home as you only need to set up three online accounts. This will also save you time required for setting up your development environment. You can always do the [installation](installation/README.md#command-line) later own as a follow-up after finishing the tutorial. However, loading the development enviroment requires good and fast internet for this solution to work for you.
+
+> **Note** There are sections of this tutorial which depend on the platform you are working on. If you follow the local installation steps for Windows, Linux, OS X or Chromebook, you will need to follow instructions for your operating system. If you follow RunCode Cloud Environment setup instructions, then you will need to follow instructions for RunCode development environment. Where no specific instructions are provided for RunCode Cloud Environment, follow the Linux instructions as RunCode runs on Ubuntu Linux.
+
+
+# RunCode Cloud Development Setup
+To set up RunCode Cloud development, follow the instructions below:
+
+<!-- sec data-title="RunCode Cloud Development setup (if you are using cloud development)" 
+data-id="cloud_development" data-collapse=true ces-->
+{% include "/cloud_development_setup/instructions.md" %}
+<!--endsec-->
+
+# Chromebook Installation
+To set up your Chromebook, follow the instructions below:
 
 <!--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}
+
+# OS X, Windows, Linux Installation {#osx-windows-linux}
+> __NOTE:__  You can skip right over this section if you have followed [RunCode Cloud Development](cloud_development_setup/README.md) or [ChromeBook](chromebook_setup/README.md) installation steps. 
+
+If you are not using RunCode or Chromebook, your experience will be a little different as you need to download and install some software locally as well as set up online accounts.
+
+To install software on your machine, follow the instructions below:
+
+## Brief intro to the command line {#intro-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}
+## Install Python {#python}
 {% include "/python_installation/instructions.md" %}
 
-# Install a code editor {#code-editor}
+## Install a code editor {#code-editor}
 {% include "/code_editor/instructions.md" %}
 
-# Set up virtualenv and install Django {#virtualenv}
+## Set up virtualenv and install Django {#virtualenv}
 {% include "/django_installation/instructions.md" %}
 
-# Install Git {#git}
+## Install Git {#git}
 {% include "/deploy/install_git.md" %}
 
-# Create a GitHub account {#github-account}
+## 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}
+## Create a PythonAnywhere account {#pythonanywhere-account}
 {% include "/deploy/signup_pythonanywhere.md" %}
 
 

en/intro_to_command_line/open_instructions.md

@@ -1,4 +1,3 @@
-
 <!--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):
@@ -26,3 +25,14 @@ Go to Applications → Utilities → Terminal.
 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-->
+
+<!--sec data-title="Opening: RunCode" data-id="runcode_prompt" data-collapse=true ces-->
+> **NOTE** If you followed [RunCode setup instructions](../cloud_development_setup/README.md) follow these steps to open command line.
+
+To open the Ubuntu terminal on RunCode, go to Workspaces → New Workspace → Blank. This will open a new Visual Studio Code workspace which has an Ubuntu terminal in the bottom pane.
+
+Altenatively, you can go to Workspaces → New Workspace → Jupyter Lab. This will open a Python prompt which is depicted by `>>>`, you can type `exit()` to get back to the Ubuntu terminal.
+
+Ubuntu is a version of Linux so from now on you can follow Linux instructions.
+
+<!--endsec-->

en/python_installation/README.md

@@ -12,5 +12,7 @@ Python originated in the late 1980s and its main goal is to be readable by human
 
 > **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!
 
+> **Note** If you're using [RunCode cloud environment](../cloud_development_setup/README.md), you do not need to install Python as it is pre-installed on their platform so you can skip straight ahead to the next chapter!
+
 {% include "/python_installation/instructions.md" %}
 

en/python_introduction/prompt.md

@@ -15,3 +15,12 @@ Python {{ book.py_release }} (...)
 Type "help", "copyright", "credits" or "license" for more information.
 >>>
 ```
+
+<!--sec data-title="Opening: RunCode Cloud Environment" data-id="runcode_prompt" data-collapse=true ces-->
+
+To open the Python terminal on RunCode, go to Workspaces → New Workspace → Jupyter Lab. This will open a Python prompt 
+which is depicted by `>>>`. If you already opened an Ubuntu terminal open, in the [Intro to Command Line](../intro_to_command_line/README.md) chapter, you can just type `python3` in the prompt as shown below to open a Python prompt.
+
+`ubuntu@runcode:~$ python3`
+
+<!--endsec-->