From ad1feface16db0181f77db765244bac43bc55c98 Mon Sep 17 00:00:00 2001 From: ulrich <not disclosed> Date: Thu, 04 Jan 2018 10:43:08 +0000 Subject: [PATCH] Doku ergänzt --- README.md | 38 ++++++++++++++++++++++++++++++++++++++ 1 files changed, 38 insertions(+), 0 deletions(-) diff --git a/README.md b/README.md index 93792ae..327106e 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,44 @@ Eine Bedienoberfläche für Webradio +## Prototyp + +Diese Anwendung ist zur Zeit im Bau. Der aktuelle Prototyp zum Stand des Codes in diesem Repository ist hier zu sehen: +[Link zum Prototyp](/data/ulrich/test/radio-ui). + +## Vorgesehene Funktionen + +Das radio-ui zeigt eine Übersicht von Radiosendern. Antippen eines Senders in der Übersicht spielt den Sender ab. + +Radiosender können hinzugefügt, geändert und gelöscht werden. Ein Suchfeld ermöglicht das Einschränken der Übersicht auf bestimmte Sender. + +Das Abspiel-Ziel ist konfigurierbar: Ein Radionsender kann entweder auf dem Gerät abgespielt werden, auf dem das radio-ui läuft oder auf einem anderen Gerät wie z.B. einem Raspberry Pi. + +Zum Abspielen auf einem Raspberry Pi ist die Nutzung der Anwendung [pirc](/gitblit/docs/pirc.git) vorgesehen, die zum Spielen von Audiostreams den [omxplayer](https://elinux.org/Omxplayer) mit einer unter [Tomcat](https://de.wikipedia.org/wiki/Apache_Tomcat) laufenden Fernbedienung kombiniert, die per HTTP gesteuert werden kann. + +## Nutzung von Vorlagen + +Die Anwendung radio-ui ist ein Beispiel für die Nutzung von Vorlagen in Webanwendungen. Die Datei `index.html` definiert Bereiche einer HTML-Seite als `div`-Elemente die während der Ausführung des Programmes dynamisch mit wechselnden Inhalten gefüllt werden. + +## Abhängigkeiten + +Zur Verwendung des radio-ui sind die folgenden Komponenten erforderlich + ++ [jQuery](http://jquery.com/) ++ [Mustache](https://github.com/janl/mustache.js) ++ [app-menu](/gitblit/docs/web!app-menu.git) + +Diese sind in der Datei `index.html` über die folgenden Einträge eingebunden. + +```` +<link rel="stylesheet" type="text/css" href="../jslib/app-menu/nav-toggle.css"> +<link rel="stylesheet" type="text/css" href="../jslib/app-menu/app-menu.css"> +<script src="../jslib/jquery-1.11.1/jquery-1.11.1.min.js"></script> +<script src="../jslib/mustache/mustache.min.js"></script> +<script src="../jslib/app-menu/app-menu.js"></script> +```` + +Sollen einzelne Komponenten von einem anderen Ort wie beispielsweise einem Content Delivery Network (CDN) eingebunden werden, müssen nur die obigen Einträge entsprechend angepasst werden. ## Radiostreams -- Gitblit v1.9.3