Ułatwiaczek
Bo ułatwia / jasne jak słońce! [ ͡° ͜ʖ ͡°]

Ułatwiaczek w internecie: ulatwiaczek.herokuapp.com

Uruchamianie aplikacji na komputerze lokalnym:

Żeby uruchomić Ułatwiaczka lokalnie, musimy wykonać następujące kroki:

1. Pobieranie potrzebnych materiałów:

   1. Klonujemy branch master z repozytorium;
   2. Pobieramy Python'a w wersji 3.6.0 dla naszego systemu;
   3. Pobieramy Node.js w wersji 7.5.0;

2. Sprawdzenie poprawosci instalacji Python'a oraz Node.js:

   1. Otwieramy konsolę i wpisujemy python --version. Powinniśmy ujrzeć:
      
      
   2. Otwieramy konsolę i wpisujemy node --version. Powinniśmy ujrzeć:
      
      

3. Przygotowanie wirtualnego środowiska:

   1. Przechodzimy w konsoli do głównego folderu projektu (można go poznać po plikach manage.py, requirements.txt, README.md;

   

   2. Wpisujemy komendę pip install virtualenv.
      Po zakończeniu instalacji sprawdzamy czy wszystko zainstalowało się poprawnie komendą virtualenv --version;
      

   3. Tworzymy wirtualne środowisko virtualenv virtualenv i aktywujemy go:
      W przypadku Linuxa: source virtualenv/bin/activate
      W przypadku Windowsa: virtualenv\Scripts\activate
      

   4. Po wykonaniu tej komendy nasza konsola powinna wyglądać następująco:
      

      Należy pamiętać, że musimy wejść do naszego wirtualnego środowiska za każdym razem jeżeli chcemy uruchomić naszą aplikację lokalnie ( ͡^ ͜ʖ ͡^).

   5. Następnie instalujemy Python'ową paczkę, która zawiera między innymi Django, na którym oparty jest nasz projekt.
      Paczkę instalujemy poleceniem pip install -r requirements.txt. Po skończeniu pobierania sprawdzamy czy Django zainstalował się poprawnie poleceniem python -m django --version
      
      

   6. Teraz instalujemy Gulp'a i potrzebne do jego działania moduły.
      Będąc w głównym folderze projektu wpisujemy w konsolę: npm install. NodePackageManager automatycznie zainstaluje za nas potrzebne moduły które są zawarde w pliku package.json.

   7. Po instalacji modułów npm w konsolę wpisujemy komendę: gulp css:compile.
      Powinniśmy ujrzeć taki widok:
      
      

   8. W pliku ulatwiaczek/setting.py zmienną DEBUG zmieniamy na True

4. Uruchomienie serwera i dodawanie danych:
   Po wykonaniu poprzednich kroków, wreszcie możemy uruchomić naszą aplikację na lokalnym serwerze! Żeby to zrobić, wykonujemy następujące kroki:

   1. W konsoli [w której mamy uruchomione wirtualne środowisko!] otwartej w głównym folderze projektu (poznamy go po pliku manage.py) wpisujemy komendę: python manage.py runserver
      Powinniśmy zobaczyć coś takiego:
      
   2. Uruchamiamy przeglądarkę i wpisujemy adres: 127.0.0.1:8000. Powinna nam się pokazać strona Ułatwiaczka.