changeset 897:44e970cec920

Moved README to a markdown file, fixed typos in INSTALL.markdown
author Dustin Demuth <dustin@intevation.de>
date Fri, 24 Jul 2015 11:04:40 +0200
parents 237bca579fc7
children 3bfe2ec133e9
files INSTALL.markdown README README.markdown
diffstat 3 files changed, 101 insertions(+), 116 deletions(-) [+]
line wrap: on
line diff
--- a/INSTALL.markdown	Thu Jul 23 17:43:06 2015 +0200
+++ b/INSTALL.markdown	Fri Jul 24 11:04:40 2015 +0200
@@ -11,19 +11,19 @@
 Hinweis: Für den Betrieb einer vollständigen Installation ist neben dem
 Klienten auch die Installation eines Servers und entsprechender Datenbank
 notwendig. Für die Installation des Servers folgen Sie bitte den Hinweisen in
-der README Datei des Server-Pakets. Siehe Projektwebseite. Optional: Die
-Authentifizierung kann gegen einen LDAP-Server durchgeführt werden. Beispiele
-finde sich in dem Installationbeispiel.
+der README Datei des Server-Pakets.
+Weitere Information finden Sie auf der Projektwebseite:
+http://wald.intevation.org/projects/lada
 
 Die folgenden Hinweise beziehen sich auf die Installation und Einrichtung auf
 Basis eines Oracle-RedHat Linux Systems.
 
-Der Lada-Client ist eine Anwendung die auf dem Framework extJs 4.2.1 basiert,
-Damit der Client funktiniert müssen Sie dieses Framework herunterladen und
+Der Lada-Client ist eine Anwendung die auf dem Framework ExtJs 4.2.1 basiert,
+Damit der Client funktioniert müssen Sie dieses Framework herunterladen und
 entpacken. Dies kann direkt in das root-Verzeichnis des Lada-Clients geschehen.
 
 Für Applikationen die ebenfalls unter der GPL lizenziert wird - so wie der Lada
-Client - kann extJs als [GPL Version heruntergeladen](http://cdn.sencha.com/ext/gpl/ext-4.2.1-gpl.zip)
+Client - kann ExtJs als [GPL Version heruntergeladen](http://cdn.sencha.com/ext/gpl/ext-4.2.1-gpl.zip)
 werden.
 
 Legen Sie nach dem Entpacken einen Symlink auf dieses Verzeichnis an:
@@ -36,7 +36,8 @@
 
 Zum Kompilieren der Anwendung kommt das Tool Sencha Cmd 4.0.x zum Einsatz.
 Mit Hilfe dieses Tools kann der Quellcode in eine einzelne Datei zusammengefasst
-und minifiziert werden. Dies beschleunigt das Laden der Anwendung im Browser erheblich
+und minifiziert werden. Dies beschleunigt das Laden der Anwendung im Browser
+erheblich
 
 Sencha bietet Sencha Cmd zum [Download](https://www.sencha.com/products/extjs/cmd-download/) 
 an. Beachten Sie: Sencha Cmd ist keine freie Software.
@@ -59,7 +60,7 @@
 ```
 
 Ersetzen Sie heirbei `$PATHTOSENCHACMD` mit dem Pfad zu Ihrer Installation von
-Sencha Cmd. $PATHTOEXTJS gibt den Pfad an, an dem sich Ihre Kopie von extJs
+Sencha Cmd. $PATHTOEXTJS gibt den Pfad an, an dem sich Ihre Kopie von ExtJs
 befindet.
 
 
@@ -79,8 +80,9 @@
 | resources/lib/* (alles ausser ext Ordner)              | build/resources/lib                                         |
 
 
-Um OpenLayers als "Single File" Version bereit zu haben, gehen Sie in das Verzeichnis
-`build/resources/lib/OpenLayers` und führen Sie den folgenden Befehl aus:
+Um OpenLayers als "Single File" Version bereit zu haben, gehen Sie in das
+Verzeichnis `build/resources/lib/OpenLayers` und führen Sie den folgenden Befehl
+aus:
 
 ```
 python build.py
@@ -104,7 +106,7 @@
 der Option `LoadModule` angegeben. Folgende Module werden benötigt:
 
     * headers_module: Setzten der Header nach der Authentifizierung
-    * proxy_module: Reverse Proxy des Apache zum Jboss-Server
+    * proxy_module: Reverse Proxy des Apache zum Lada-Server
 
 ### Einrichtung der Anwendung
 
@@ -153,15 +155,18 @@
         CustomLog logs/lada-access_log common
 
         # Set multiple Proxys
-        ProxyPass /lada/server http://localhost:8080/lada
-        ProxyPassReverse /lada/server http://localhost:8080/lada
+        ProxyPass /lada/server http://LADASERVER/lada
+        ProxyPassReverse /lada/server http://LADASERVER/lada
     </VirtualHost>
 ```
-Alle Anfragen an die Adresse `/lada/service`, werden nun an den Server weitergeleitet.
+Alle Anfragen an die Adresse `/lada/service`, werden nun an den Server
+weitergeleitet.
 
 ### Authentifizierung
 
-Die Authentifizierung geschieht gegen einen OpenID-Server.
+Die Authentifizierung geschieht derzeit gegen einen OpenID-Server.
+Früher Ansätze nutzten LDAP, in Zukunft soll auch Authentifizierung via SAML2
+möglich sein.
 
 Der Lada-Client leitet in Zusammenarbeit mit dem Server automatisch an diesen weiter.
 
@@ -202,7 +207,7 @@
 Die aufgeführten Bibliotheken können über den Link zu Github als zip-Datei
 heruntergeladen werden.
 
-Dabei ist auf die korrekte Versionnummer zu achten, falls dies in der Liste
+Dabei ist auf die korrekte Versionsnummer zu achten, falls dies in der Liste
 oben angegeben wurde.
 
 ```
@@ -233,7 +238,7 @@
 ```
 
 Zum einfacheren Zugriff auf die Bibliothek, symbolische Links erstellen.
-Dies is praktisch wenn die Bibliothek ausgetauscht wird,
+Dies ist praktisch wenn die Bibliothek ausgetauscht wird,
 dann müssen die Quelltexte nicht angepasst werden
 
 ```
--- a/README	Thu Jul 23 17:43:06 2015 +0200
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,99 +0,0 @@
-Lada-Client
-===========
-Dies ist die Prototypversion eines EXTJS basierten Klienten für die
-Verarbeitung von Labordaten (Lada) zur Überwachung der Umweltradioaktivität.
-
-Die Software bietet grundlegende Funktionalität zur Erfassung und Bearbeitung
-von Messdaten. Weitere Informationen finden sich auf der Projektwebseite unter
-der Adresse:
-
-	https://wald.intevation.org/projects/lada/
-
-Die Software entstand im Rahmen einer Software Entwicklung durch die
-Intevation GmbH im Auftrag des Bundesamt für Strahlenschutz im Jahre 2013.
-
-Kontakt
--------
-Bundesamt für Strahlenschutz
-SW2 Notfallschutz, Zentralstelle des Bundes (ZdB)
-Willy-Brandt-Strasse 5
-38226 Salzgitter
-info@bfs.de
-
-Lizenz
-------
-Die Software unter der GNU GPL v>=3 Lizenz verfügbar. Details siehe die Datei
-COPYING.
-
-Quelltext
----------
-Die Quelldateien lassen sich wie folgt auschecken:
-hg clone https://scm.wald.intevation.org/hg/lada/lada-client
-
-Dokumentation
--------------
-Die Dokumentation wird mit dem Tool JSDuck erzeugt.
-Im Wurzelordner lässt sich nach der Installation von JSDuck dann mit dem
-Befehl "jsduck" die Dokumentation für den Lada-Clienten erzeugen.
-Die Dokumentation findet sich nach der Generierung in dem Order "doc".
-Einstiegseite ist die Seite template.html.
-
-JSDuck ist unter der Adresse
-
-https://github.com/senchalabs/jsduck
-
-zu finden und muss installiert werden.
-
-Einstellung bezüglich der Generierung der Dokumentation ist in der Datei
-jsduck.json hinterlegt.
-
-Entwicklung
------------
-Für die Entwicklung ist es notwenig in dem Wurzelordner die ExtJS-Bibliothek
-in der Version >=4.2.0 unter dem Namen "extjs" zur Verfügung zu stellen.
-
-Diese lässt sich unter der folgenden URL herunterladen:
-http://cdn.sencha.com/ext/gpl/ext-4.2.0-gpl.zip
-
-SHA1 Checksum: 2ce990d9e90c48a76078e8533c72b5452f9ed809
-
-Beispiel:
-curl -O http://cdn.sencha.com/ext/gpl/ext-4.2.0-gpl.zip
-unzip ext-4.2.0-gpl.zip
-ln -s ext-4.2.0-gpl extjs
-
-Zusätzlich wird für diese Anwendung eine Bibliothek zur Internationalisierung
-verwendet, die unter der URL
-
-https://github.com/elmasse/Ext.i18n.Bundle
-
-verfügbar ist, verwendet.
-Der darin enthaltene Ordner 'i18n' muss in dem Ordner 'resources' der Anwendung
-eingebunden werden. Dazu wird der Ordner 'i18n' in den Ordner 'resources' kopiert
-oder verlinkt.
-
-Build
------
-Die Anwendung wird mit Hilfe des von Sencha bereitgestellten Tools 'Sencha Cmd'
-compiliert und minifiziert. Vorbedingung für den Compilevorgang ist die unter
-Entwicklung beschriebene Verzeichnisstruktur.
-
-Sencha Cmd kann unter der URL
-
-http://www.sencha.com/products/sencha-cmd/download
-
-heruntergeladen und dann installiert werden.
-
-Mit dem folgenden Befehl kann dann der Lada-Client compiliert und minifiziert werden:
-
-sencha -sdk /path/to/extjs compile \
-       -classpath=app,app/view/widgets/resources/datetime page -yui \
-       -in index.html -out build/index.html
-
-Dies erzeugt in dem Ordner 'build' die minifizierte Version der Anwendung, die
-alle benötigten Klassen der ExtJS Bibliothek beinhaltet und eine entsprechende
-index.html, die zur Auslieferung in einem Webserver verwendet werden kann.
-
-Installation
-------------
-Für Informationen zur Installation schauen Sie in die INSTALL Datei.
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README.markdown	Fri Jul 24 11:04:40 2015 +0200
@@ -0,0 +1,79 @@
+Lada-Client
+===========
+Dies ist eine Kopie des ExtJS basierten Klienten für die
+Verarbeitung von Labordaten (Lada) zur Überwachung der Umweltradioaktivität.
+
+Die Software bietet Funktionalität zur Erfassung und Bearbeitung
+von Messdaten. Sowie der Planung der Messungen.
+
+Weitere Informationen finden sich auf der Projektwebseite unter
+der Adresse: https://wald.intevation.org/projects/lada/
+
+Die Software entstand im Rahmen einer Software Entwicklung durch die
+Intevation GmbH im Auftrag des Bundesamt für Strahlenschutz in den Jahren 2013
+bis 2015.
+
+Kontakt
+-------
+Bundesamt für Strahlenschutz
+SW2 Notfallschutz, Zentralstelle des Bundes (ZdB)
+Willy-Brandt-Strasse 5
+38226 Salzgitter
+info@bfs.de
+
+Lizenz
+------
+Die Software ist unter der GNU GPL v>=3 Lizenz verfügbar.
+Details siehe die Datei `COPYING`.
+
+Quelltext
+---------
+Die Quelldateien lassen sich wie folgt auschecken:
+```
+hg clone https://scm.wald.intevation.org/hg/lada/lada-client
+```
+
+Dokumentation
+-------------
+Die Dokumentation wird mit dem Tool JSDuck erzeugt.
+Im Wurzelordner lässt sich nach der Installation von JSDuck dann mit dem
+Befehl `jsduck` die Dokumentation für den Lada-Klienten erzeugen.
+Die Dokumentation findet sich nach der Generierung in dem Order `doc`.
+Einstiegsseite ist die Seite `template.html`.
+Sollte die Dokumentation mit einem Webserver ausgeliefert werden auf dem
+PHP installiert ist, kann auch die `index.php` verwendet werden.
+
+JSDuck ist unter der Adresse https://github.com/senchalabs/jsduck
+zu finden und muss installiert werden.
+
+Einstellungen bezüglich der Generierung der Dokumentation sind in der Datei
+`jsduck.json` hinterlegt.
+
+Entwicklung
+-----------
+Für die Entwicklung ist es notwendig in dem Wurzelordner die ExtJS-Bibliothek
+in der Version >=4.2.0 unter dem Namen "extjs" zur Verfügung zu stellen.
+
+Näheres dazu in der Datei `INSTALL.markdown`.
+
+Zusätzlich werden für diese Anwendung weitere externe Bibliotheken, bspw. zur
+Internationalisierung verwendet. Auch diese und deren Installation
+sind in der o.g. Datei beschrieben.
+
+
+Build
+-----
+Die Anwendung wird mit Hilfe des von Sencha bereitgestellten Tools 'Sencha Cmd'
+kompiliert und minifiziert. Vorbedingung für den Compilevorgang ist die in der
+Datei `INSTALL.markdown` beschriebene Verzeichnisstruktur.
+
+Der Build erzeugt in dem Ordner 'build' die minifizierte Version der Anwendung,
+welche alle benötigten Klassen der ExtJS Bibliothek beinhaltet, sowie eine
+entsprechende index.html, die zur Auslieferung in einem Webserver verwendet
+werden kann. Externe Bibliotheken, Grafiken und CSS Dateien sind jedoch nicht
+inkludiert und müssen händisch hinzugefügt werden. Auch diese sind in der Datei
+`INSTALL.markdown` beschrieben.
+
+Installation
+------------
+Für Informationen zur Installation schauen Sie in die `INSTALL.markdown` Datei.

http://lada.wald.intevation.org