rrenkert@436: Lada-Client
rrenkert@436: ===========
torsten@469: Dies ist die Prototypversion eines EXTJS basierten Klienten für die
torsten@469: Verarbeitung von Labordaten (Lada) zur Überwachung der Umweltradioaktivität.
torsten@469: 
torsten@469: Die Software bietet grundlegende Funktionalität zur Erfassung und Bearbeitung
torsten@469: von Messdaten. Weitere Informationen finden sich auf der Projektwebseite unter
torsten@469: der Adresse:
torsten@469: 
torsten@469: 	https://wald.intevation.org/projects/lada/
torsten@469: 
torsten@469: Die Software entstand im Rahmen einer Software Entwicklung durch die
torsten@469: Intevation GmbH im Auftrag des Bundesamt für Strahlenschutz im Jahre 2013.
torsten@469: 
torsten@476: Kontakt
torsten@476: -------
torsten@476: Bundesamt für Strahlenschutz
torsten@476: SW2 Notfallschutz, Zentralstelle des Bundes (ZdB)
torsten@476: Willy-Brandt-Strasse 5
torsten@476: 38226 Salzgitter
torsten@476: info@bfs.de
torsten@476: 
torsten@469: Lizenz
torsten@469: ------
torsten@475: Die Software unter der GNU GPL v>=3 Lizenz verfügbar. Details siehe die Datei
torsten@475: COPYING.
torsten@469: 
torsten@475: Quelltext
torsten@475: ---------
torsten@469: Die Quelldateien lassen sich wie folgt auschecken:
torsten@469: hg clone https://scm.wald.intevation.org/hg/lada/lada-client
torsten@469: 
torsten@469: Dokumentation
torsten@469: -------------
torsten@469: Die Dokumentation wird mit dem Tool JSDuck erzeugt.
torsten@469: Im Wurzelordner lässt sich nach der Installation von JSDuck dann mit dem
torsten@469: Befehl "jsduck" die Dokumentation für den Lada-Clienten erzeugen.
torsten@469: Die Dokumentation findet sich nach der Generierung in dem Order "doc".
torsten@469: Einstiegseite ist die Seite template.html.
torsten@469: 
torsten@469: JSDuck ist unter der Adresse
torsten@469: 
torsten@469: https://github.com/senchalabs/jsduck
torsten@469: 
torsten@469: zu finden und muss installiert werden.
torsten@469: 
torsten@469: Einstellung bezüglich der Generierung der Dokumentation ist in der Datei
torsten@469: jsduck.json hinterlegt.
rrenkert@436: 
rrenkert@436: Entwicklung
rrenkert@436: -----------
rrenkert@436: Für die Entwicklung ist es notwenig in dem Wurzelordner die ExtJS-Bibliothek
rrenkert@436: in der Version >=4.2.0 unter dem Namen "extjs" zur Verfügung zu stellen.
torsten@27: 
torsten@27: Diese lässt sich unter der folgenden URL herunterladen:
torsten@27: http://cdn.sencha.com/ext/gpl/ext-4.2.0-gpl.zip
torsten@27: 
torsten@27: SHA1 Checksum: 2ce990d9e90c48a76078e8533c72b5452f9ed809
torsten@27: 
torsten@27: Beispiel:
torsten@27: curl -O http://cdn.sencha.com/ext/gpl/ext-4.2.0-gpl.zip
torsten@27: unzip ext-4.2.0-gpl.zip
torsten@27: ln -s ext-4.2.0-gpl extjs
torsten@340: 
rrenkert@436: Zusätzlich wird für diese Anwendung eine Bibliothek zur Internationalisierung
rrenkert@436: verwendet, die unter der URL
rrenkert@436: 
rrenkert@436: https://github.com/elmasse/Ext.i18n.Bundle
rrenkert@436: 
rrenkert@436: verfügbar ist, verwendet.
raimund@501: Der darin enthaltene Ordner 'i18n' muss in dem Ordner 'resources' der Anwendung
raimund@501: eingebunden werden. Dazu wird der Ordner 'i18n' in den Ordner 'resources' kopiert
rrenkert@436: oder verlinkt.
rrenkert@436: 
torsten@469: Build
torsten@469: -----
rrenkert@436: Die Anwendung wird mit Hilfe des von Sencha bereitgestellten Tools 'Sencha Cmd'
rrenkert@436: compiliert und minifiziert. Vorbedingung für den Compilevorgang ist die unter
rrenkert@436: Entwicklung beschriebene Verzeichnisstruktur.
rrenkert@436: 
rrenkert@436: Sencha Cmd kann unter der URL
rrenkert@436: 
rrenkert@436: http://www.sencha.com/products/sencha-cmd/download
rrenkert@436: 
rrenkert@436: heruntergeladen und dann installiert werden.
rrenkert@436: 
rrenkert@436: Mit dem folgenden Befehl kann dann der Lada-Client compiliert und minifiziert werden:
rrenkert@436: 
rrenkert@436: sencha -sdk /path/to/extjs compile \
rrenkert@436:        -classpath=app,app/view/widgets/resources/datetime page -yui \
rrenkert@436:        -in index.html -out build/index.html
rrenkert@436: 
rrenkert@436: Dies erzeugt in dem Ordner 'build' die minifizierte Version der Anwendung, die
rrenkert@436: alle benötigten Klassen der ExtJS Bibliothek beinhaltet und eine entsprechende
rrenkert@436: index.html, die zur Auslieferung in einem Webserver verwendet werden kann.
rrenkert@436: 
torsten@469: Installation
torsten@469: ------------
torsten@476: Für Informationen zur Installation schauen Sie in die INSTALL Datei.