From c9d6c1ac597b7a9747fcf762bfb2007582e14957 Mon Sep 17 00:00:00 2001 From: ulrich <undisclosed> Date: Fri, 13 Dec 2019 19:24:15 +0000 Subject: [PATCH] Doku angepasst --- readme.md | 26 +++++++------------------- 1 files changed, 7 insertions(+), 19 deletions(-) diff --git a/readme.md b/readme.md index 01504ad..913e2d5 100644 --- a/readme.md +++ b/readme.md @@ -4,7 +4,9 @@ ## Eigenschaften -Diese Vorlage etabliert eine Bedienoberfläche für Apps. Sie gruppiert Menü, Kopf- und Fußzeile sowie eine Seitenleiste um einen zentralen Bereich, dessen Inhalt nach unten aus dem sichtbaren Teil der Anzeige herausläuft, wenn der Platz auf der Anzeige nicht ausreicht. Beim Rollen des Inhalts bleiben die umliegenden Elemente sichtbar. +Diese Vorlage etabliert eine Bedienoberfläche für Apps. Sie gruppiert Menü, Kopf- und Fußzeile sowie eine Seitenleiste um einen zentralen Bereich, dessen Inhalt nach unten aus dem sichtbaren Teil der Anzeige herausläuft, wenn der Platz auf der Anzeige nicht ausreicht. + +Beim Rollen des Inhalts bleiben die umliegenden Elemente sichtbar. Damit verschwinden wichtige Bedienelemente wie das Menü nicht beim Rollen. Der Inhalt des Menüs kann über Beschreibungsdateien an unterschiedliche Belange angepasst und über eine Schaltfläche ein- und ausgeblendet werden. Die Menübeschreibungen müssen in der Javascript Object Notation (JSON) verfasst sein und können beliebig in eine hierarchische Struktur von Untermenüs verschachtelt werden. @@ -14,30 +16,16 @@ ## Verwendung -Zur Verwendung der App-Vorlage wird der Inhalt dieses Repository auf einem HTTP-Server wie z.B. [Tomcat](https://de.wikipedia.org/wiki/Apache_Tomcat) oder [lighttpd](https://de.wikipedia.org/wiki/Lighttpd) hinterlegt. Anschließend kann die App-Vorlage mit dem Uniform Resource Locator (URL) im Webbrowser aufgerufen und ausgeführt werden, der sich aus ihrem Ablageort auf dem Server ergibt. +Zur Verwendung der App-Vorlage wird der Inhalt dieses Repositorys zunächst [heruntergeladen](/gitblit/zip/?r=web/app-vorlage.git&format=zip). Der Inhalt des so beschafften ZIP-Archivs kann so, wie er ist entpackt auf einem HTTP-Server wie z.B. [Tomcat](https://de.wikipedia.org/wiki/Apache_Tomcat) oder [lighttpd](https://de.wikipedia.org/wiki/Lighttpd) hinterlegt werden. Anschließend kann die App-Vorlage mit dem Uniform Resource Locator (URL), der sich aus ihrem Ablageort auf dem Server ergibt, im Webbrowser aufgerufen und ausgeführt werden. #### Add to Home Screen Die App-Vorlage schafft die Grundlage für Apps, die sich neben der universellen Ausführbarkeit in einem Webbrowser auch in einem Schritt auf einem Schlaufon oder Tafelrechner installieren und ausführen lassen, wie es gewöhnlich nur Apps aus dem App Store des Geräteherstellers erlauben. -Wird die App-Vorlage beispielsweise mit Safari auf einem iPhone oder iPad aufgerufen, kann mit folgenden Schritten die App dem Startbildschirm des Gerätes hinzugefügt werden: - -+ Schritte -+ hier -+ noch -+ aufzählen - -Anschließend ist die App durch einfaches Antippen ihres Piktogrammes direkt vom Startbildschirm ausführbar wie eine App aus dem App Store. Diese Vorgehensweise funktioniert in vergleichbarer Weise mit Chrome auf Android-Geräten. +Wird die App-Vorlage beispielsweise mit Safari auf einem iPhone oder iPad aufgerufen, kann die Funktion "zum Home-Bildschirm hinzufügen" verwendet werden. Anschließend ist die App durch einfaches Antippen ihres Piktogrammes direkt vom Startbildschirm ausführbar wie eine App aus dem App Store. Diese Vorgehensweise funktioniert in vergleichbarer Weise mit Chrome auf Android-Geräten. ## Abhängigkeiten -Damit der Code der App-Vorlage einfach geladen und so wie er ist ausprobiert werden kann sind folgende Abhängigkeiten aus dem Content Delivery Network [CDNJS](https://cdnjs.com/) eingebunden: +Die App-Vorlage verwendet [Mustache](https://mustache.github.io/) um Seitenvorlagen clientseitig zu HTML zu rendern. Damit der Code der App-Vorlage einfach geladen und so wie er ist ausprobiert werden kann ist Mustache aus dem Content Delivery Network [CDNJS](https://cdnjs.com/) eingebunden. Ferner ist der Zeichensatz [Roboto Condensed](https://fonts.google.com/specimen/Roboto+Condensed) aus [Google Fonts](https://fonts.google.com/) eingebaut. -+ [jQuery](https://jquery.com) -+ [Mustache](https://mustache.github.io/) - -Ferner ist folgender Zeichensätz aus [Google Fonts](https://fonts.google.com/) eingebunden - -+ [Roboto Condensed](https://fonts.google.com/specimen/Roboto+Condensed) - -Diese Abhängigkeiten sollten während dem produktiven Einsatz auf dem Server hinterlegt werden, von dem aus die App-Vorlage ausgeliefert wird und von dort eingebunden sein. +Diese Abhängigkeiten sollten von den angegebenen Quellen heruntergeladen und für einen produktiven Einsatz auf dem Server hinterlegt werden, von dem aus die App-Vorlage ausgeliefert wird. Von dort eingebunden führt die Verwendung dieser Zusätze nicht zu einem Ausbrechen aus dem eigenen Server. -- Gitblit v1.9.3