Django telepítés
Megjegyzés Ha elvégezted a legelső, Installáció című fejezetet, már túlvagy ezen - ugorj a következő fejezetre!
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 virtualenv
et 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 OS X 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-venv
csomagot:parancssor
$ sudo apt install python3-venv
MEGJEGYZÉ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 1
Hogy ezt elkerüld, használd a
virtualenv
parancsot.~/djangogirls$ sudo apt install python-virtualenv ~/djangogirls$ virtualenv --python=python3.6 myvenv
MEGJEGYZÉS: Ha az alábbi hibaüzenetet kapod:
parancssor
E: Unable to locate package python3-venv
Akkor 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
source
nem 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!