Mercurial > lada > lada-client
diff INSTALL.markdown @ 884:98d7a325f894
More Instructions: How to deal with libraries
author | Dustin Demuth <dustin@intevation.de> |
---|---|
date | Thu, 23 Jul 2015 11:56:04 +0200 |
parents | c63ecb95dffb |
children | 03f3ef7e480b |
line wrap: on
line diff
--- a/INSTALL.markdown Thu Jul 23 11:37:45 2015 +0200 +++ b/INSTALL.markdown Thu Jul 23 11:56:04 2015 +0200 @@ -33,15 +33,12 @@ Zur Installation werden Ruby und Java benötigt. - - - Der Befehl hierzu lautet: ``` - sencha --sdk $PATHTOEXT compile \ - --classpath=app,resources/datetime,resources/i18n page -str -cla lada.js \ - -yui -i index.html -o build/index.html + $PATHTOSENCHACMD --sdk-path $PATHTOEXTJS compile \ + --classpath=app,resources/lib/datetime,resources/lib/i18n page -str -cla lada.js \ + -yui -i index.html -o build/index.html ``` Das Verzeichnis `build` enthält dann eine Datei `index.html` und eine Datei @@ -54,9 +51,9 @@ |--------------------------------------------------------|-------------------------------------------------------------| | extjs/resources/css/ext-all-gray.css | build/extjs/resources/css/ext-all-gray.css | | extjs/resources/ext-theme-gray/ext-theme-gray-all.css | build/extjs/resources/ext-theme-gray/ext-theme-gray-all.css | -| resources/Lada.properties | build/resources/Lada.properties | -| resources/Lada_de-DE.properties | build/resources/Lada_de-DE.properties | -| gfx/* | build/gfx/ | +| resources/i18n/Lada.properties | build/resources/i18n/Lada.properties | +| resources/i18n/Lada_de-DE.properties | build/resources/i18n/Lada_de-DE.properties | +| resources/img/* | build/ressources/img* | ### Installation Apache @@ -97,6 +94,10 @@ Die Anwendung sollte nun bereits unter der Adresse `http://localhost/lada` erreichbar sein. +Damit die Anwendung vollständig funktiniert, müssen ggfs noch weitere +Bibliotheken hinzugefügt werden. +Dies wird im Abschnitt *Lizenzen und Bibliotheken* näher beschrieben + ### Konfiguration Proxy Server Damit der Client eine Verbindung zu dem Server aufbauen kann, um von dort @@ -131,3 +132,71 @@ Die Authentifizierung geschieht gegen einen OpenID-Server. Der Lada-Client leitet in Zusammenarbeit mit dem Server automatisch an diesen weiter. + +# Lizenzen und Bibliotheken + +Die Anwendung verwendet mehrere Unterkomponenten, diese sind typischerweise im +Ordner `resources` zu finden. + +Folgende Bibliotheken werden neben ExtJs verwendet: + + * Filesaver.js + https://github.com/eligrey/FileSaver.js + MIT - License + * Blob.js + https://github.com/eligrey/Blob.js + MIT - License + * Openlayers 2.13.1 + http://www.openlayers.org + https://github.com/openlayers/openlayers + 2-Clause BSD-License + * Ext.i18n.Bundle 0.3.3 (referenced as Ext.i18n in app.js) + https://github.com/elmasse/Ext.i18n.Bundle/tree/v0.3.3 + MIT - License + * Ext.ux.upload 1.1.1 + https://github.com/ivan-novakov/extjs-upload-widget/tree/1.1.1 + 3-Clause BSD-License + + +## Installation der Bibliotheken + +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 +oben angegeben wurde. + +``` +cd /var/www/html/lada/resources/ +mkdir lib/ +cd lib +wget https://github.com/eligrey/FileSaver.js/archive/master.zip -O FileSaver-js.zip +wget https://github.com/eligrey/Blob.js/archive/master.zip -O Blob-js.zip +wget https://github.com/openlayers/openlayers/archive/release-2.13.1.zip -O OpenLayers-2-13-1.zip +wget https://github.com/elmasse/Ext.i18n.Bundle/archive/v0.3.3.zip -O Ext-i18n-Bundle-v0-3-3.zip +wget https://github.com/ivan-novakov/extjs-upload-widget/archive/1.1.1.zip -O Ext-ux-Upload-1-1-1.zip +``` + +Die Dateien sind im Ordner `resources/lib/` zu entpacken + +``` +unzip FileSaver-js.zip +unzip Blob-js.zip +unzip OpenLayers-2-13-1.zip +unzip Ext-i18n-Bundle-v0-3-3.zip +unzip Ext-ux-Upload-1-1-1.zip +``` + +Zum einfacheren Zugriff auf die Bibliothek, symbolische Links erstellen. +Dies is praktisch wenn die Bibliothek ausgetauscht wird, +dann müssen die Quelltexte nicht angepasst werden + +``` +ln -s Blob.js-master Blob +ln -s FileSaver.js-master FileSaver +ln -s openlayers-release-2.13.1 OpenLayers +ln -s Ext.i18n.Bundle-0.3.3/i18n i18n +ln -s extjs-upload-widget-1.1.1/lib/upload upload +``` + +Somit ist die Installation der Bibliotheken abgeschlossen.