Persoenliche Mediazentrale
ulrich
2024-11-22 a0ecf24dedf8ecde4630499274fa108e9eb1d8ff
README.md
@@ -4,17 +4,43 @@
Weitere Informationen auf der [Produktseite](https://uhilger.de/data/pg/tango/).
## Abhängigkeiten
## Voraussetzungen
Tango nutzt und erfordert die folgenden Produkte:
Zur Herstellung von Tango aus dem Quellcode wird ein Java Development Kit (JDK) benötigt. Das JDK ist von [Adoptium](https://adoptium.net/) frei erhältlich. In der hier folgenden weiteren Beschreibung wird der lokale Ablageort des Java Development Kits `$JDK` genannt.
[Java](https://adoptopenjdk.net/) - Ablaufumgebung
Tango erfordert darüber hinaus die folgenden Klassenbibliotheken:
[Gson](https://github.com/google/gson) - JSON/Java Serialisierung und Deserialisierung
[jID3Lib](http://javamusictag.sourceforge.net/) - Java ID3 Tag Library
[Mustache](http://mustache.github.io/) - "Logic-less templates."
[RobotoRegular](https://fonts.google.com/specimen/Roboto) - Schriftart
Die obigen Bestandteile sind im Auslieferungspaket enthalten. Im Falle der Verwendung des Quellcodes für eigene / andere Zwecke müssen diese allerdings selbst beschafft und hinzugefügt werden.
Die benötigten Klassenbibliotheken müssen zur Herstellung von Tango an einen Ablageort auf der lokalen Maschine heruntergeladen werden. Zudem werden auf der Seite des Clients folgende Hilfsmittel eingesetzt:
[Mustache](http://mustache.github.io/) - "Logic-less templates."
[Roboto](https://fonts.google.com/specimen/Roboto) - Schriftart
Mustache und Roboto sind im Quellcode von Tango in den Ordnern `www/font` und `www/js/mustache` hinterlegt.
## Quellcode von Tango erhalten
Der Quellcode von Tango wird von hier an einen frei wählbaren lokalen Ablageort heruntergeladen und entpackt. In der hier folgenden weiteren Beschreibung wird das so entstandene Verzeichnis `tango` einschließlich des absoluten Pfades dorthin `$TANGO` genannt. Anstelle von `$TANGO` würde man also beispielweise `/home/fred/tango` notieren, wenn in das persönliche Verzeichnis des Benutzers `fred` heruntergealden und entpackt wurde.
## Tango herstellen
Es wird angenommen, dass die als Abhängigkeiten aufgeführten Klassenbibliotheken lokal an einem Ort abgelegt sind, dessen Pfad mit dem Platzhalter `$JLIB` gemeint ist. Zur Herstellung von Tango werden mit Hilfe der wie zuvor beschrieben geladenen Teile die folgenden Kommandos ausgeführt (Beispiel für Linux):
```
cd $TANGO
mkdir classes
mkdir dist
$JDK/bin/javac -classpath $JLIB/gson-2.8.6.jar:$JLIB/jid3lib-0.5.4.jar -d classes src/de/uhilger/tango/*.java src/de/uhilger/tango/api/*.java src/de/uhilger/tango/entity/*.java src/de/uhilger/tango/store/*.java
$JDK/bin/jar -cf dist/tango.jar -C classes .
```
Die fertig verwendbare Anwendung liegt anschließend unter `$TANGO/dist/tango.jar` mit den erforderlichen Klassenbibliotheken im Ordner `$TANGO/dist/lib` .
## Tango verwenden
Installation, Ausführung und Bedienung von Tango beschreibt die [Anleitung](https://uhilger.de/data/pg/tango/doku/anleitung.adoc).
## Lizenz