Add RunCode Cloud Development instructions

amakarudze · amakarudze · commit 69a4c9bd702a · 2023-01-28T12:22:47.000+02:00
Add RunCode Cloud Development instructions

Remove changes to sidebar ad

Update python and django installation for RunCode

Add instructions for starting webserver

Fix some layout to RunCode sections

Fix gitbook sidebar plugin

Remove RunCode folder instruction
diff --git a/en/SUMMARY.md b/en/SUMMARY.md
@@ -11,6 +11,7 @@
   * [GitHub](installation/README.md#github-account)
   * [PythonAnywhere](installation/README.md#pythonanywhere-account)
 * [Installation (chromebook)](chromebook_setup/README.md)
+* [Installation (RunCode Cloud)](cloud_development_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)
diff --git a/en/cloud_development_setup/README.md b/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), no need to do this again – you can skip straight ahead to [Introduction to Python](../python_introduction/README.md).
+
+{% include "/cloud_development_setup/instructions.md" %}
diff --git a/en/cloud_development_setup/instructions.md b/en/cloud_development_setup/instructions.md
@@ -0,0 +1,24 @@
+You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python) 
+if you're not using RunCode Cloud Development environment. If you are, 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. 
+
+## About RunCode
+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. This will also save you time required for setting up your development
+environment and you can always do the installation later own as a follow-up after finishing the tutorial.
+
+## 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 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 PythonAnywhere account {#pythonanywhere-account}
+{% include "/deploy/signup_pythonanywhere.md" %}
diff --git a/en/django_installation/instructions.md b/en/django_installation/instructions.md
@@ -104,6 +104,26 @@ $ python3 -m venv myvenv
 
 <!--endsec-->
 
+<!--sec data-title="Virtual Environment: RunCode" data-id="virtualenv-runcode" -->
+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.
+
+<!--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).
@@ -159,6 +179,15 @@ Remember to replace `myvenv` with your chosen `virtualenv` name!
 
 <!--endsec-->
 
+<!--sec data-title="Working with virtualenv: RunCode" data-id="virtualenv_runcode"
+data-collapse=true ces-->
+>Start your virtual environment by running:
+>```
+>$ . 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`.
diff --git a/en/django_start_project/README.md b/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)
diff --git a/en/installation/README.md b/en/installation/README.md
@@ -21,6 +21,11 @@ data-id="chromebook_setup" data-collapse=true ces-->
 {% include "/chromebook_setup/instructions.md" %}
 <!--endsec-->
 
+<!-- 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-->
+
 # 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" %}
diff --git a/en/intro_to_command_line/open_instructions.md b/en/intro_to_command_line/open_instructions.md
@@ -26,3 +26,12 @@ 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-->
+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-->
diff --git a/en/python_installation/README.md b/en/python_installation/README.md
@@ -12,5 +12,8 @@ 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, 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" %}
 
diff --git a/en/python_introduction/prompt.md b/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-->
