Skip to content

Rewrite editor lists in editor-setup.md #46

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

Merged
merged 27 commits into from
Dec 12, 2022
Merged
Changes from all commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
00af2f1
Changing the use from 'bad editor' to 'not suitable at this point of …
georgerahul24 Dec 3, 2022
0db4f9e
Update editor-setup.md
georgerahul24 Dec 6, 2022
798c0ea
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
c5d3d03
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
a869af6
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
f417917
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
50892e9
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
5cdc121
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
f1a1f3d
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
cbf005c
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
eafd70a
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
0c20396
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
cdb13bb
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
95483cc
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
ca4517c
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
ebee5c7
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
8d41731
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
d10f646
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
43aeb9c
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
c6c1ab8
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
bbe2265
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
a5a3254
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
1850b6b
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
142636c
Update basics/editor-setup.md
georgerahul24 Dec 8, 2022
ab6a2d2
Update editor-setup.md
georgerahul24 Dec 8, 2022
349a088
Update basics/editor-setup.md
georgerahul24 Dec 11, 2022
c6f135a
Update basics/editor-setup.md
georgerahul24 Dec 11, 2022
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
79 changes: 44 additions & 35 deletions basics/editor-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,48 +13,57 @@ like automatically displaying different things with different colors,
but also highlighting mistakes in the code, and coloring syntax.

If you are on Windows or Mac OSX you have probably noticed that your
Python came with an editor called IDLE. We are not going to use it
because it's lacking some important features, and most experienced
programmers (including me) don't use it or recommend it.
Python came with an editor called IDLE. You can use IDLE, but we recommend exploring other options first.


## Which editor?

The choice of an editor is a very personal thing. There are many
editors, and most programmers have a favorite editor that they use for
everything and recommend to everyone.

If you aren't sure about which editor you should use, I recommend
Porcupine. It's a simple editor I wrote in Python; it lets you edit
files and it doesn't have too many other features. [Install it with these
instructions](https://github.com/Akuli/porcupine/#installing-porcupine),
and then [learn to use it by writing the classic Hello World
program](https://github.com/Akuli/porcupine/wiki/First-Program). Then
you can [skip the rest of this chapter](#editor-or--prompt).

Note that most other editors come with settings that are not suitable
for writing Python code. _**TODO:** add a link to the old editor setup
tutorial here._

Most of these editors lack some important features, they have so many
features that confuse people or they aren't free. You can use these
editors if you like them, but **these editors are BAD for getting
started with programming**:

- PyCharm
- IDLE
- Emacs
- Gedit
- Nano
- NetBeans
- Notepad
- Pluma
- Spyder
- Vim
- Wingware

This list doesn't contain all bad editors, but these are editors that
people often try to use. If you know a bad editor and you think I should
mention it here, please [let me know](../contact-me.md).
The editors can be broadly divided into three categories:

#### The Basic Text Editors
These editors usually come with the operating system. They do not have features like
running code, auto-completion, etc. that make programming easier. They are usually used for relatively simple
text editing. Most programmers do not use these editors for programming.

A few popular ones in this category are:
- Notepad (Windows)
- Gedit (Linux)
- Notepad ++ (Windows)
- Nano (Linux/Mac OS)

#### Smart Text Editors
The text editors in this category have features like auto-completion, syntax highlighting,
running and debugging code, highlighting errors, etc. They are relatively easy to learn and have the necessary features
to start your programming journey.

A few popular ones in this category are:
- Visual Studio Code / VS Code (Windows/Linux/Mac OS)
- IDLE (Usually comes with Python) (Windows/Linux/Mac OS)
- Thonny (Windows/Linux/Mac OS)
- [Porcupine](https://github.com/Akuli/porcupine) (created by the author of this tutorial) (Windows/Linux/Mac OS)
- Geany (Windows/Linux/Mac OS)

**We recommend that you look into a few of these editors and install your favorite one.**

#### IDEs and advanced editors
This category of text editors are usually professional grade pieces of software. They are mostly proprietary and paid. They have a steep
learning curve because of how many features they have.
These types of editors are generally not preferred
in the beginning stage. They are meant to be used for writing complex and large pieces of software.

A few popular ones in this category are:
- Visual Studio (Not be confused with *Visual Studio Code*) (Windows)
- Pycharm (Windows/Linux/Mac OS)
- Vim (Windows/Linux/Mac OS)
- Emacs (Windows/Linux/Mac OS)

As already mentioned, there are no "right" or "wrong" editors. The preference of an editor
is a personal choice and we recommend trying different editors.
The lists on this page don't contain all editors, but just a few of the most popular ones.

## Editor or `>>>` prompt?

Expand Down