Installeringsguide - I-sektionen/i-portalen GitHub Wiki

I-portalen

Sätt upp utvecklingsmiljön (alla operativsystem)

Installera Python

  1. Navigera till https://www.python.org/getit/ och ladda ner senaste python version.
  2. Kontrollera installationen genom att köra python --version i din lokala terminal/CMD.
  3. Får du inte Python 3.6.5 (eller senare) och sitter på en Windows maskin så se till att python är tillagd i dina PATH variabler (google är din vän). Se gärna till att lägga till PATH_TO_LOCAL_PYTHON/scripts/ också medan du redan är där (ersätt PATH_TO_LOCAL_PYTHON med sökvägen till din python installation).
  4. Testa nu att pip är installerat (vilket det borde automatiskt vara) genom att köra pip --version.

Installera git

  1. Navigera till https://git-scm.com/downloads och ladda ner den senaste versionen.
  2. Ändra lämpliga inställningar efter smak tills det att du kommer till "Choosing the default editor used by Git" - här rekomenderar jag att du väljer "Use the Nano editor by default" ifall du inte har någon annan preferens.
  3. Välj "Use git from the Windows Command Prompt" (eller liknande ifall du använder OSX/Linux).
  4. Klicka på "Next" för samtliga följande frågor (ifall du inte har koll på vad du vill).
  5. Testa nu git genom att köra kommandot git --version.

Installera mysql

  1. Besök https://dev.mysql.com/downloads/mysql/ och installera senaste version av "MySQL Community Server".
  2. Följ instruktionerna och kontrollera installationen genom att köra mysql --version (återigen bör Windowsanvändare vara medvetna om att de kanske behöver lägga till mysql i deras PATH variabler).

Installera Pycharm

  1. Börja med att besöka https://www.jetbrains.com/shop/eform/students och skapa ett studentkonto med ditt LiU mail.
  2. Logga in på jetbrains hemsida och besök undersidan "Licenses".
  3. Klicka på "Pycharm" och ladda ner programmet.

Hämta ner projektet du skall arbeta med

  1. Starta PyCharm och välj Check out from Version Control och sedan git.
  2. Koperia länken från det github repo som du skall arbeta med (i-portalen eller isektionen) till URL fältet och välj en lämplig lokal plats för projektet.
  3. Använd ditt github konto som authenticationsverktyg.

Ställ in Pycharm

  1. Öppna settings, File->Settings... (eller motsvarande beroende på OS)
  2. Under >Project: i-portalen klickar du på Project interpreter och sedan på kugghjulet i högra hörnet och väljer Add och se till att du har python som "Base Interpreter"
  3. Klicka sedan på >Languages & Frameworks i vänster menyn och sedan på django.
  4. Kryssa i Enable Django Support och fyll i följande:
  • Django project root: ~repos/i-portalen/wsgi/iportalen_django
  • Settings: iportalen/settings.py
  • Manage script: manage.py
  1. Klicka sedan på OK.
  2. Klicka in på någon valfri python fil och när du får upp en popup av Pycharm om "Missing dependencies" välj installera eller liknande. Skulle du inte få upp detta går det bra att starta terminalen i Pycharm (ikonen i nedersta, vänstra, hörn> Terminal) och köra pip install -r requirements.txt.

Konfigurera din lokala databas

  1. Starta mysql i en terminal: mysql -u root -p
  2. Skriv in ditt lösenord och logga in.
  3. Skapa databasen: CREATE DATABASE django_iportalen CHARACTER SET UTF8; (om du skall arbeta på isektionen så byt ut django_iportalen mot django_isektionen
  4. Skapa en mysql användare med rätt behörigheter:
CREATE USER 'namn'@'localhost' IDENTIFIED BY 'lösenord';
GRANT ALL PRIVILEGES ON django_iportalen.* TO namn@localhost;
GRANT ALL PRIVILEGES ON test_django_iportalen.* TO namn@localhost;

OBS! namn och lösenord som står i koden ovan måste bytas ut till något godtyckligt. Dock utan mellanslag i namn eller lösenord!

  1. Kopiera filen i-portalen/wsgi/iportalen_django/iportalen/mysql_credentials.example och spara den nya som i-portalen/wsgi/iportalen_django/iportalen/mysql_credentials (OBS! utan .txt ändelse) Skriv in valt namn och lösenord (alltså och <lösenord> ovan) i den nya filen och se till att ta bort det som är skrivet så att filen blir på formen: 
    host localhost
port 3306
user django_iportalen
password top_secret_password
  2. Migrera din databas. Kör manage.py: tools>Run manage.py task och kör kommandot migrate Då skapas alla tabeller och relationer i databasen.
  3. Om du vill kan du skapa en superanvändare på din lokala miljö: createsuperuser Följ instruktionerna.

Starta servern

  1. Har du kommit hit så bör allting vara på plats för att du skall kunna starta din lokala server och börja utveckla!
  2. Starta manage.py genom kortkommando eller tools>Run manage.py task och kör kommandot: runserver
  3. Profit!

Typiska problem

  • runserver ger ett error-meddelande om att det inte går att kontakta mysql. Löses ofta genom att dels kolla att du har fyllt i rätt user/lösen i mysql_credentials filen och sedan att mysql servern körs. Servern kan startas genom att köra mysqld i en terminal (som sedan kan stängas, oavsett vad pop-up:en säger)

Statiskt innehåll

Javascript, css och annat statiskt innehåll kan läggas till genom att i appen det statiska tillhör så skapas en undermapp 'static' i den läggs ytterligare en mapp med samma namn som appen. Tex: event/static/event. Statiskt innehåll som inte hör till någon speciell app kan läggas direkt i wsgi/static.

Länkar

⚠️ **GitHub.com Fallback** ⚠️