README.md 1.99 KB
Newer Older
Axel Dürkop's avatar
Axel Dürkop committed
1 2
[![build status](https://collaborating.tuhh.de/itbh/hopon-fahrplan/badges/master/build.svg)](https://collaborating.tuhh.de/itbh/hopon-fahrplan/commits/master)

Andreas Böttger's avatar
Andreas Böttger committed
3
**Diese Anleitung ist zum Teil nicht mehr aktuell**
Axel Dürkop's avatar
Axel Dürkop committed
4

Axel Dürkop's avatar
Axel Dürkop committed
5 6
# Hop-on

Axel Dürkop's avatar
Axel Dürkop committed
7 8 9 10 11 12 13
## Installieren von Django und weiteren Paketen

Als `root`:
```bash
/home/django $ pip3.4 install -r requirements.txt
```

Axel Dürkop's avatar
Axel Dürkop committed
14 15 16 17 18
## Fixtures einspielen

Um eine leere Datenbank mit allen notwendigen Phrasen zu füllen und den Entscheidungsbaum anzulegen, müssen die Datensätze aus der Datei `load_fixtures.py` eingespielt werden.

```bash
Axel Dürkop's avatar
Axel Dürkop committed
19
$ rm db.sqlite3
Michael Heinemann's avatar
Michael Heinemann committed
20
$ python manage.py migrate --database=roadmap.db
21
$ python manage.py shell < fixtures/load_fixtures.py
Axel Dürkop's avatar
Axel Dürkop committed
22
```
Axel Dürkop's avatar
Axel Dürkop committed
23

Axel Dürkop's avatar
Axel Dürkop committed
24 25 26 27 28 29 30
Anschließend müssen noch die statischen Dateien prozessiert werden:

```bash
$ python manage.py collectstatic
```
Der Webserver muss so konfiguriert werden, dass er statische Dateien über den Alias `/static` aus `/assets` ausliefert. Das ist so in `config/settings.py` festgelegt.

Axel Dürkop's avatar
Axel Dürkop committed
31
## Reader-GitBook bauen
Axel Dürkop's avatar
Axel Dürkop committed
32 33 34 35 36 37 38 39 40 41

Das GitBook "Reader" ist Teil der Django-Anwendung. Es befindet sich im Unterordner `gitbook`. Der Ordner ist ein *submodule* von Git und referenziert `ssh://git@fizban02.rz.tu-harburg.de:20022/Early-Bird-Betreuende/inbas_berlin.git`.

Das HTML-Konstrukt, das von *gitbook* generiert wird, besteht nicht aus vollständigen HTML-Dokumenten. Vielmehr entstehen Versatzstücke, die von Django in das Basislayout eingebaut werden.

Um das GitBook zu bauen und an die richtige Stelle zu verschieben, ist folgender Befehl im Ordner `gitbook` auszuführen:

```bash
$ gitbook build . ../templates/reader
```
michael's avatar
michael committed
42 43 44 45 46 47

Zur Erstellung der PDF-Dateien wird *wkhtmltopdf* als Service benötigt.
Die derzeit aktuellste funktionierende Version ist:
```bash
$ wkhtmltopdf 0.12.3 (with patched qt)
```
Michael Heinemann's avatar
Michael Heinemann committed
48 49
Zu beachten ist immer der Zusatz: *(with patched qt)*  
[Installationsanleitung](https://stackoverflow.com/questions/34479040/how-to-install-wkhtmltopdf-with-patched-qt/38336153#38336153)
Axel Dürkop's avatar
Axel Dürkop committed
50 51 52 53 54 55

## Deutsche locale generieren

```bash
$ python manage.py makemessages -l de
```