Merge pull request #442 from encukou/lesson-dir

Clarify and standardize directory structure and venv location

#442

Author: hroncok

courses/pyladies/info.yml

@@ -18,6 +18,7 @@ plan:
   - lesson: beginners/cmdline
   - lesson: beginners/install
   - lesson: beginners/first-steps
+  - lesson: beginners/venv-setup
   - lesson: beginners/install-editor
   - lesson: git/install
   - title: Tahák na klávesnici (PDF)

lessons/beginners/comparisons/index.md

@@ -93,26 +93,27 @@ print(False)
 
 ## Podmínky
 
-{% if var('pyladies') -%}
-{% set rootname = 'pyladies' %}
-{%- else -%}
-{% set rootname = 'naucse-python' %}
-{%- endif %}
-
 Teď oprášíme program na výpočet obvodu a obsahu.
-Do nového souboru, třeba <code><span class="pythondir">~/{{ rootname }}</span>/02/if.py</code>,
-napiš následující program.
-Co se stane, když jako stranu zadáš záporné číslo?
-Dává výstup smysl?
+
+Otevři si v editoru nový soubor.
+Jestli ještě v adresáři, kde máš soubory ke kurzům Pythonu,
+nemáš adresář pro tuto lekci (třeba `02`), vytvoř si ho.
+Nový soubor ulož do něj pod jménem `if.py`.
+
+Do souboru pak napiš následující program:
 
 ```python
 strana = float(input('Zadej stranu čtverce v centimetrech: '))
 print('Obvod čtverce se stranou', strana, 'je', 4 * strana, 'cm')
 print('Obsah čtverce se stranou', strana, 'je', strana * strana, 'cm2')
 ```
 
+Program spusť. Funguje?
+
+Co se stane, když jako stranu zadáš záporné číslo?
+Dává výstup smysl?
 
-Tady je vidět, jak počítač dělá přesně, co se mu řekne, a nepřemýšlí o významu.
+Tady je vidět, jak počítač dělá přesně, co se mu řekne. Nepřemýšlí o významu.
 Bylo by dobré uživateli, který zadá záporné číslo,
 přímo říct, že zadal blbost. Jak na to?
 

lessons/beginners/first-steps/index.md

@@ -8,17 +8,17 @@ Zkontroluj si, že máš aktivované virtuální prostředí (na začátku pří
 Je-li tomu tak, nezbývá než – konečně – pustit Python.
 K tomu použij příkaz `python`:
 
-``` plain
+``` console
 (venv)$ python
-Python 3.4.0 (default, Jan 26 2014, 18:15:05)
+Python 3.6.0 (default, Jan 26 2014, 18:15:05)
 [GCC 4.8.2 20131212 (Red Hat 4.8.2-7)] on linux
 Type "help", "copyright", "credits" or "license" for more information.
->>>
 ```
 
 Příkaz vypíše několik informací.
 Z prvního řádku se můžeš ujistit, že používáš Python 3.
-Třemi „zobáčky“ `>>>` pak Python poprosí o instrukce.
+
+Python pak třemi „zobáčky“ `>>>` poprosí o instrukce.
 Je to jako v příkazové řádce, ale místo příkazů jako
 `cd` a `mkdir` sem budeš psát příkazy Pythonu.
 

lessons/beginners/hello-world/index.md

@@ -21,67 +21,63 @@ V něm vytvoř nový soubor, do kterého napiš následující text:
 print("Ahoj světe!")
 ```
 
-{% if var('pyladies') -%}
-{% set rootname = 'pyladies' %}
-{%- else -%}
-{% set rootname = 'naucse-python' %}
-{%- endif %}
-
-Pak soubor ulož pod jménem <code><span class="pythondir">~/{{ rootname }}</span>/02/ahoj.py</code>.
-Za <code class="pythondir">~/{{ rootname }}</code> musíš doplnit adresář,
-který jsi vytvořil{{a}} minule, při [instalaci Pythonu](../../beginners/install/).
-Podadresář `02` musíš vytvořit.
-Do něj pak soubor ulož jako `ahoj.py`.
-
-Pokud máš v ukládacím okýnku možnost zvolit <em>kódování</em>, zvol <code>UTF-8</code>.
-Můžeš–li zvolit typ souboru, zvol <code>.py</code> nebo „všechny soubory“.
-
+Pak soubor ulož jako `ahoj.py`:
 
-Některé systémy a editory se snaží přípony jako <code>.py</code> schovávat
-nebo si doplňovat přípony vlastní. V příkazové řádce se ale vždycky ukáže
-opravdové jméno.
-Proto ještě v příkazové řádce pomocí `cd` přejdi do adresáře <code><span class="pythondir">~/{{ rootname }}</span>/02</code>
-a pomocí `ls` (Unix) nebo `dir` (Windows) zkontroluj, že se soubor opravdu
-jmenuje `ahoj.py` a ne třeba `ahoj.py.txt`.
+* V adresáři, kde máš soubory ke kurzům Pythonu, si založ adresář pojmenovaný
+  podle čísla lekce (např. `02`).
+  Měl by být vedle tvého virtuálního prostředí.
+* Do něj pak soubor ulož pod jménem `ahoj.py`.
 
+Pokud máš v ukládacím okýnku možnost zvolit *kódování*, zvol `UTF-8`.
+Můžeš–li zvolit typ souboru, zvol `.py` nebo „všechny soubory“.
 
 ## Spuštění
 
-Otevři si příkazovou řádku, aktivuj si v ní virtuální prostředí,
-vlez do adresáře <code><span class="pythondir">~/{{ rootname }}</span>/02</code>
-a zadej tento příkaz:
-
-```console
-$ python ahoj.py
-```
+Otevři si příkazovou řádku.
+Pomocí `cd` donaviguj do adresáře, kde máš soubory ke kurzům Pythonu.
 
 > [note]
 > S příkazovou řádkou jsme se seznámil{{gnd('i', 'y', both='i')}}
 > v [minulé lekci](../../beginners/cmdline/), která popisuje i změnu aktuálního
 > adresáře pomocí příkazu `cd`.
-> Aktivaci virtuálního prostředí jsme probral{{gnd('i', 'y', both='i')}} společně
-> s [instalací Pythonu](../../beginners/install/).
+
+Aktivuj si virtuální prostředí.
+
+> [note]
+> Příkaz k tomu jsme si ukázali na konci
+> [návodu na tvorbu virtuálního prostředí](../venv-setup/); končí `activate`.
+
+
+Pak a zadej tento příkaz:
+
+```console
+(venv)$ python ahoj.py
+```
 
 > [note] Poznámka pro Windows a starší Python
 > V nečeských Windows s Pythonem 3.5 či nižším bude třeba před
 > programem spustit `chcp 1250`, jinak bude program píšící české
 > znaky končit chybou `UnicodeEncodeError`.
-> Je to trochu polovičaté řešení, ale pro naše příklady bude stačit.
 
-Pokud se vypíše hláška, gratuluji!
+Pokud se vypíše hláška `Ahoj světe!`, gratuluji!
 Napsal{{a}} jsi svůj první program v Pythonu!
 
 Jestli to nefunguje, zkontroluj, že:
 
 * Máš zapnuté virtuální prostředí.
   (Na příkazové řádce se musí ukazovat <code>(venv)</code>;
   pokud tam není, použij příkaz „activate“ z [minula]({{ lesson_url('beginners/install') }}).)
-* Jsi ve správném adresáři, <code><span class="pythondir">~/{{ rootname }}</span>/02</code>.
-  (Za <span class="pythondir">~/{{ rootname }}</span> musíš doplnit adresář, který jsi vytvořila minule.)
+* Jsi ve správném adresáři. Zkus `pwd` (Unix) nebo `cd` (Windows).
+  Aktuální adresář musí být ten, do kterého jsi uložil{{a}}
+  soubor s programem.
+* Soubor se opravdu jmenuje `ahoj.py`.
+  Pomocí `ls` (Unix) nebo `dir` (Windows) zkontroluj, že se soubor opravdu
+  jmenuje `ahoj.py` a ne třeba `ahoj.py.txt`.
+  Jestli ne, ulož ho znovu pod správným jménem.
 * Soubor `ahoj.py` obsahuje správný příkaz, včetně všech uvozovek a závorek.
-* Znak `$` nezadáváš – ten je tam proto, aby bylo poznat že jde o příkaz příkazové
-  řádky.
-  Na `$` (nebo, na Windows, `>`) končí dotaz, který vypíše počítač.
+* Slovo `(venv)` ani znak `$` nezadáváš – v materiálech jsou proto, aby bylo
+  poznat že jde o příkaz příkazové řádky.
+  Na `$` (nebo, na Windows, `>`) končí dotaz, který vypíše sám počítač.
   Příkaz, který zadáváš ty, je jen `python ahoj.py`.
 
 A jestli to pořád nefunguje, zeptej se

lessons/beginners/install/index.md

@@ -1,29 +1,9 @@
 # Instalace Pythonu
 
-V této sekci uděláme dvě věci:
+V této sekci nainstalujeme Python.
 
-* Nainstalujeme Python a Virtualenv
-* Vytvoříme si virtuální prostředí pro práci v Pythonu
-
-Možná se ptáš, proč je to všechno potřeba?
-
-Python je jak programovací jazyk (způsob, jak říkat počítačům, co dělat),
-tak program, který potřebujeme, aby se s námi počítač tím jazykem domluvil.
-
-Virtuální prostředí pak je něco, co zajistí, aby se všechny počítače chovaly
-zhruba stejně.
-Až ho zprovozníme, nebudeme potřebovat materiály zvlášť pro Linux, zvlášť pro
-Windows a zvlášť pro Mac.
-
-> [note]
-> V budoucnu využijeme druhou výhodu: každé virtuální prostředí je oddělené od
-> ostatních, takže když doinstalujeme nějakou knihovnu (rozšíření pro Python),
-> projeví se to jen v jednom virtuálním prostředí.
-> Pokud by se při práci na projektu něco pokazilo, neohrozí to další projekty
-> ve tvém počítači.
-
-Instalace samotná je na každém počítači jiná.
-Vyber si stránku podle svého operačního systému:
+To se na každém druhu operačního systému dělá trošku jinak.
+Vyber si stránku podle svého systému:
 
 * [Linux]({{ subpage_url('linux') }})
 * [Windows]({{ subpage_url('windows') }})

lessons/beginners/install/linux.md

@@ -29,20 +29,20 @@ Objeví-li se `bash: python3: command not found` nebo podobná chyba,
 doinstaluj Python.
 Konkrétní příkaz záleží na distribuci:
 
-* Fedora:
+* **Fedora**:
   {% filter markdown(inline=True) %}
   ```console
   $ sudo dnf install python3
   ```
   {% endfilter %}
-* Ubuntu:
+* **Ubuntu**:
   {% filter markdown(inline=True) %}
   ```console
   $ sudo apt-get install python3
   ```
   {% endfilter %}
 
-Používáš-li jinou distribuci, předpokládám, že instalovat programy už umíš. :)
+Používáš-li jinou distribuci, doufám, že instalovat programy už umíš.
 
 
 {{ anchor('check-tkinter') }}
@@ -63,7 +63,7 @@ Zavři ho a přejdi na [doinstalování `virtualenv`](#install-virtualenv).
 
 Jestli ne, modul `tkinter` ještě nainstaluj:
 
-* Fedora:
+* **Fedora**:
   {% filter markdown(inline=True) %}
   ```console
   $ sudo dnf install python3-tkinter
@@ -93,102 +93,21 @@ $ python3 -m ensurepip --version
 ```
 
 Objeví-li se výpis začínající „pip“, máš funkční `venv` nainstalovaný.
-Přejdi na sekci [vytvoření virtuálního prostředí](#setup-venv).
+Zbytek této sekce můžeš přeskočit!
 
-Objeví-li se nápis `No module named ensurepip`, je potřeba doinstalovat
-alternativu, Virtualenv.
-Zapamatuj si, že Virtualenv budeš muset v dalším kroku použít,
-a nainstaluj ho:
+Objeví-li se ale nápis `No module named ensurepip`, je potřeba doinstalovat
+alternativu, Virtualenv:
 
 <!-- na Fedoře se tohle nestává -->
 
-* Ubuntu:
+* **Ubuntu**:
   {% filter markdown(inline=True) %}
   ```console
   $ sudo apt-get install python-virtualenv
   ```
   {% endfilter %}
 
-Používáš-li jinou distribuci, předpokládám, že instalovat programy už umíš. :)
-
-
-{{ anchor('setup-venv') }}
-## Vytvoření virtuálního prostředí
-
-<!-- Pozn. Tahle sekce je velice podobná pro Linux, Mac i Windows;
-     měníš-li ji, koukni se jestli není změna potřeba i jinde. -->
-
-{%- if var('pyladies') -%}
-{% set rootname = 'pyladies' %}
-{%- else -%}
-{% set rootname = 'naucse-python' %}
-{%- endif -%}
-
-Nakonec vytvoř virtuální prostředí.
-
-Zvol si adresář (složku), ve které budeš mít soubory k PyLadies.
-Může to být třeba <code>/home/<i>jméno</i>/{{ rootname }}</code>,
-neboli <code class="pythondir">~/{{ rootname }}</code>.
-Adresář vytvoř a poznamenej si, kde je.
-
-Vytváříš-li adresář jinde, nebo s jiným názvem, tak kdykoli ve zbytku
-materiálů uvidíš <code class="pythondir">~/{{ rootname }}</code>, doplň
-místo toho „svůj“ adresář.
-
-Zvolený adresář po vytvoření nesmíš přesouvat jinam – když to uděláš,
-přestane virtuální prostředí fungovat.
-Proto ho nedoporučuji vytářet na Ploše.
-
-> [note]
-> Kdybys někdy chtěl{{a}} adresář přece jen přesunout,
-> musel{{a}} bys smazat virtuální prostředí a vytvořit nové.
-
-Teď když je tenhle adresář vytvořený, otevři příkazovou řádku
-a příkazem `cd` se do něj přepni:
-<!-- XXX: Special highlight in source code needed -->
-```console
-$ cd ~/{{ rootname }}
-```
-
-Pak virtuální prostředí vytvoř.
-Pokud jsi v přeskočil{{a}} instalaci Virtualenv, zadej:
-
-```console
-$ python3 -m venv venv
-```
-
-jinak:
-
-```console
-$ virtualenv -p python3 venv
-```
-
-Tím se ti vytvořil adresář <code><span class="pythondir">~/{{ rootname }}</span>/venv</code>,
-ve kterém jsou soubory s virtuálním prostředím.
-Můžeš se podívat dovnitř, ale nikdy tam nic neměň.
-
-
-## Aktivace virtuálního prostředí
-
-Nakonec virtuální prostředí aktivuj:
-
-<div class="highlight">
-<pre><code><span class="gp">$</span> source <span class="pythondir">~/{{ rootname }}</span>/venv/bin/activate
-</code></pre>
-</div>
-
-Po spuštění tohoto příkazu by se mělo na začátku příkazové řádky
-(před `$`) objevit slovo `(venv)`.
-Tak poznáš, že je virtuální prostředí *aktivní*.
-
-Tenhle příkaz si zapiš. Budeš ho muset zadat vždycky, když pustíš příkazovou řádku,
-než se pustíš do programování.
-
-{% if var('pyladies') %}
-Máš-li vytištěné <a href="http://pyladies.cz/v1/s001-install/handout/handout.pdf">domácí projekty</a>,
-příkaz si poznač, ať ho do příště nezapomeneš :)
-{% endif %}
+Používáš-li jinou distribuci, doufám, že instalovat programy už umíš.
 
-Python máš, můžeš se pustit do programování!
-To už bude stejné pro tebe i pro lidi na Linuxu a Windows.
-Sejdeme se na [další stránce]({{ lesson_url('beginners/first-steps') }}), kde uděláme první krůčky s Pythonem.
+Instaluješ-li Virtualenv, **zapamatuj si**, že ho budeš muset použít později
+při vytváření virtuálního prostředí.