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
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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é. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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 |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
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?
There was a problem hiding this comment.
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é