From 9af4b188647fd18d7176de92a333db72cfaba531 Mon Sep 17 00:00:00 2001 From: ulrich <undisclosed> Date: Wed, 28 Feb 2018 06:48:35 +0000 Subject: [PATCH] Doku angepasst --- README.md | 54 +++++++++++------------------------------------------- 1 files changed, 11 insertions(+), 43 deletions(-) diff --git a/README.md b/README.md index 202dc24..f59e81b 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,6 @@ # radiozentrale Eine Webanwendung zum Verwalten von Webradiosendern, Abspielgeräten und zum Spielen von Radio-Livestreams über die betreffenden Abspielgeräte. - -## Im Bau - -Diese Anwendung ist noch im Bau. Der neueste lauffähige Stand erscheint demnächst als Prototyp und wird dann von hier aus per Verknüpfung zugänglich. - ## Voraussetzungen Die radiozentrale erfordert zur Ausführung @@ -20,41 +15,36 @@ ### Bedienoberfläche -Die Bedienoberfläche setzt auf eine für die Schnittstelle der radiozentrale angepasste Version des [radio-ui](/gitblit/docs/web!radio-ui.git) auf. - -## Installation - -Hier noch die Installation beschreiben - -## Herstellung aus dem Quellcode +Die Bedienoberfläche setzt auf eine an die radiozentrale angepasste Version des [radio-ui](/gitblit/docs/web!radio-ui.git) auf. ## Webanwendung herstellen -Zum Herstellen der Webanwendung wird ein Java Development Kit (JDK) benötigt, wie es z.B. von [Azul](http://azul.com) oder dem [OpenJDK-Projekt](http://openjdk.java.net/) frei erhältlich ist. In der hier folgenden weiteren Beschreibung wird der lokale Ablageort des Java Development Kits `$JDK` genannt. +Zum Herstellen der Webanwendung wird ein Java Development Kit (JDK) benoetigt, wie es z.B. von [Azul](http://azul.com) oder dem [OpenJDK-Projekt](http://openjdk.java.net/) frei erhaeltlich ist. In der hier folgenden weiteren Beschreibung wird der lokale Ablageort des Java Development Kits `$JDK` genannt. -Desweiteren werden die folgenden Klassenbibliotheken benötigt +Desweiteren werden die folgenden Klassenbibliotheken benoetigt ``` Bibliothek Datei(en) Ablageort lokal ---------- --------- --------------- Tomcat .............. lib/servlet-api.jar ........... $CATALINA_HOME +derbyclient ......... lib/derbyclient.jar ........... $CATALINA_BASE XStream ............. xstream-1.4.7.jar ............. $JLIB Jettison ............ jettison-1.3.3.jar ............ $JLIB Transit ............. Transit.jar ................... $JLIB BaseLink ............ BaseLink.jar .................. $JLIB -derbyclient ......... derbyclient.jar ............... $JLIB ``` -Diese sind an folgenden Orten frei erhältlich: +Diese sind an folgenden Orten frei erhaeltlich: - [Apache Tomcat](http://tomcat.apache.org) +- [Apache Derby](http://db.apache.org/derby) - [XStream](https://github.com/codehaus/xstream) - [Jettison](https://github.com/codehaus/jettison) - [Transit](/gitblit/docs/Transit.git) - [BaseLink](/gitblit/docs/BaseLink.git) -Nach Beschaffung des JDK und der oben angegebenen Klassenbibliotheken wird der Quellcode aus diesem Git-Repository an einen frei wählbaren lokalen Ablageort [heruntergeladen](http://uhilger.de/gitblit/zip/?r=radiozentrale.git&h=master&format=zip) und entpackt. In der hier folgenden weiteren Beschreibung wird das so entstandene Verzeichnis `radiozentrale-master` einschließlich des absoluten Pfades dorthin `$RZ` genannt. Ferner wird angenommen, dass die oben aufgeführten Klassenbibliotheken lokal an Orten abgelegt sind, deren Pfade mit den Platzhaltern `$JLIB` und `$CATALINA_HOME` gemeint sind. Anstelle der Platzhalter in den folgenden Kommandos muss also der absolute Pfad des lokalen Ablageortes eingesetzt werden. +Nach Beschaffung des JDK und der oben angegebenen Klassenbibliotheken wird der Quellcode aus diesem Git-Repository an einen frei waehlbaren lokalen Ablageort [heruntergeladen](http://uhilger.de/gitblit/zip/?r=radiozentrale.git&h=master&format=zip) und entpackt. In der hier folgenden weiteren Beschreibung wird das so entstandene Verzeichnis `radiozentrale-master` einschliesslich des absoluten Pfades dorthin `$RZ` genannt. Ferner wird angenommen, dass die oben aufgefuehrten Klassenbibliotheken lokal an Orten abgelegt sind, deren Pfade mit den Platzhaltern `$JLIB` und `$CATALINA_HOME` gemeint sind. Anstelle der Platzhalter in den folgenden Kommandos muss also der absolute Pfad des lokalen Ablageortes eingesetzt werden. -Zur Herstellung der Dateiverwaltung werden die folgenden Kommandos ausgeführt (Beispiel für Linux): +Zur Herstellung der Dateiverwaltung werden die folgenden Kommandos ausgefuehrt (Beispiel fuer Linux): ``` cd $RZ @@ -74,7 +64,7 @@ rm -r build ``` -Das Webarchiv der Dateiverwaltung liegt anschließend als `$RZS/dist/rz.war` fertig zum Deployment bereit. +Das Webarchiv der Dateiverwaltung liegt anschliessend als `$RZS/dist/rz.war` fertig zum Deployment bereit. ### Distributionsalternative @@ -84,31 +74,9 @@ Die radiozentrale erfordert den Derby Client Datenbanktreiber (derbyclient.jar). Der Treiber ist nicht im Verteilpaket enthalten und sollte stattdessen im Ordner `$CATALINA_BASE/lib` von Tomcat hinterlegt sein. -## Abhängigkeiten +### Abhaengigkeiten der Bedienoberflaeche -Die Dateiverwaltung erfordert die folgenden Bestandteile auf der Instanz von Tomcat, auf der sie ausgeführt werden soll: -(die nachfolgende Liste noch aktualisieren für das radio.ui) - -``` -$CATALINA_BASE/webapps/jslib/bootstrap ............ mindestens in Version 4.0 alpha 6 -$CATALINA_BASE/webapps/jslib/jquery ............... mindestens in Version 3.2.1 -$CATALINA_BASE/webapps/jslib/mustache ............. mindestens in Version 2.3.0 -$CATALINA_BASE/webapps/jslib/font-awesome ......... mindestens in Version 4.4.0 -$CATALINA_BASE/webapps/jslib/codemirror ........... mindestens in Version 5.24.2 -$CATALINA_BASE/webapps/jslib/tinymce .............. mindestens in Version 4.3.4 -$CATALINA_BASE/webapps/jslib/fancybox ............. mindestens in Version 3 -``` - -`$CATALINA_BASE` meint das in der der Datei [RUNNING.txt](http://tomcat.apache.org/tomcat-8.5-doc/RUNNING.txt) der Tomcat-Dokumentation so bezeichnete Verzeichnis. Nachfolgend die Quellen, von denen die obigen Abhängigkeiten bezogen werden können: -(die nachfolgende Liste noch aktualisieren für das radio.ui) - -- [Bootstrap](http://getbootstrap.com) -- [jQuery](http://jquery.com) -- [Mustache](https://github.com/janl/mustache.js) -- [Font Awesome](http://fontawesome.io/) -- [Codemirror](https://codemirror.net) -- [TinyMCE](https://tinymce.com) -- [Fancybox](http://fancyapps.com/fancybox/3/) +Die radiozentrale erfordert zudem Bestandteile auf der Instanz von Tomcat, auf der sie ausgefuehrt werden soll, wie sie vom [radio-ui](/gitblit/docs/web!radio-ui.git) vorgegeben sind (siehe Beschreibung dort). ## Lizenz -- Gitblit v1.9.3