Pokiaľ robíš tutoriál doma

Pokiaľ robíš tento tutoriál doma, a nie na jednej z Django Girls akcií, môžeš úplne preskočiť túto kapitolu a pokračovať rovno na kapitolu Ako funguje internet.

Je to preto, lebo v tutoriáli sa zaoberáme inštaláciou vecí, ktoré sú potrebné - toto je len dodatočná stránka, ktorá zhromažďuje všetky pokyny na inštaláciu na jednom mieste (čo je užitočné pre niektoré formáty workshopov). Ak chceš, môžeš si nainštalovať všetko, čo spomíname na tejto stránke, rovno teraz. Ale pokiaľ sa chceš začať učiť predtým, ako si nainštaluješ množstvo vecí na svoj počítač, preskoč túto kapitolu a my ti vysvetlíme, ako veci nainštalovať, neskôr, priamo keď ich budeš potrebovať.

Veľa šťastia!

Ak sa zúčastníš workshopu

Ak sa chystáš zúčastniť Django Girls eventu:

• Súčasťou tvojho workshopu môže byť "inštalačná párty" pred samotným workshopom. Ak si na takejto inštalačnej párty, táto stránka je pre teba! Tieto inštrukcie ti pomôžu nainštalovať si všetko potrebné pre workshop. Ak treba, tak s pomocou mentoriek alebo mentorov. Potom na samotnom workshope budeš môcť preskočiť inštalačné inštrukcie, ktoré sa objavia v hlavnom tutoriáli, keď sa k nim dostaneš.
• Organizátorky a organizátori tvojho workshopu ťa možno poprosili, aby si si skúsila všetko nainštalovať na svojom počítači doma predtým, než začne workshop. Ak to je tvoj prípad, táto stránka je pre teba! Nasleduj tieto inštrukcie, ako sa ti bude dať. Pokiaľ sa ti nepodarí niečo konkrétne nainštalovať, môžeš sa spýtať svojej mentorky či mentora neskôr na samotnom workshope, keď sa dostaneš po časť tutoriálu s pokynmi k inštalácii.
• Ak súčasťou tvojho workshopu nie je inštalačná párty (alebo si sa nemohla zúčastniť) a pokiaľ ťa organizátorky a organizátori nepoprosili, aby si si všetko nainštalovala pred príchodom, preskoč túto stránku a prejdi rovno na kapitolu Ako funguje internet. Ako budeš postupovať tutoriálom, budeš si inštalovať všetko potrebné.

Inštalácia

V tomto tutoriáli si vytvoríš blog. Aby sa ti to podarilo, počas toho, ako budeš postupovať tutoriálom, budeš dostávať inštrukcie, ako nainštalovať rôzny softvér na svojom počítači a ako si povytváravať zopár online účtov, keď bude treba. Táto stránka združuje všetky pokyny k inštalácii a vytváraniu účtov na jednom mieste (čo je užitočné pre niektoré workshopové formáty).

Stručný úvod k príkazovému riadku

Viacero krokov nižšie spomína "konzolu", "terminál", "príkazové okno", "príkazový riadok" (alebo "command line"). Všetky tieto termíny znamenajú to isté: okno na tvojom počítači, do ktorého môžeš zadávať príkazy. Keď sa dostaneš k hlavnému tutoriálu, dozvieš sa o príkazovom riadku viac. V tejto chvíli je pre teba hlavné vedieť, ako otvoriť príkazové okno a ako vyzerá:

V závislosti od tvojej verzie Windowsu a tvojej klávesnice by jedna z týchto možností mala otvoriť príkazové okno (možno budeš musieť trochu experimentovať, ale nemusíš skúšať všetky tieto možnosti):

• Prejdi do ponuky Štart alebo na plochu a do vyhľadávacieho poľa zadaj "Príkazový riadok" alebo "Command Prompt".
• Prejdi na Štart menu → Systém Windows → Príkazový riadok.
• Choď na menu Štart → Všetky programy → Príslušenstvo → Príkazový riadok.
• Prejdi na plochu, podrž myš v ľavom dolnom rohu obrazovky a klikni na šípku nadol, ktorá sa zobrazí (na dotykovej obrazovke namiesto toho rýchlo prejdi prstom z dolnej časti obrazovky nahor). Mal by sa ti zobraziť zoznam aplikácií. Klikni na príkazový riadok (Command Prompt) v sekcii Windows System.
• Podrž špeciálnu klávesu Windows na klávesnici a stlač klávesu "X". Vyber "Príkazový riadok" z kontextového menu.
• Podrž klávesu Windows a stlač tlačidlo "R", kým sa ti nezobrazí okno "Run". Do poľa zadaj "cmd" a klikni na tlačidlo OK.

Neskôr v tutoriáli budeš potrebovať mať otvorené dve príkazové okná súčasne. Avšak na niektorých verziách Windowsu ak už máš otvorené jedno okno príkazového riadku a pokúsiš sa otvoriť druhé rovnakým spôsobom, len ťa to presmeruje na to, ktoré už máš otvorené. Vyskúšaj si to na svojom počítači! Ak dostaneš len svoje už existujúce príkazové okno, skús nové otvoriť použitím iného spôsobu zo zoznamu vyššie. Aspoň jeden z nich by ti mal otvoriť nové okno.

Inštalácia Pythonu

Pre čitateľov a čitateľky doma: Táto kapitola je spracovaná vo videu Installing Python & Code Editor.

Táto časť je založená na príručke Geek Girls Carrots (https://github.com/ggcarrots/django-carrots)

Django je napísané v jazyku Python. Python potrebujeme na všetko, čo chceme v Djangu robiť. Poďme ho teda najprv nainštalovať! Chceme, aby si si nainštalovala Python 3, takže ak máš staršiu verziu, budeš ju musieť upgradovať. Ak už máš verziu 3.10 alebo vyššiu, malo by to byť v poriadku.

Nainštaluj si, prosím, Python nasledovne, a to aj v prípade, že už máš na svojom počítači nainštalovanú Anacondu.

$ python3 --version
Python 3.12.3

$ grep '^NAME=' /etc/os-release

$ sudo apt install python3

$ sudo dnf install python3

$ sudo zypper install python3

Ak si chceš overiť, že inštalácia bola úspešná, otvor príkazový riadok a spusti príkaz python3:

command-line

$ python3 --version
Python 3.12.3

Zobrazená verzia sa môže líšiť od verzie 3.12.3 - mala by zodpovedať verzii, ktorú si nainštalovala.

POZNÁMKA: Ak používaš Windows a objaví sa ti chybová hláška, že python3 nebol najdený, skús použiť python (bez čísla 3) a over, či to náhodou nie je Python 3.10 alebo vyšší. Ak ani to nefunguje, otvor si nový príkazový riadok a skús znova - stáva sa to, keď robíš s príkazovým riadkom, ktorý bol otvorený ešte predtým, než sme nainštalovali Python.

V prípade pochybností alebo ak sa niečo pokazilo a nemáš tušenie, čo robiť ďalej - opýtaj sa svojej mentorky alebo mentora! Niekedy veci nejdú úplne hladko a je lepšie požiadať o pomoc niekoho, kto má viac skúseností.

Inštalácia editoru kódu

Existuje veľa rôznych editorov a zväčša sa vyberajú podľa osobných preferencií. Väčšina programátorov a programátoriek v Pythone používa zložité, ale veľmi výkonné IDE (integrované vývojové prostredie) ako napríklad PyCharm. Pre začiatočníčku je to pravdepodobne menej vhodné; naše odporúčania sú rovnako výkonné, ale oveľa jednoduchšie.

Naše návrhy sú uvedené nižšie, ale neváhaj sa opýtať svojej mentorky alebo mentora, aké sú ich preferencie - bude ti jednoduchšie vedieť pomocť.

Visual Studio Code

Visual Studio Code je editor zdrojového kódu, ktorý vyvíja Microsoft pre Windows, Linux a macOS. Podporuje debugovanie, priamu prácu s Gitom, zvýrazňovanie syntaxe, inteligentné dopĺňanie kódu, snippety a refaktorovanie kódu.

Stiahni si ho odtiaľto

Gedit

Gedit je open source editor zdarma dostupný pre všetky operačné systémy.

Stiahni si ho odtiaľto

Sublime Text

Sublime Text je veľmi populárny editor so skúšobnou verziou zdarma a je dostupný pre všetky operačné systémy.

Stiahni si ho odtiaľto

Atom

Atom je ďalší populárny editor. Je zdarma, open source a dostupný pre Windows, macOS a Linux. Atom je vyvíjaný GitHubom.

Stiahni si ho odtiaľto

Prečo inštalujeme editor kódu?

Možno ti napadlo, prečo inštalujeme takýto špeciálny editor kódu namiesto toho, aby sme použili niečo ako Word alebo Notepad.

Prvý dôvod je, že kód musí byť čistý text a problém s editormi ako Word a Textedit je ten, že v skutočnosti nevytvárajú čistý text, ale produkujú obohatený text (s fontami a formátovaním) a používajú vlastné formáty ako RTF (Rich Text Format).

Druhý dôvod je, že editor kódu je špecializovaný na editáciu kódu, takže môže poskytovať pomocné funkcie ako zvýraznenie kódu farbou podľa jeho významu, alebo automaticky za teba uzatvárať úvodzovky.

Všetko uvidíme neskôr. Čoskoro budeš považovať svoj verný editor za svoj obľúbený nástroj. :)

Vytvorenie virtualenvu a inštalácia Djanga

Časť tejto kapitoly je založená na tutoriáloch Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).

Časť tejto kapitoly je založená na django-marcador tutorial pod licenciou Creative Commons Attribution-ShareAlike 4.0 International License. Tutoriál django-marcador je autorsky chránený Markusom Zapke-Gründemannom et al.

Virtuálne prostredie

Skôr, ako nainštalujeme Django, nainštalujeme si extrémne užitočný nástroj, ktorý ti pomôže udržiavať poriadok pri programovaní na tvojom počítači. Je možné tento krok preskočiť, no veľmi ho odporúčame. Začať s najlepším možným nastavením ti ušetrí kopec problémov v budúcnosti!

Takže poďme vytvoriť virtuálne prostredie (alebo aj virtualenv). Virtualenv oddelí nastavenia Pythonu/Djanga pre každý projekt zvlášť. To znamená, že zmeny, ktoré urobíš na jednej web stránke, neovplyvnia iné stránky, ktoré vyvíjaš. Šikovné, však?

Jediné, čo musíš urobiť, je nájsť priečinok, v ktorom chceš virtualenv vytvoriť, napríklad tvoj domovský priečinok. Vo Windowse by mohol vyzerať napríklad C:\Users\Meno (kde Meno predstavuje tvoj login).

POZNÁMKA: Vo Windowse sa uisti, že tento priečinok neobsahuje špeciálne znaky alebo znaky s diakritikou; ak tvoje uživateľské meno obsahuje znaky s diakritikou, použi iný priečinok, napr. C:\djangogirls.

V tomto tutoriáli budeme používať nový priečinok djangogirls v tvojom domovskom priečinku:

command-line

$ mkdir djangogirls
$ cd djangogirls

Vytvoríme virtualenv s názvom myenv. Všeobecný príkaz má takýto formát:

command-line

$ python3 -m venv myvenv

C:\Users\Name\djangogirls> python -m venv myvenv

$ python3 -m venv myvenv

Práca s virtualenvom

Vyššie uvedený príkaz vytvorí priečinok s názvom myvenv (alebo akékoľvek meno si si vybrala), ktorý obsahuje naše virtuálne prostredie (v podstate kopec priečinkov a súborov).

C:\Users\Meno\djangogirls> myvenv\Scripts\activate

$ source myvenv/bin/activate

To, že je virtualenv spustený, zistíš tak, že príkazový riadok v konzole bude mať na začiatku (myenv).

Pri práci vo virtuálnom prostredí bude python automaticky odkazovať na správnu verziu, takže môžeš pokojne používať python namiesto python3.

OK, všetko potrebné máme prichystané. Konečne môžeme nainštalovať Django!

Inštalácia Djanga

Teraz, keď máš svoj virtualenv spustený, môžeš nainštalovať Django.

Predtým, než to urobíme, mali by sme sa uistiť, že je nainštalovaná najnovšia verzia pipu, softvéru, ktorý použijeme na inštalovanie Djanga:

command-line

(myvenv) ~$ python -m pip install --upgrade pip

Inštalácia balíčkov so závislosťami

Súbor requirements udržiava zoznam závislostí, ktoré sa nainštalujú, keď spustíš pip install:

Ako prvé vytvor súbor s názvom requirements.txt vo vnútri tvojho priečinku djangogirls/ pomocou editora, ktorý si si nainštalovala. V editore treba otvoriť nový súbor a uložiť ho ako requirements.txt v priečinku djangogirls/. Tvoj priečinok bude vyzerať takto:

djangogirls
├── myvenv
│   └── ...
└───requirements.txt

Do súboru djangogirls/requirements.txt by si mala pridať nasledujúci text:

djangogirls/requirements.txt

Django~=5.1.2

Teraz spusti pip install -r requirements.txt, aby si nainštalovala Django.

command-line

(myvenv) ~$ pip install -r requirements.txt
Collecting Django~=5.1.2 (from -r requirements.txt (line 1))
  Downloading Django-5.1.2-py3-none-any.whl (7.9MB)
Installing collected packages: Django
Successfully installed Django-5.1.2

To je všetko! Teraz si už (konečne) pripravená vytvoriť Django aplikáciu!

Inštalácia Gitu

Git je "systém na správu verzií", ktorý využíva množstvo programátoriek a programátorov. Tento softvér sleduje v priebehu času zmeny v tvojich súboroch, takže sa kedykoľvek môžeš vrátiť ku konkrétnej verzii. Je to v podstate niečo ako nástroj na nasledovanie zmien v programoch na spracovanie textu (napr. Microsoft Word alebo LibreOffice Writer), ale omnoho mocnejšie.

Inštalácia Gitu

$ sudo apt install git

$ git config --global --add init.defaultBranch main

$ sudo dnf install git

$ git config --global --add init.defaultBranch main

$ sudo zypper install git

$ git config --global --add init.defaultBranch main

Vytvorenie GitHub účtu

Choď na GitHub.com a zaregistruj si nový bezplatný používateľský účet. Nezabudni si zapamätať heslo (ak používaš správcu hesiel, pridaj si ho doň).

Vytvorenie PythonAnywhere účtu

PythonAnywhere je služba, ktorá ti umožní nechať bežať svoj kód v Pythone na serveroch v "cloude". Použijeme ju na uverejnenie našej stránky na internete.

Náš blog uverejníme na PythonAnywhere. Vytvor si "Beginner" účet na PythonAnywhere (verzia zdarma stačí, nepotrebuješ kreditnú kartu).

• www.pythonanywhere.com

Poznámka Pri výbere používateľského mena mysli na to, že URL tvojho blogu bude v tvare tvojeuzivatelskemeno.pythonanywhere.com, takže si vyber prezývku alebo názov, o čom tvoj blog je. Taktiež si určite zapamätaj svoje heslo (pridaj si ho do svojho správcu hesiel, ak nejaký používaš).

Vytvorenie PythonAnywhere API tokenu

Toto je niečo, čo musíš spraviť len raz. Keď si vytvoríš PythonAnywhere účet, hodí ťa to na tvoju nástenku. Nájdi odkaz na svoj účet (Account) vpravo hore:

následne vyber záložku "API token" a stlač tlačítko "Create new API token".

Začni si čítať

Gratulujeme, si pripravená začať! Pokiaľ máš stále zvyšný čas pred začiatkom workshopu, bolo by užitočné prečítať si pár začiatočníckych kapitol:

• Ako funguje internet

• Úvod do príkazového riadku

• Úvod do jazyka Python

• Čo je Django?

Uži si workshop!

Keď začne workshop, budeš môcť prejsť priamo na Tvoj prvý Django projekt!, lebo si už absolvovala látku z predchádzajúcich kapitol.