Ha otthon csinálod a tutorialt
Ha otthon csinálod a tutorialt, nem valamelyik Django Girls eseményen, át is ugorhatod ezt a fejezetet, és folytathatod a Hogy működik az Internet? fejezettel.
Ez az oldal csak egy helyre gyűjti az installációk leírását, amikkel később úgyis találkozni fogsz a tutorial során. A Django Girls workshopok előtt mindig van egy installációs esemény, amikor mindent telepítünk, hogy a workshopon már ne kelljen ezzel bajlódni, ezért hasznos nekünk, hogy mindent megtalálunk egy helyen.
Ha te is hasznosnak találod, nyugodtan elvégezheted ezt a fejezetet. De ha inkább fejest szeretnél ugrani a tanulásba, mielőtt egy csomó mindent telepítenél a gépedre, nyugodtan ugord át a fejezetet! Később úgyis elmagyarázzuk az összes telepítést.
Sok szerencsét!
Installáció
A workshopon egy blogot fogsz elkészíteni. Ehhez el kell végezned néhány telepítési feladatot, hogy a workshop napján már egyből elkezdhess kódolni.
A Python telepítése
Ez a fejezet a Geek Girls Carrots (https://github.com/ggcarrots/django-carrots) tutorialján alapszik
A Django Python nyelven íródott. Ahhoz, hogy bármit létrehozhassunk a Django-ban, szükségünk van a Pythonra is. Kezdjük a telepítésével! Azt szeretnénk, hogy a Python 3.6-es verziója legyen telepítve -- ha ennél korábbi verzióval rendelkezel, akkor frissítened kell.
A Python-t az alábbi weboldalról tudod letölteni: https://www.python.org/downloads/release/python-343/. Az *.msi fájlt a letöltés után futtasd (dupla kattintás), és kövesd az utasításokat. Fontos, hogy emlékezz a path-ra (könyvtárra), ahova letöltötted. Később szükséged lesz rá!
Egy fontos dolog, amire figyelj oda: a telepítővarázsló második képernyőjén ("Customize") görgess lejjebb, és válaszd ki az "Add python.exe to the Path" opciót, ahogy itt láthatod:
Megjegyzés Mielőtt telepítenéd a Pythont macOS-en, bizonyosodj meg arról hogy a Mac beállításaid megengedik olyan csomagok telepítését, amelyek nem az App Store-ból származnak. Nyisd meg a System Preferences ablakot (az Applications mappában), kattints a "Security & Privacy" gombra majd a "General" fülre. Ha az "Allow apps downloaded from:" beállítás "Mac App Store"-ra van állítva, állítsd át "Mac App Store and identified developers"-ra.
Menj a https://www.python.org/downloads/release/python-343/ oldalra, és töltsd le a Python installert:
- Töltsd le a macOS 64-bit/32-bit installer fájlt,
- Kattints duplán a python-3.4.3-macosx10.6.pkg-re, hogy futtasd a telepítőt.
Nagyon valószínű, hogy a Python már telepítve van a gépedre. Ahhoz, hogy ezt leellenőrizd (illetve hogy megnézd, melyik verzió van a gépeden), nyisd meg a konzolt és írd be az alábbi parancsot:
$ python3 --version
Python 3.4.3
Ha még nincs Pythonod, vagy másik verziót szeretnél telepíteni, így teheted meg:
Bizonyosodj meg arról, hogy sikeres volt a telepítés! Nyisd meg a Terminált és futtasd le a python3 parancsot:
$ python3 --version
Python 3.4.3
Megjegyzés Ha windows-t használsz és egy hibaüzenetet kapsz, mely szerint python3 nem található, próbáld meg python néven (a 3 nélkül) és ellenőrizd hogy Python 3.6-e.
Ha kétségeid vannak, vagy valami elromlott, és nem tudod, mit csinálj - csak kérdezd meg a coachodat! Néha a dolgok nem mennek teljesen simán, és jobb megkérdezni valakit, akinek több tapasztalata van a témában.
Virtuális környezet létrehozása és a Django telepítése
Ennek a fejezetnek egy része a Geek Girls Carrots (https://github.com/ggcarrots/django-carrots) tutorialjain alapul.
A fejezet részben a django-marcador tutorial-on alapszik, ami a Creative Commons Attribution-ShareAlike 4.0 International License jogvédelem alatt áll. A django-marcador tutorial jogvédelem alatt áll, Markus Zapke-Gründemann et al által.
Virtuális környezet
Mielőtt feltelepítjük a Django-t, egy rettentő hasznos eszközt fogunk installálni, ami segít, hogy a kódolói környezetedet rendben tartsa a számítógépeden. Át lehet ugrani ezt a lépést, de nem ajánlott. Ha a lehető legjobb kiindulási helyzetből kezded a kódolást, sok bosszúságot megspórolhatsz magadnak a jövőben!
Tehát először is hozzunk létre egy virtuális környezetet (virtual environment), amit virtualenv-nek is hívunk. A virtualenv projektenként különíti el a Python/Django környezetet. Ez azt jelenti, hogy ha megváltoztatsz valamit egy weboldalon, az nem lesz hatással a többi weboldalra, amit párhuzamosan fejlesztesz. Jó, igaz?
Csak annyit kell tenned, hogy kiválasztasz egy könyvtárat, ahova a virtualenvet szeretnéd telepíteni, például a home könyvtárat. Windowson ez így nézhet ki: C:\Users\Name (ahol a Name a felhasználód neve).
Megjegyzés Windows-on gondoskodj arról, hogy ez a könyvtár nem tartalmaz ékezetes vagy speciális karaktereket; ha a van ékezetes karakter a felhasználónevedben, használj egy másik könyvtárt, például
C:\djangogirls.
Ehhez a tutorialhoz egy új, djangogirls nevű mappát fogunk használni a home könyvtáradon belül:
mkdir djangogirls
cd djangogirls
Most pedig létrehozunk egy myvenv nevű virtuális környezetet. A kód általánosan így néz ki:
python3 -m venv myvenv
Ahhoz, hogy létrehozz egy új virtualenv-et, meg kell nyitni a konzolt (pár fejezettel ezelőtt tanultál róla - emlékszel?) és a ezt a parancsot kell lefuttatnod: C:\Python35\python -m venv myvenv. Ez fog történni:
C:\Users\Name\djangogirls> C:\Python35\python -m venv myvenv
itt a C:\Python35\python azt a könyvtárat jelenti, ahova korábban a Pythont telepítetted, és a myvenv a virtualenv-ed neve. Bármi más nevet is használhatsz, de maradj a kisbetűs szavaknál, és ne használj szóközt, ékezeteket, vagy más speciális karaktereket. Jó ötlet rövid nevet adni - sokszor be kell majd gépelned!
A virtualenv létrehozása Linux és macOS környezetben is csak annyiból áll, hogy a python3 -m venv myvenv parancsot futtatod. Így fog kinézni:
~/djangogirls$ python3 -m venv myvenv
A myvenv avirtualenv-ed neve. Más nevet is használhatsz, de maradj a kisbetűs szavaknál, és ne használj szóközt, ékezeteket, vagy más speciális karaktereket. Jó ötlet rövid nevet adni - sokszor be kell majd gépelned!
MEGJEGYZÉS: Debian/Ubuntu némelyik verziójánál az alábbi hibaüzenetet kaphatod:
parancssor
The virtual environment was not created successfully because ensurepip is not available. On Debian/Ubuntu systems, you need to install the python3-venv package using the following command. apt install python3-venv You may need to use sudo with that command. After installing the python3-venv package, recreate your virtual environment.Ebben az esetben a fenti leírást követve telepítsd a
python3-venvcsomagot:parancssor
$ sudo apt install python3-venvMEGJEGYZÉS: A virtuális környezetet létrehozó parancs Ubuntu 14.04 alatt ezt a hibát adja:
Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1Hogy ezt elkerüld, használd a
virtualenvparancsot.~/djangogirls$ sudo apt install python-virtualenv ~/djangogirls$ virtualenv --python=python3.6 myvenvMEGJEGYZÉS: Ha az alábbi hibaüzenetet kapod:
parancssor
E: Unable to locate package python3-venvAkkor az alábbit futtasd:
parancssor
sudo apt install python3.6-venv
Hogyan dolgozhatsz virtuális környezetben
A fenti parancs létrehozott egy myvenv nevű (vagy bármi más név, amit választottál) könyvtárat, ami a virtuális környezetünket tartalmazza (ez tulajdonképpen csak egy csomó könyvtár és fájl).
Így indíthatod el a virtuális környezetet:
C:\Users\Name\djangogirls> myvenv\Scripts\activate
MEGJEGYZÉS: Windows 10-en lehet hogy egy hibaüzenetet kapsz Windows PowerShell-ben, amely szerint
execution of scripts is disabled on this system(scriptek futtatása le van tiltva ezen a rendszeren). Ebben az esetben nyiss egy másik Windows PowerShell-t a "Run as Administrator" (adminisztrátorként futtatás) opcióval. Majd próbáld meg az alábbi parancsot beírni mielőtt elindítod a virtuális környezetedet:parancssor
C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned Execution Policy Change The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"): A
Így indíthatod el a virtuális környezetet:
~/djangogirls$ source myvenv/bin/activate
Fontos, hogy myvenv helyett azt a neved írd be, amit a virtualenv-ednek választottál!
MEGJEGYZÉS: néha a
sourcenem elérhető. Ebben az esetben próbáld meg ezt:~/djangogirls$ . myvenv/bin/activate
Onnan tudod, hogy a virtualenv elindult, hogy a konzolodban a prompt így néz ki:
(myvenv) C:\Users\Name\djangogirls>
vagy:
(myvenv) ~/djangogirls$
Figyeld meg, hogy megjelent a (myvenv) előtag!
Ha virtuális környezetben dolgozol, a python parancs mindig a megfelelő Python verzióra fog mutatni, tehát nyugodtan használhatod a python-t python3 helyett.
Oké, most már minden feltétel teljesült. Végre installálhatjuk a Django-t!
A Django telepítése
Most, hogy elindítottad a virtualenv-et, telepiteni tudod a Django-t.
Mielőtt ezt megtennénk, meg kell győződnünk arról, hogy a pip legfrissebb verzióját használjuk, amelynek segítségével fogjuk tudni telepíteni a Django-t:
parancssor
(myvenv) ~$ python3 -m pip install --upgrade pip
Ezután futtasd ezt a parancsot a konzolban: pip install django~=1.11 (figyelj oda, hogy egy tilde karaktert használunk, amelyet egy egyenlőségjel követ: ~=).
parancssor
(myvenv) ~$ pip install django~=1.11.0
Collecting django~=1.11.0
Downloading Django-1.11.3-py2.py3-none-any.whl (6.8MB)
Installing collected packages: django
Successfully installed django-1.11.3
Ha hibát kapsz, amikor a pip-et hívod Windowson, nézd meg, hogy tartalmaz-e a projekted elérési útvonala szóközt, ékezetet, vagy speciális karaktereket (pl.
C:\Users\User Name\djangogirls). Ha igen, használj helyette egy olyan könyvtárat, ahol nincsenek szóközök, ékezetek vagy speciális karakterek (javaslat:C:\djangogirls). Hozd létre az új könyvtárat, és abban egy új virtualenvet, majd töröld ki a régit és az új helyen próbáld futtatni az előző parancsot. (A virtualenv könyvtár áthelyezése nem fog működni, mert a virtualenv abszolút elérési utakat használ.)
Ennyi! Most pedig (végre) létrehozhatod a Django alkalmazásodat!
Kódszerkesztő telepítése
Sokféle kódszerkesztő program létezik, és valójában ízlés kérdése, hogy ki melyiket választja. A legtöbb Python programozó bonyolult fejlesztői környezetet (IDE - Integrated Development Environment) használ, mint például a PyCharm. Egy kezdőnek viszont nem ezek a legmegfelelőbbek. A programok, amiket mi ajánlunk, hasonlóan hatékonyak, de használatuk sokkal egyszerűbb.
Mi az alábbiakat javasoljuk, de nyugodtan kérj segítséget a coach-odtól, ő is könnyen tud tanácsot adni ez ügyben.
Gedit
A Gedit egy open-source (nyílt forráskódú), ingyenes kódszerkesztő, az összes jelenlegi operációs rendszeren elérhető.
Sublime Text
A Sublime Text egy nagyon népszerű editor, ingyenes próbaidővel. Könnyű telepíteni és használni, és minden operációs rendszeren elérhető.
Atom
Az Atom egy teljesen új kódszerkesztő, amelyet a GitHub hozott létre. Ingyenes, nyílt forráskódú, könnyen telepíthető és könnyen használható. Elérhető Windows-on, OSX-en és Linuxon.
Miért telepítünk kódszerkesztőt?
Most talán azon gondolkozol, miért telepítünk speciális kódszerkesztőt, ahelyett, hogy a Word vagy a Notepad alkalmazást használnánk.
Az első ok az, hogy a kódot egyszerű szövegként kell szerkeszteni. Az általános (nem programozóknak szánt) szövegszerkesztőkkel, mint a Word és a Textedit, az a probléma, hogy nem egyszerű szöveges fájlt állítanak elő, hanem formázott dokumentumot (például RTF (Rich Text Format) formátumban), amelyben számít például a betűtípus, formázás, stb.
A másodsorban ezek a programozáshoz tervezett szövegszerkesztők kifejezetten kódszerkesztésre szakosodtak, ami azt jelenti hogy különböző funkciókkal segítik a munkát, mint például a programkód részeinek, szavainak kiemelése annak jelentése alapján, vagy az automatikus kiegészítés.
Ezt mind látni fogjuk a későbbiekben. Hamarosan úgy fogsz gondolni a jó öreg megbízható kódszerkesztődre, mint az egyik kedvenc eszközödre :)
A Git telepítése
A Git egy "version control system" (VCS, magyarul verziókezelő rendszer), amit sok programozó használ. Ez a szoftver nyomon követ minden változást a fájlokban, így a későbbiekben is visszatérhetünk egy bizonyos régebbi verzióhoz. Valamelyest hasonlít a "változások nyomon követése" funkcióhoz a Microsoft Wordben, de ez jóval hatékonyabb.
Git telepítése
A Gitet innen töltheted le: git-scm.com. Telepítése: csak kattints a "next" gombra egészen addig, amíg el nem érsz az ötödik lépésig - "Adjusting your PATH environment" címmel - itt válaszd ki a "Run Git and associated Unix tools from the Windows command-line" lehetőséget (keresd alul). Ezen kívül a többi maradhat az alapbeállításon. Checkout Windows-style, commit Unix-style line endings - ezek is maradhatnak így.
Töltsd le a Git-tet az alábbi linken: git-scm.com, majd kövesd az utasításokat.
Megjegyzés Ha OS X 10.6, 10.7, vagy 10.8-et használsz, Az ezen a linken elérhető verziót kell telepítened: Git teleptő OS X Snow Leopard-ra
GitHub fiók létrehozása
Menj a GitHub.com oldalra, és hozz létre egy új, ingyenes felhasználói fiókot.
PythonAnywhere felhasználó létrehozása
Most itt az ideje, hogy létrehozz magadnak egy ingyenes, "Kezdő" ("Beginner") fiókot a PythonAnywhere oldalon.
Megjegyzés: A blogod címe, vagyis URL-je
felhasználónév.pythonanywhere.comlesz, vagyis érdemes a regisztrációkor felhasználónévnek vagy a saját becenevedet választani, vagy a blogod témájához kapcsolódó nevet.
Kezdheted az olvasást
Gratulálunk, készen állsz a tutorialra! Ha van egy kis időd a workshop előtt, hasznos lehet, ha elolvasod az első néhány fejezetet: