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

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

Merged
merged 1 commit into from Apr 28, 2018
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
17 changes: 17 additions & 0 deletions 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
86 changes: 86 additions & 0 deletions 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
```
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Funguje nastavování proměnné prostředí takhle i na Windows?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nefunguje, přidal jsem nad to separátně nastavování proměné


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é.
5 changes: 5 additions & 0 deletions 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