Skip to content

Commit 69a4c9b

Browse files
amakarudzeamakarudze
committed
Add RunCode Cloud Development instructions
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
1 parent d94c065 commit 69a4c9b

9 files changed

Lines changed: 94 additions & 0 deletions

File tree

‎en/SUMMARY.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@
1111
* [GitHub](installation/README.md#github-account)
1212
* [PythonAnywhere](installation/README.md#pythonanywhere-account)
1313
* [Installation (chromebook)](chromebook_setup/README.md)
14+
* [Installation (RunCode Cloud)](cloud_development_setup/README.md)
1415
* [How the Internet works](how_the_internet_works/README.md)
1516
* [Introduction to command line](intro_to_command_line/README.md)
1617
* [Python installation](python_installation/README.md)

‎en/cloud_development_setup/README.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# RunCode Cloud Environment setup
2+
3+
> **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).
4+
5+
{% include "/cloud_development_setup/instructions.md" %}

‎en/cloud_development_setup/instructions.md‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
You can [skip right over this section](http://tutorial.djangogirls.org/en/installation/#install-python)
2+
if you're not using RunCode Cloud Development environment. If you are, your installation experience will be a little different.
3+
You can ignore the rest of the installation instructions as you do not need to install anything locally,
4+
you just need to create three online accounts.
5+
6+
## About RunCode
7+
RunCode is a cloud development environment which people can use without the need to install Python, Django and Visual
8+
Studio Code editor locally on their machines. This cloud environment enables anyone to work from any device that has
9+
an internet connection, including cellphones, tablets, laptop or desktop.
10+
11+
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
12+
environment and you can always do the installation later own as a follow-up after finishing the tutorial.
13+
14+
## Create a RunCode account
15+
Go to [RunCode.io](https://runcode.io/) and sign up for a new, free user account. You need to have a
16+
[Google.com](https://www.google.com/intl/en-GB/gmail/about/) account or [GitHub.com](https://github.com/)
17+
which you can sign up with.
18+
19+
## Create a GitHub account
20+
Go to [GitHub.com](https://github.com/) and sign up for a new, free user account.Skip this step if you already did
21+
this in the previous step so you could sign up for RunCode.
22+
23+
## Create a PythonAnywhere account {#pythonanywhere-account}
24+
{% include "/deploy/signup_pythonanywhere.md" %}

‎en/django_installation/instructions.md‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,6 +104,26 @@ $ python3 -m venv myvenv
104104
105105
<!--endsec-->
106106
107+
<!--sec data-title="Virtual Environment: RunCode" data-id="virtualenv-runcode" -->
108+
To create a new `virtualenv` on RunCode, you first need to install the `virtualenv` module. To do so, first you need to update
109+
the packages in your environment
110+
>```
111+
>$ sudo apt-get update -y
112+
>```
113+
> then install `virtualenv` by running the command:
114+
>```
115+
>$ sudo apt-get install -y virtualenv
116+
>```
117+
118+
> After this you can create the `virtualenv` run the command:
119+
>```
120+
>$ virtualenv -p python myvenv
121+
>```
122+
> and a new `virtualenv` with the name `myvenv` or whatever name you chose should be created in your `djangogirls` folder.
123+
124+
<!--endsec-->
125+
126+
107127
## Working with virtualenv
108128
109129
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!
159179
160180
<!--endsec-->
161181
182+
<!--sec data-title="Working with virtualenv: RunCode" data-id="virtualenv_runcode"
183+
data-collapse=true ces-->
184+
>Start your virtual environment by running:
185+
>```
186+
>$ . myvenv/bin/activate
187+
>```
188+
189+
<!--endsec-->
190+
162191
You will know that you have `virtualenv` started when you see that the prompt in your console is prefixed with `(myvenv)`.
163192
164193
When working within a virtual environment, `python` will automatically refer to the correct version so you can use `python` instead of `python3`.

‎en/django_start_project/README.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -252,6 +252,15 @@ or on Glitch:
252252
https://name-of-your-glitch-project.glitch.me
253253
```
254254

255+
If you are using RunCode cloud platform, the URL will look something like this:
256+
`https://8000-soft-limit-18855079.eu-ws4.runcode.io/`. To view your own instance, the URL will be like:
257+
258+
{% filename %}browser{% endfilename %}
259+
```
260+
https://8000-the-name-of-your-runcode-instance.eu-ws4.runcode.io/
261+
```
262+
You can open this in another browser window and you should see the Django install worked page.
263+
255264
Congratulations! You've just created your first website and run it using a web server! Isn't that awesome?
256265

257266
![Install worked!](images/install_worked.png)

‎en/installation/README.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,11 @@ data-id="chromebook_setup" data-collapse=true ces-->
2121
{% include "/chromebook_setup/instructions.md" %}
2222
<!--endsec-->
2323

24+
<!-- sec data-title="RunCode Cloud Development setup (if you are using cloud development)"
25+
data-id="cloud_development" data-collapse=true ces-->
26+
{% include "/cloud_development_setup/instructions.md" %}
27+
<!--endsec-->
28+
2429
# Brief intro to the command line {#command-line}
2530
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:
2631
{% include "/intro_to_command_line/open_instructions.md" %}

‎en/intro_to_command_line/open_instructions.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,3 +26,12 @@ Go to Applications → Utilities → Terminal.
2626
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. :)
2727

2828
<!--endsec-->
29+
30+
<!--sec data-title="Opening: RunCode" data-id="runcode_prompt" data-collapse=true ces-->
31+
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.
32+
33+
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.
34+
35+
Ubuntu is a version of Linux so from now on you can follow Linux instructions.
36+
37+
<!--endsec-->

‎en/python_installation/README.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,5 +12,8 @@ Python originated in the late 1980s and its main goal is to be readable by human
1212
1313
> **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!
1414
15+
> **Note** If you're using RunCode cloud environment, you do not need to install Python as it is pre-installed on their platform
16+
so you can skip straight ahead to the next chapter!
17+
1518
{% include "/python_installation/instructions.md" %}
1619

‎en/python_introduction/prompt.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,3 +15,12 @@ Python {{ book.py_release }} (...)
1515
Type "help", "copyright", "credits" or "license" for more information.
1616
>>>
1717
```
18+
19+
<!--sec data-title="Opening: RunCode Cloud Environment" data-id="runcode_prompt" data-collapse=true ces-->
20+
21+
To open the Python terminal on RunCode, go to Workspaces → New Workspace → Jupyter Lab. This will open a Python prompt
22+
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.
23+
24+
`ubuntu@runcode:~$ python3`
25+
26+
<!--endsec-->

0 commit comments

Comments
 (0)