Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update ide instructions #1844

Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions en/README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
# Django Girls Tutorial
# DjangoFest 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.
Welcome to the DjangoFest 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. :)

Expand Down Expand Up @@ -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 DjangoFest 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.

Expand Down
2 changes: 1 addition & 1 deletion en/chromebook_setup/instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -172,7 +172,7 @@ Make a [GitHub](https://github.com) account.

### PythonAnywhere

The Django Girls tutorial includes a section on what is called Deployment,
The DjangoFest 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.
Expand Down
76 changes: 67 additions & 9 deletions en/code_editor/instructions.md
Original file line number Diff line number Diff line change
@@ -1,24 +1,82 @@
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.
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 recommendation is 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.
Feel free to ask your coach what their preferences are too!

## 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/)
**[Download Visual Studio Code](https://code.visualstudio.com/)**

## Gedit
# Installing Visual Studio Code

Gedit is an open-source, free editor, available for all operating systems.
<!--sec data-title="VSCode Install for Windows" data-id="ide_windows"
data-collapse=true ces-->

[Download it here](https://wiki.gnome.org/Apps/Gedit#Download)
1. **Download Visual Studio Code:**
- Go to the official Visual Studio Code website referenced above.
- Click on the download link for Windows.

## Sublime Text
2. **Install Visual Studio Code:**
- Run the downloaded `.exe` file.
- Follow the installation prompts:
- Accept the license agreement.
- Choose the installation location.
- Select additional tasks (e.g., creating a desktop icon, adding to PATH).
- Click "Install" and then "Finish" once the installation is complete.

Sublime Text is a very popular editor with a free evaluation period and it's available for all operating systems.
3. **Open VSCode from your start menu.**

[Download it here](https://www.sublimetext.com/)
<!--endsec-->

<!--sec data-title="VSCode Install for Mac" data-id="ide_mac"
data-collapse=true ces-->

1. **Download Visual Studio Code:**
- Go to the official Visual Studio Code website referenced above.
- Click on the download link for macOS.

2. **Install Visual Studio Code:**
- Open the downloaded `.dmg` file.
- Drag the Visual Studio Code icon to the Applications folder.
- Open Visual Studio Code from the Applications folder.

3. **Open VSCode from your applications folder.**

<!--endsec-->

<!--sec data-title="VSCode Install for Linux" data-id="ide_linx"
data-collapse=true ces-->

1. **Download Visual Studio Code:**
- Go to the official Visual Studio Code website referenced above.
- Click on the download link for Linux and follow the instructions for your specific distribution.

2. **Install Visual Studio Code:**
- Follow the instructions on the Linux installation page for your specific distribution.

3. **Open VSCode from your applications menu.**

<!--endsec-->

# Setting Up Visual Studio Code

## Customize Your Setup
**Configure Settings:**
- Go to `File > Preferences > Settings` to customize your editor settings, such as font size, tab size, and more.

## Enable Autosave
1. **Open Settings:**
- Go to `File > Preferences > Settings` (or use the shortcut `Ctrl + ,` on Windows/Linux or `Cmd + ,` on macOS).
2. **Search for Autosave:**
- In the search bar at the top, type "auto save".
3. **Enable Autosave:**
- Under the "Files: Auto Save" setting, select one of the following options from the dropdown menu:
- `off`: Disable autosave.
- `afterDelay`: Automatically save files after a delay.
- `onWindowChange`: Automatically save files when the window loses focus.
- `onFocusChange`: Automatically save files when the editor loses focus.
- If you choose `afterDelay`, you can set the delay duration (e.g., 1000 ms for 1 second).

## Why are we installing a code editor?

Expand Down
6 changes: 3 additions & 3 deletions en/css/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -118,13 +118,13 @@ Your file should now look like this:
<!DOCTYPE html>
<html>
<head>
<title>Django Girls blog</title>
<title>DjangoFest blog</title>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/css/bootstrap.min.css" integrity="sha384-1BmE4kWBq78iYhFldvKuhfTAU6auU8tT94WrHftjDbrCEXSU1oBoqyl2QvZ6jIW3" crossorigin="anonymous">
<link rel="stylesheet" href="{% static 'css/blog.css' %}">
</head>
<body>
<header>
<h1><a href="/">Django Girls Blog</a></h1>
<h1><a href="/">DjangoFest Blog</a></h1>
</header>

{% for post in posts %}
Expand Down Expand Up @@ -187,7 +187,7 @@ Go ahead and name some parts of the HTML code. Replace the `header` that contain
```html
<header class="page-header">
<div class="container">
<h1><a href="/">Django Girls Blog</a></h1>
<h1><a href="/">DjangoFest Blog</a></h1>
</div>
</header>
```
Expand Down
4 changes: 2 additions & 2 deletions en/deploy/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@ 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"
$ git commit -m "My DjangoFest app, first commit"
[...]
13 files changed, 200 insertions(+)
create mode 100644 .gitignore
Expand Down Expand Up @@ -161,7 +161,7 @@ In this case, follow the instructions from GitHub to [create a personal access t

<!--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. :)
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 [DjangoFest Tutorial](https://github.com/DjangoGirls/tutorial), and many other great open source software projects also host their code on GitHub. :)

{% include "/deploy/pythonanywhere.md" %}

Expand Down
6 changes: 3 additions & 3 deletions en/django_forms/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ After editing the line, your HTML file should now look like this:
<!DOCTYPE html>
<html>
<head>
<title>Django Girls blog</title>
<title>DjangoFest blog</title>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/css/bootstrap.min.css" integrity="sha384-1BmE4kWBq78iYhFldvKuhfTAU6auU8tT94WrHftjDbrCEXSU1oBoqyl2QvZ6jIW3" crossorigin="anonymous">
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext">
<link rel="stylesheet" href="{% static 'css/blog.css' %}">
Expand All @@ -80,7 +80,7 @@ After editing the line, your HTML file should now look like this:
<a href="{% url 'post_new' %}" class="top-menu">
{% include './icons/file-earmark-plus.svg' %}
</a>
<h1><a href="/">Django Girls Blog</a></h1>
<h1><a href="/">DjangoFest Blog</a></h1>
</div>
</header>
<main class="content container">
Expand Down Expand Up @@ -259,7 +259,7 @@ def post_new(request):

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__.
You might have noticed that we are setting the publish date before saving the post. Later on, we will introduce a _publish button_ in __DjangoFest Tutorial: Extensions__.

That is awesome!

Expand Down
2 changes: 1 addition & 1 deletion en/django_templates/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ 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
<header>
<h1><a href="/">Django Girls Blog</a></h1>
<h1><a href="/">DjangoFest Blog</a></h1>
</header>

{% for post in posts %}
Expand Down
2 changes: 1 addition & 1 deletion en/how_the_internet_works/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ 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!"
Imagine that when you type https://djangogirls.org, you send a letter that says: "Dear DjangoFest, 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.

Expand Down
4 changes: 2 additions & 2 deletions en/html/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -127,11 +127,11 @@ Here's an example of a full template, copy and paste it into `blog/templates/blo
<!DOCTYPE html>
<html>
<head>
<title>Django Girls blog</title>
<title>DjangoFest blog</title>
</head>
<body>
<header>
<h1><a href="/">Django Girls Blog</a></h1>
<h1><a href="/">DjangoFest Blog</a></h1>
</header>

<article>
Expand Down
4 changes: 2 additions & 2 deletions en/installation/README.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
# 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.
If you're doing the tutorial at home, not at one of the [DjangoFest 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/):
If you are attending one of the [DjangoFest 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.
Expand Down
4 changes: 2 additions & 2 deletions en/python_introduction/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -562,7 +562,7 @@ Earlier, we picked out a code editor from the [code editor](../code_editor/READM

{% filename %}editor{% endfilename %}
```python
print('Hello, Django girls!')
print('Hello, DjangoFest!')
```

Obviously, you're a pretty seasoned Python developer now, so feel free to write some code that you've learned today.
Expand Down Expand Up @@ -628,7 +628,7 @@ Now use Python to execute the code in the file like this:
{% filename %}command-line{% endfilename %}
```
$ python3 python_intro.py
Hello, Django girls!
Hello, DjangoFest!
```

Note: on Windows 'python3' is not recognized as a command. Instead, use 'python' to execute the file:
Expand Down
6 changes: 3 additions & 3 deletions en/template_extending/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,15 +26,15 @@ Then open it up in the code editor and copy everything from `post_list.html` to
<!DOCTYPE html>
<html>
<head>
<title>Django Girls blog</title>
<title>DjangoFest blog</title>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/css/bootstrap.min.css" integrity="sha384-1BmE4kWBq78iYhFldvKuhfTAU6auU8tT94WrHftjDbrCEXSU1oBoqyl2QvZ6jIW3" crossorigin="anonymous">
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lobster&subset=latin,latin-ext">
<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>
<h1><a href="/">DjangoFest Blog</a></h1>
</div>
</header>

Expand Down Expand Up @@ -64,7 +64,7 @@ Then in `base.html`, replace your whole `<body>` (everything between `<body>` an
<body>
<header class="page-header">
<div class="container">
<h1><a href="/">Django Girls Blog</a></h1>
<h1><a href="/">DjangoFest Blog</a></h1>
</div>
</header>
<main class="container">
Expand Down
6 changes: 3 additions & 3 deletions en/whats_next/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,14 +6,14 @@ Congratulate yourself! __You're totally awesome__. We're proud! <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.
After that, make sure to follow DjangoFest 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.
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 DjangoFest, 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/)
- Our other book, [DjangoFest Tutorial: Extensions](https://tutorial-extensions.djangogirls.org/)
- [Django's official tutorial](https://docs.djangoproject.com/en/4.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
Expand Down