Hinweise zur Entwicklung

Werkzeuge

Folgende Werkzeuge werden zur Entwicklung benötigt:

Die Webseite wird mit Maven generiert und bei Github veröffentlicht.

toimage.sh ausführen: Dazu kann auch die Eclipse External Tools Configuration “heldendokumenta5 - shell - convert image” genutzt werden. Das Skript nutzt eine Linux Shell und ImageMagick und ist daher nur unter Linux lauffähig.
```
.../dsa-documents/src/main/scripts/toimage.sh .../dsa-documents/heldendokumenta5/src/intermediate/document/Heldendokument.pdf .../dsa-documents/heldendokumentoriginal/src/site/resources/images/document/Heldendokument 80
```
Thumbnails kontrollieren.

Releases werden mit Maven durchgeführt.

Die SCM developer connection benutzt das SSH Protokoll. Auf Github muss daher der SSH Key eingerichtet sein.
In die settings.xml müssen die bintray credentials eingetragen werden. Die Bintray REST API benötigt API keys!:

<server>
  <id>bintray</id>
  <username>(bintray-user)</username>
  <password>(bintray-api-key)</password>
</server>

Es muss eine lokale Maven Installation genutzt werden. Das Eclipse embedded Maven funktioniert nicht!

changes.xml: Änderungshistorie ergänzen
lokales Maven: Release vorbereiten:
```
mvn release:prepare
```
Evtl vorher auch mit “-DdryRun=true”.
Ergebnis kontrollieren
lokales Maven: Release durchführen
```
mvn release:perform
```
Bintray: Publish der neuen Version: Auf Bintray einloggen und im “dsa-documents” Repository die Dateien freigeben.