Kaynağa Gözat

Replace Light Table with PyCharm

Light Table seems to cause lot of confusion for newbies, I don't think PyCharm is necessarily
easier but I don't see a better alternative.

Also, PyCharm is more likely to be around, now that Light Table is deprioritized by the creators:
http://www.chris-granger.com/2014/10/01/beyond-light-table/
Swaroop C H 10 yıl önce
ebeveyn
işleme
4d94679489

+ 19 - 1
basics.asciidoc

@@ -311,7 +311,25 @@ run the program.
 
 Henceforth, the standard procedure to save and run a Python program is as follows:
 
-. Open your editor of choice, such as Light Table.
+=== For PyCharm
+
+. Open <<pycharm>>.
+. Create new file with the filename mentioned.
+. Type the program code given in the example.
+. Right-click and run the current file.
+
+[NOTE]
+====
+Whenever you have to provide <<module,command line arguments>>,
+click on +Run+ -> +Edit Configurations+ and type the arguments in the
++Script parameters:+ section and click the +OK+ button:
+
+image::pycharm_command_line_arguments.png[PyCharm command line arguments,734,452]
+====
+
+=== For other editors
+
+. Open your editor of choice.
 . Type the program code given in the example.
 . Save it as a file with the filename mentioned.
 . Run the interpreter with the command +python program.py+ to run the program.

+ 51 - 18
first_steps.asciidoc

@@ -67,8 +67,9 @@ helps you reach your destination (achieve your goal) in a much faster and safer
 One of the very basic requirements is _syntax highlighting_ where all the different parts of your
 Python program are colorized so that you can _see_ your program and visualize its running.
 
-If you have no idea where to start, I would recommend using http://www.lighttable.com/[Light Table]
-software which is available on Windows, Mac OS X and GNU/Linux. Details in the next section.
+If you have no idea where to start, I would recommend using
+http://www.jetbrains.com/pycharm/[PyCharm Community Edition] software which is available on
+Windows, Mac OS X and GNU/Linux. Details in the next section.
 
 If you are using Windows, *do not use Notepad* - it is a bad choice because it does not do syntax
 highlighting and also importantly it does not support indentation of the text which is very
@@ -82,35 +83,67 @@ Vim].
 
 In case you are willing to take the time to learn Vim or Emacs, then I highly recommend that you do
 learn to use either of them as it will be very useful for you in the long run. However, as I
-mentioned before, beginners can start with Light Table and focus the learning on Python rather than
-the editor at this moment.
+mentioned before, beginners can start with PyCharm and focus the learning on Python rather than the
+editor at this moment.
 
 To reiterate, please choose a proper editor - it can make writing Python programs more fun and
 easy.
 
-=== Light Table
+[[pycharm]]
+=== PyCharm
 
-http://www.lighttable.com[Light Table] is a free editor which you can use for writing Python
-programs.
+http://www.jetbrains.com/pycharm/download/[PyCharm Community Edition] is a free editor which you
+can use for writing Python programs.
 
-Click on +File+ -> +New file+, type the following:
+When you open PyCharm, you'll see this:
+
+image::pycharm_open.png[When you open PyCharm,440,282]
+
+Click on +Create New Project+, and type +helloworld+ as the name of the project, you should see
+details similar to this:
+
+image::pycharm_create_new_project.png[PyCharm project details,475,240]
+
+Click the +OK+ button.
+
+If you see the _Tip of the Day_ dialog box, click the +Close+ button.
+
+image::pycharm_tip_of_the_day.png[PyCharm Tip of the Day dialog box,714,445]
+
+Right-click on the +helloworld+ in the sidebar and select +New+ -> +Python File+.
+
+image::pycharm_new_python_file.png[PyCharm -> New -> Python File,777,494]
+
+You will be asked to type the name, type +hello+:
+
+image::pycharm_new_file_input.png[PyCharm New File dialog box,734,452]
+
+You can now see a file opened for you:
+
+image::pycharm_hello_open.png[PyCharm hello.py file,777,494]
+
+Delete the lines that are already present, and now type the following:
 
 [source,python]
 --------------------------------------------------
 print "hello world"
 --------------------------------------------------
 
-Click on +File+ -> +Save+ and call it +hello.py+.
+Now right-click on what you typed (without selecting the text), and click on +Run 'hello'+.
+
+image::pycharm_run.png[PyCharm Run 'hello',777,494]
 
-Click on +View+ -> +Console+.
+You should now see the output (what it prints) of your program:
 
-Now, place your cursor at the end of the above line and press kbd:[command + enter] to _evaluate_
-the line and you'll see the output in the console.
+image::pycharm_output.png[PyCharm output,777,494]
 
-Do watch the videos in the http://docs.lighttable.com/tutorials/python/[LightTable for Python
-tutorial] to understand how to use Light Table.
+Phew! That was quite a few steps to get started, but henceforth, every time we ask you to create a
+new file, remember to just right-click on +helloworld+ on the left -> +New+ -> +Python File+ and
+continue the same steps to type and run as shown above.
 
-image::light_table_screenshot.png[Screenshot of Light Table,594,536]
+You can find more information about PyCharm in the
+http://confluence.jetbrains.com/display/PYH/Getting+Started+with+PyCharm[Getting Started with
+PyCharm] page.
 
 === Vim
 
@@ -145,15 +178,15 @@ learn the language better."
 
 Start your choice of editor, enter the following program and save it as +hello.py+.
 
-If you are using Light Table, click on +File+ -> +New file+, type the lines:
+If you are using PyCharm, we have already <<pycharm,discussed how to run from a source file>>.
+
+For other editors, open a new file +hello.py+ and type this:
 
 [source,python]
 --------------------------------------------------
 print "hello world"
 --------------------------------------------------
 
-In Light Table, click on +File+ -> +Save+ to save a file called +hello.py+.
-
 Where should you save the file? To any folder for which you know the location of the folder. If you
 don't understand what that means, create a new folder and use that location to save and run all
 your Python programs:

BIN
light_table_screenshot.png


BIN
pycharm_command_line_arguments.png


BIN
pycharm_create_new_project.png


BIN
pycharm_hello_open.png


BIN
pycharm_new_file_input.png


BIN
pycharm_new_python_file.png


BIN
pycharm_open.png


BIN
pycharm_output.png


BIN
pycharm_run.png


BIN
pycharm_tip_of_the_day.png