From a0ecf24dedf8ecde4630499274fa108e9eb1d8ff Mon Sep 17 00:00:00 2001
From: ulrich
Date: Fri, 22 Nov 2024 08:21:50 +0000
Subject: [PATCH] Angaben in Readme praezisiert.

---
 README.md |   38 ++++++++++++++++++++++++++++++++------
 1 files changed, 32 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 7e54e78..f572832 100644
--- a/README.md
+++ b/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 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
 

--
Gitblit v1.9.3