Mercurial > lada > lada-client

comparison INSTALL.markdown @ 884:98d7a325f894

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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
comparison
equal deleted inserted replaced
883:7fd43408a1df 884:98d7a325f894
31 [Dokumentation von ExtJs](http://docs.sencha.com/extjs/4.2.1/#!/guide/command) 31 [Dokumentation von ExtJs](http://docs.sencha.com/extjs/4.2.1/#!/guide/command)
32 32
33 Zur Installation werden Ruby und Java benötigt. 33 Zur Installation werden Ruby und Java benötigt.
34 34
35 35
36
37
38
39 Der Befehl hierzu lautet: 36 Der Befehl hierzu lautet:
40 37
41 ``` 38 ```
42 sencha --sdk $PATHTOEXT compile \ 39 $PATHTOSENCHACMD --sdk-path $PATHTOEXTJS compile \
43 --classpath=app,resources/datetime,resources/i18n page -str -cla lada.js \ 40 --classpath=app,resources/lib/datetime,resources/lib/i18n page -str -cla lada.js \
44 -yui -i index.html -o build/index.html 41 -yui -i index.html -o build/index.html
45 ``` 42 ```
46 43
47 Das Verzeichnis `build` enthält dann eine Datei `index.html` und eine Datei 44 Das Verzeichnis `build` enthält dann eine Datei `index.html` und eine Datei
48 `lada.js`. Die Datei `lada.js` ist eine komprimierte Version der Anwendung und 45 `lada.js`. Die Datei `lada.js` ist eine komprimierte Version der Anwendung und
49 enthält alle benötigten Klassen. 46 enthält alle benötigten Klassen.
52 49
53 | Quelldatei | Zieldatei | 50 | Quelldatei | Zieldatei |
54 |--------------------------------------------------------|-------------------------------------------------------------| 51 |--------------------------------------------------------|-------------------------------------------------------------|
55 | extjs/resources/css/ext-all-gray.css | build/extjs/resources/css/ext-all-gray.css | 52 | extjs/resources/css/ext-all-gray.css | build/extjs/resources/css/ext-all-gray.css |
56 | extjs/resources/ext-theme-gray/ext-theme-gray-all.css | build/extjs/resources/ext-theme-gray/ext-theme-gray-all.css | 53 | extjs/resources/ext-theme-gray/ext-theme-gray-all.css | build/extjs/resources/ext-theme-gray/ext-theme-gray-all.css |
57 | resources/Lada.properties | build/resources/Lada.properties | 54 | resources/i18n/Lada.properties | build/resources/i18n/Lada.properties |
58 | resources/Lada_de-DE.properties | build/resources/Lada_de-DE.properties | 55 | resources/i18n/Lada_de-DE.properties | build/resources/i18n/Lada_de-DE.properties |
59 | gfx/* | build/gfx/ | 56 | resources/img/* | build/ressources/img* |
60 57
61 58
62 ### Installation Apache 59 ### Installation Apache
63 Zunächst wird der Apache Webserver aus dem Repository installiert: 60 Zunächst wird der Apache Webserver aus dem Repository installiert:
64 61
94 restorecon -Rv /var/www/html/ 91 restorecon -Rv /var/www/html/
95 ``` 92 ```
96 93
97 Die Anwendung sollte nun bereits unter der Adresse `http://localhost/lada` 94 Die Anwendung sollte nun bereits unter der Adresse `http://localhost/lada`
98 erreichbar sein. 95 erreichbar sein.
96
97 Damit die Anwendung vollständig funktiniert, müssen ggfs noch weitere
98 Bibliotheken hinzugefügt werden.
99 Dies wird im Abschnitt *Lizenzen und Bibliotheken* näher beschrieben
99 100
100 ### Konfiguration Proxy Server 101 ### Konfiguration Proxy Server
101 102
102 Damit der Client eine Verbindung zu dem Server aufbauen kann, um von dort 103 Damit der Client eine Verbindung zu dem Server aufbauen kann, um von dort
103 Daten laden zu können, ist es notwendig den Server weiter zu konfigurieren. 104 Daten laden zu können, ist es notwendig den Server weiter zu konfigurieren.
129 ### Authentifizierung 130 ### Authentifizierung
130 131
131 Die Authentifizierung geschieht gegen einen OpenID-Server. 132 Die Authentifizierung geschieht gegen einen OpenID-Server.
132 133
133 Der Lada-Client leitet in Zusammenarbeit mit dem Server automatisch an diesen weiter. 134 Der Lada-Client leitet in Zusammenarbeit mit dem Server automatisch an diesen weiter.
135
136 # Lizenzen und Bibliotheken
137
138 Die Anwendung verwendet mehrere Unterkomponenten, diese sind typischerweise im
139 Ordner `resources` zu finden.
140
141 Folgende Bibliotheken werden neben ExtJs verwendet:
142
143 * Filesaver.js
144 https://github.com/eligrey/FileSaver.js
145 MIT - License
146 * Blob.js
147 https://github.com/eligrey/Blob.js
148 MIT - License
149 * Openlayers 2.13.1
150 http://www.openlayers.org
151 https://github.com/openlayers/openlayers
152 2-Clause BSD-License
153 * Ext.i18n.Bundle 0.3.3 (referenced as Ext.i18n in app.js)
154 https://github.com/elmasse/Ext.i18n.Bundle/tree/v0.3.3
155 MIT - License
156 * Ext.ux.upload 1.1.1
157 https://github.com/ivan-novakov/extjs-upload-widget/tree/1.1.1
158 3-Clause BSD-License
159
160
161 ## Installation der Bibliotheken
162
163 Die aufgeführten Bibliotheken können über den Link zu Github als zip-Datei
164 heruntergeladen werden.
165
166 Dabei ist auf die korrekte Versionnummer zu achten, falls dies in der Liste
167 oben angegeben wurde.
168
169 ```
170 cd /var/www/html/lada/resources/
171 mkdir lib/
172 cd lib
173 wget https://github.com/eligrey/FileSaver.js/archive/master.zip -O FileSaver-js.zip
174 wget https://github.com/eligrey/Blob.js/archive/master.zip -O Blob-js.zip
175 wget https://github.com/openlayers/openlayers/archive/release-2.13.1.zip -O OpenLayers-2-13-1.zip
176 wget https://github.com/elmasse/Ext.i18n.Bundle/archive/v0.3.3.zip -O Ext-i18n-Bundle-v0-3-3.zip
177 wget https://github.com/ivan-novakov/extjs-upload-widget/archive/1.1.1.zip -O Ext-ux-Upload-1-1-1.zip
178 ```
179
180 Die Dateien sind im Ordner `resources/lib/` zu entpacken
181
182 ```
183 unzip FileSaver-js.zip
184 unzip Blob-js.zip
185 unzip OpenLayers-2-13-1.zip
186 unzip Ext-i18n-Bundle-v0-3-3.zip
187 unzip Ext-ux-Upload-1-1-1.zip
188 ```
189
190 Zum einfacheren Zugriff auf die Bibliothek, symbolische Links erstellen.
191 Dies is praktisch wenn die Bibliothek ausgetauscht wird,
192 dann müssen die Quelltexte nicht angepasst werden
193
194 ```
195 ln -s Blob.js-master Blob
196 ln -s FileSaver.js-master FileSaver
197 ln -s openlayers-release-2.13.1 OpenLayers
198 ln -s Ext.i18n.Bundle-0.3.3/i18n i18n
199 ln -s extjs-upload-widget-1.1.1/lib/upload upload
200 ```
201
202 Somit ist die Installation der Bibliotheken abgeschlossen.
http://lada.wald.intevation.org