Zależności
----------
python2.7
python-dev
postgresql (wersja co najmniej 9.2)
postgresql-server-dev-?.?
gettext
Oprócz tego są zależności pythonowe wymienione w pliku requirements.text.
Instalujemy je przez virtualenv:
$ virtualenv venv
$ source venv/bin/activate
$ pip install -r requirements.txt
Polecenia z manage.py należy uruchamiać będąc w aktywnym środowisku virtualenv. Wyjść ze środowiska można poleceniem deactivate.
Odpalenie serwera deweloperskiego
---------------------------------
Przede wszystkim trzeba skonfigurować bazę. W tym celu należy zmienić nazwę pliku database_data.py.example w głównym katalogu projektu na database_data.py i uzupełnić w nim parametry bazy.
Konfiguracja postgresa
----------------------
$ sudo su postgres
# psql
# create user kuznia with password 'kuznia';
# create database kuznia;
# grant all privileges on database kuznia to kuznia;
Ctrl+D
Ctrl+D
Baza oczywiście na początku jest pusta. Aktualnie jedyną możliwością jest wgranie gotowego zrzutu. Zrzuty w formacie .sql.gz ładujemy poleceniem:
$ zcat zrzut.sql.gz | ./manage.py dbshell
Po załadowaniu zrzutu należy zmigrować bazę:
$ ./manage.py migrate
(wszystkie polecenia mają być wykonywane w głównym katalogu projektu, o ile nie wskazano inaczej)
Odpalenie serwera
-----------------
Odpalamy lokalny serwer:
$ ./manage.py runserver
Możemy połączyć się z nim przez http://localhost:8000/.
Nazwy użytkowników łatwo sprawdzić np. przez interfejs bazy (kolumna username w tabeli auth_user). Do potrzeby testów można ujednolicić hasła poleceniem:
$ ./manage.py set_fake_passwords --password=blaba
Kompilowanie lokalizacji
------------------------
$ ./manage.py compilemessages
Aktualizacja
------------
W celu aktualizacji repozytorium do najnowszej wersji należy wykonać następujące polecenia:
$ hg pull -u
$ ./manage.py migrate
$ ./manage.py update_permissions
$ ./manage.py compilemessages
Problemy
--------
Klawisze PageUp/PageDown działają (aktualnie przewijają na sztywno o 10, to można zmienić), ale przy włączonym zaznaczeniu i szybkim naciskaniu powodują, że czasem zaznaczenie ucieka. (okazuje się, że nawet całkiem często)
