Added a metacourse with instructions on how to add a course/run (#394)

Merges #394

Author: mikicz

courses/meta/info.yml

@@ -0,0 +1,17 @@
+title: Jak přidat kurz na Nauč se Python
+description: Návod na přidání kurzu na Nauč se Python
+long_description: |
+
+  V tomto meta-kurzu je kompletní návod na přidávání kurzů na Nauč se Python.
+
+  Kurz je určený pro organizátory a k přidání kurzu jsou potřeba jen základní znalosti práce
+  s gitem a GitHubem.
+canonical: true
+meta: true
+plan:
+- title: Přidání kurzu
+  slug: adding-a-run
+  materials:
+  - lesson: meta/installing-naucse
+  - lesson: meta/local-run
+  - lesson: meta/submitting-a-run

lessons/meta/installing-naucse/index.md

@@ -0,0 +1,86 @@
+# Lokální instalace Nauč se python
+
+K přidání kurzu nejdřív člověk potřebuje vlastní, lokální instalaci webové aplikace Nauč se Python.
+
+## Příprava
+
+První věc, kterou budeš potřebovat, je Python, a to alespoň ve verzi 3.6.
+Pokud zrovna danou verzi Pythonu nainstalovanou nemáš, můžeš postupovat podle [návodu na instalaci Pythonu][beginners-install].
+
+[beginners-install]: {{lesson_url("beginners/install")}}
+
+Druhá věc, kterou budeš potřebovat, je Git – pokud nemáš ten, můžeš postupovat podle [návodu na instalaci Gitu]({{lesson_url("git/install")}}).
+
+Poslední věc, kterou potřebuješ, už není žádný program, ale pár schopností.
+Je potřeba, aby jsi uměl{{a}} pracovat s příkazovou řádkou (terminálem) a s Gitem.
+Vše potřebné si můžeš připomenout v [návodu na používání terminálu]({{lesson_url("beginners/cmdline")}}), respektive v [návodu na používání Gitu]({{lesson_url("git/git-collaboration-2in1")}}).
+
+## Instalace
+
+Nejprve musíš naklonovat repozitář, ze kterého se Nauč se Python vykresluje.
+To uděláš tímto příkazem:
+
+```console
+$ git clone https://github.com/pyvec/naucse.python.cz
+```
+
+Poté přepni adresář do naklonovaného repozitáře:
+
+```console
+$ cd naucse.python.cz
+```
+
+A vytvoř si v něm virtuální prostředí – pokud nevíš jak na to, můžeš se podívat do výše zmíněného [návodu na instalaci Pythonu][beginners-install].
+Virtuální prostředí si rovnou aktivuj.
+
+Poslední krok instalace je nainstalování závislostí, tedy potřebných knihoven uvedených v souboru `requirements.txt`:
+
+```console
+(__venv__)$ python -m pip install -r requirements.txt
+```
+
+{{ anchor('launch') }}
+## Spuštění
+
+Teď, když máš webovou aplikaci Nauč se Python nainstalovanou, stačí už ji jen pustit.
+Nejdříve si musíš nastavit proměnou prostředí.
+Na Unixu (Linux, macOS):
+
+```console
+(__venv__)$ export PYTHONPATH=.
+```
+
+Na Windows:
+
+```dosvenv
+(__venv__)> set PYTHONPATH=.
+```
+
+Nauč se Python jde pustit ve dvou režimech.
+První režim vykresluje každou stránku pokaždé znova – hodí se na vývoj, aby byly všechny změny okamžitě vidět.
+Pustí se následovně:
+
+```console
+(__venv__)$ python -m naucse serve
+ * Running on http://0.0.0.0:8003/ (Press CTRL+C to quit)
+ * Restarting with stat
+ * Debugger is active!
+ * Debugger PIN: 256-270-314
+```
+
+V ukázce vidíš rovnou i příklad toho, co to vypíše – zajímá tě jen adresa, zde `http://0.0.0.0:8003/` (u tebe se může lišit).
+Když si ji zkopíruješ a otevřeš ve webovém prohlížeči, uvidíš vlastní běžící Nauč se Python.
+
+Druhý režim nejdříve vykreslí všechny stránky a až poté ti je zobrazí – hodí se spíše na kontrolu toho, že se při vývoji nic nepokazilo.
+Pustí se následovně (pozor, nějakou chvíli to trvá):
+
+```console
+(__venv__)$ python -m naucse freeze --serve
+Generating HTML...
+ * Running on http://127.0.0.1:8003/ (Press CTRL+C to quit)
+```
+
+> [note]
+> Když odnaviguješ například do seznamu kurzů, je možné, že tam nebudou všechny.
+> To jsou kurzy, které se vykreslují z jiných forků, které jsou na lokálním prostředí
+> automaticky vypnuté.

lessons/meta/installing-naucse/info.yml

@@ -0,0 +1,5 @@
+title: Lokální instalace Nauč se Python
+style: md
+attribution: Napsal Mikuláš Poul, 2018
+license: cc-by-sa-40
+license_code: cc0