Nauč se Python

Otevřené materiály pro výuku Pythonu – jak na organizovaných kurzech, tak pro samouky.

Dostupné na naucse.python.cz.

Instalace a spuštění

Chceš-li server spustit na svém počítači, např. proto, že se chceš zapojit do vývoje, je potřeba ho nejdřív nainstalovat:

• (nepovinné) Vytvoř a aktivuj si virtuální prostředí v Pythonu 3.6.

• Přepni se do adresáře s kódem projektu.

• Nainstaluj závislosti:

  • Linux/Mac:

    $ python3 -m pip install pipenv
    $ pipenv install

  • Windows:

    > py -3 -m pip install pipenv
    > pipenv install
    

Nainstalovanou aplikaci spustíš následovně:

• (nepovinné) Aktivuj si virtuální prostředí, máš-li ho vytvořené.
• Spusť vývojový server:

  $ pipenv run serve

• Program vypíše adresu (např. http://0.0.0.0:8003/); tu navštiv v prohlížeči.

Pokud chceš místo vývojového spuštění vygenerovat statické HTML soubory (např. pro nahrání na statický hosting):

• Spusť freeze. Parametr --serve provede spuštění webserveru, pomocí kterého si lze vygenerované soubory prohlédnout:

  $ PYTHONPATH=. pipenv run freeze --serve

• HTML stránky jsou v adresáři naucse/_build. Program vypíše adresu (např. http://0.0.0.0:8000/); tu navštiv v prohlížeči.

Externí kurzy

Na naucse.python.cz jsou k dispozici i externí kurzy, které spravují více či méně důvěryhodní lidé. Proces vykreslování obsahu těchto kurzů jim dává velkou volnost: můžou převzít plnou kontrolu nad počítačem, na kterém naucse běží. Kvůli bezpečnosti je proto naucse ve výchozím nastavení neukazuje.

In English

##Learn Python

Open materials for teaching Python - both in organized courses and for self-study. Available at naucse.python.cz.

##Installation and startup

If you want to run the server on your computer, for example, because you want to participate in development, you need to install it first: (optional) Create and activate a virtual environment in Python 3.6.

Switch to the directory with the project code.

Install dependencies:

Linux / Mac:

$ python3 -m pip install pipenv $ pipenv install Windows:

py -3 -m pip install pipenv pipenv install To start the installed application:

(optional) Activate the virtual environment, if you have one. Start the development server: $ pipenv run serve The program prints the address (eg http://0.0.0.0:8003/); visit here in the browser. If you want to generate static HTML files instead of the development run (eg for uploading to static hosting):

Run freeze. The --serve parameter starts the webserver, which can be used to view the generated files: $ PYTHONPATH =. pipenv run freeze --serve The HTML pages are in the naucse / _build directory. The program prints the address (eg http://0.0.0.0:8000/); visit here in the browser. External courses External courses available by more or less trustworthy people are also available at naucse.python.cz. The process of rendering the content of these courses gives them a lot of freedom: they can take full control of the computer on which the naucse is running. Therefore, for security reasons, naucse does not show by default.

Licence

Kód je k dispozici pod licencí MIT, viz soubor LICENSE.MIT.

Obsah kurzů má vlastní licenci, která je uvedena v metadatech. Používáme pouze licence pro otevřený obsah. Všechen obsah musí mít uvedenou licenci.

---

The code is licensed under the terms of the MIT license, see LICENSE.MIT file for full text. By contributing code to this repository, you agree to have it licensed under the same license.

Content has its own license specified in the appropriate matadata. Only free content licenses are used. By contributing to an already licensed document, you agree to have it licensed under the same license. (And feel free to add yourself to the authors list in its metadata.) When contributing new document(s) a license must be specified in the metadata.