This is an automated email from the git hooks/post-receive script. New commit to branch develop in repository echobase. See http://git.codelutin.com/echobase.git commit e4b3ea25af51726c188f7ccee4e403ab668056cf Author: Tony CHEMIT <chemit@codelutin.com> Date: Mon Dec 8 17:56:37 2014 +0100 refs #4194 (revue de la doc) --- src/site/rst/gis.rst | 100 ++++++++++++++++++++++++++++++++++ src/site/rst/install.rst.vm | 129 ++++++++------------------------------------ src/site/site_fr.xml | 1 + 3 files changed, 122 insertions(+), 108 deletions(-) diff --git a/src/site/rst/gis.rst b/src/site/rst/gis.rst new file mode 100644 index 0000000..b50e820 --- /dev/null +++ b/src/site/rst/gis.rst @@ -0,0 +1,100 @@ +.. - +.. * #%L +.. * EchoBase +.. * +.. * $Id$ +.. * $HeadURL$ +.. * %% +.. * Copyright (C) 2011 Ifremer, Codelutin +.. * %% +.. * This program is free software: you can redistribute it and/or modify +.. * it under the terms of the GNU Affero General Public License as published by +.. * the Free Software Foundation, either version 3 of the License, or +.. * (at your option) any later version. +.. * +.. * This program is distributed in the hope that it will be useful, +.. * but WITHOUT ANY WARRANTY; without even the implied warranty of +.. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.. * GNU General Public License for more details. +.. * +.. * You should have received a copy of the GNU Affero General Public License +.. * along with this program. If not, see <http://www.gnu.org/licenses/>. +.. * #L% +.. - + +============================ +Echobase - Visualisation Gis +============================ + +Comment ça marche ? +------------------- + +La solution technique pour visualiser les données spatialisées dans EchoBase s'appuie sur QGis map server et Lizmap. + +Nous expliquons dans cette page comment ça fonctionne. + +Organisation physique +~~~~~~~~~~~~~~~~~~~~~ + +Tous les fichiers utilisés sont placées + +:: + + /var/local/echobase/ + |-- data + | |-- ... + | `-- lizmap + | |-- resources (1. ressources utilisées par le projet QGis et lizmap) + | | |-- France&Spain.shp + | | |-- pelgas09.shp + | | `-- ... + | |-- projects (2. les projets lizmap generés) + | `-- templates (3. les templates pour générer les projets lizmap) + | |-- QgisTemplate.qgs + | |-- LizmapTemplate.qgs.cfg + | `-- ... + |-- echobase.war + `-- war + `-- echobase-full-${project.version}.war + +Répertoire resources +~~~~~~~~~~~~~~~~~~~~ + +Ce répertoire contient les différentes ressources utilisés par le projet QGis. + +Son contenu est rempli au démarrage de l'application. + +Répertoire templates +~~~~~~~~~~~~~~~~~~~~ + +Ce répertoire contient les templates utilisées pour générer les projets lizmap associés à une base et à une campagne. + +Son contenu est rempli au démarrage de l'application. + +Plus précisement deux fichiers sont utilisés : + + * **QgisTemplate.qgs** est la template du project Qgis + * **LizmapTemplate.qgs.cfg** est généré par le plugin lizmap de Qgis. + +Ces deux fichiers sont paramétrables, chaque paramètre est identifié entre une double accolade (par exemple **{{dbName}}**). + +Voici la liste exhaustive des paramètres possibles : + + * *{{dbName}}* : le nom de la base de données, + * *{{host}}* : l'adresse du serveur de base de données, + * *{{port}}* : le port d'écoute de la base de données, + * *{{userName}}* : l'identitfiant de connexion à la base de données, + * *{{password}}* : le mot de passe de connexion à la base de données, + * *{{voyageName}}* : le nom de la campagne, + * *{{voyageId}}* : l'identifiant technique de la campagne, + * *{{resourcesPath}}* : le chemin du répertoire des ressources. + +Répertoire projects +~~~~~~~~~~~~~~~~~~~ + +Ce répertoire contient les projets lizmap générés par l'application. + +Chaque fichier correspond à une campagne d'une base de donné. + +Les fichiers sont générés à la demande de l'utilisateur (s'ils n'existent pas) lors d'une demande de visualisation +des données spatialisées d'une campagne. \ No newline at end of file diff --git a/src/site/rst/install.rst.vm b/src/site/rst/install.rst.vm index 17ed1ee..529b579 100644 --- a/src/site/rst/install.rst.vm +++ b/src/site/rst/install.rst.vm @@ -43,34 +43,9 @@ Installation de postgresql et postgis ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Il vous faudra peut-être installer un dépot apt pour postgres -(voir https://wiki.postgresql.org/wiki/Apt) +(voir https://wiki.postgresql.org/wiki/Apt). -Pour postgresql 9.0 - -:: - - sudo apt-get install postgresql-9.0 - sudo apt-get install postgresql-9.0-postgis-2.1 - sudo apt-get install postgresql-9.0-postgis-2.1-scripts - -Pour postgresql 9.1 - -:: - - sudo apt-get install postgresql-9.1 - sudo apt-get install postgresql-9.1-postgis-2.1 - sudo apt-get install postgresql-9.1-postgis-2.1-scripts - - -Pour postgresql 9.2 - -:: - - sudo apt-get install postgresql-9.2 - sudo apt-get install postgresql-9.2-postgis-2.1 - sudo apt-get install postgresql-9.2-postgis-2.1-scripts - -Pour postgresql 9.3 +L'application requière l'utilisation de postgresql 9.3 (et postgis 2.1). :: @@ -135,9 +110,9 @@ Une fois l'application déployée, vous aurez la structure de répertoires suiva | |-- internaldb | | |-- echobase-user.h2.db | |-- lib - | | |-- echobase-embedded-2.3-SNAPSHOT.war - | | |-- h2-1.3.173.jar - | | `-- postgresql-9.1-901-1.jdbc4.jar + | | |-- echobase-embedded-${project.version}.war + | | |-- h2-${h2Version}.jar + | | `-- postgresql-${postgresqlVersion}.jar | |-- logs | | `-- echobase.log | `-- lizmap @@ -152,7 +127,7 @@ Une fois l'application déployée, vous aurez la structure de répertoires suiva | `-- ... |-- echobase.war `-- war - `-- echobase-full-${project.version}-SNAPSHOT.war + `-- echobase-full-${project.version}.war Mettre à jour le war de l'application @@ -227,94 +202,32 @@ Deux utilisateurs sont créés si la base est vide (première utilisation):: Pour des raisons de sécurité, il est conseillé de modifier le mot de passe via l'interface de gestion des utilisateurs. -.. _créer une base travail: ./db.html#creation-d-une-base-postgresql -.. _détail des options disponibles: ./application-config-report.html - - -Visualisation des données spatiales ------------------------------------ +Visualisation des données spatialisées +-------------------------------------- +EchoBase utilise `Qgis map server`_ et `Lizmap`_ pour la visualisation des données spatialisées (depuis la version 2.7). Qgis map server ~~~~~~~~~~~~~~~ -Suivez `le guide de Qgis map server <http://hub.qgis.org/projects/quantum-gis/wiki/QGIS_Server_Tutorial#Webserver-configuration>`_. +Pour installer Qgis map server, suivez `le guide d'installation Qgis map server <http://hub.qgis.org/projects/quantum-gis/wiki/QGIS_Server_Tutorial#Webserver-configuration>`_. Lizmap ~~~~~~ -Suivez `le guide de lizmap <http://docs.3liz.com/fr/lizmap-web-client/installation/linux.html>`_. +Pour installer Lizmap, suivez `le guide d'installation Lizmap <http://docs.3liz.com/fr/lizmap-web-client/installation/linux.html>`_. +Il faut ensuite installer le style adapté pour EchoBase. -Configuration pour Echobase -~~~~~~~~~~~~~~~~~~~~~~~~~~~ +1. Télécharger le fichier **echobase-lizmap-${project.version}.zip** sur le forge (https://forge.codelutin.com/projects/echobase/files) +2. Extraire ce fichier dans le répertoire d'installation de lizmap (par défaut **/var/www/lizmap-web-client-xxx/lizmap/**). - 1. Répetoires +Configuration des répertoires +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - * **/var/local/echobase/data/lizmap/templates** contient deux fichiers de modèles : +Il est possible de modifier la configuration de ces différents répertoires dans la configuration (voir le `détail des options disponibles`_). - * **QgisTemplate.qgs** est le fichier de project Qgis - * **LizmapTemplate.qgs.cfg** est généré par le plugin lizmap de Qgis. - - Dans ses fichiers, les références à la base de données, au voyage et aux resources externes sont remplacer par des balises suivantes : - - * *{{dbName}}* : le nom de la base de données, - * *{{host}}* : l'adresse du serveur de base, - * *{{port}}* : le port d'écoute de la base, - * *{{userName}}* : le identitfiant de connexion, - * *{{password}}* : le mot de passe, - * *{{voyageName}}* : le label du voyage, - * *{{voyageId}}* : l'identifiant du voyage, - * *{{resourcesPath}}* : le chemin du répertoire des ressources. - - - .. Attention:: - Deux fichiers Qgis ne doivent pas avoir des claques avec le même identifiant. Il faut donc ajouter à leurs valeurs l'indentifiant du voyage. - - * **QgisTemplate.qgs** - :: - - <qgis projectname="{{voyagenName}}" version="2.2.0-Valmiera"> - <title>{{voyageName}}</title> - <relations/> - <mapcanvas> ... </mapcanvas> - <legend updateDrawingOrder="true" activeLayer="country{{voyageId}}"> - <legendlayer drawingOrder="-1" open="true" checked="Qt::Checked" name="Country" showFeatureCount="0"> - <filegroup open="true" hidden="false"> - <legendlayerfile isInOverview="0" layerid="country{{voyageId}}" visible="1"/> - </filegroup> - </legendlayer> - ... - </legend> - <projectlayers layercount="15"> - <maplayer ...> - <id>country{{voyageId}}</id> - ... - - * **LizmapTemplate.qgs.cfg** - :: - - { - "layers": { - "country": { - ... - "id": "country{{voyageId}}", - ... - - * **/var/local/echobase/data/lizmap/resources** contient les fichiers de données utiles aux fichiers Qgis - - * **/var/local/echobase/data/lizmap/projects** répertoire de dépôt des fichiers de modèles une fois adaptés à une base de donnée et à un voyage. - - - Ces répetoires et fichiers sont définis par les propriétées : - - * echobase.qgis.template.file : le modèle du fichier Qgis - * echobase.qgis.resources.file : le répertoire de ressources des fichiers Qgis - * echobase.lizmap.template.file : le modièle du fichier de configuration de Lizmap - * echobase.lizmap.projects.file : le répertoire de dépôt des fichiers Qgis et Lizmap - - 2. Configuration de Lizmap - - Pour utiliser le style du portail Echobase et non le style par defaut de Lizmap, - vous devez extraire les fichier **echobase-lizmap-XX.XX.zip** dans le répertoire d'installation de Lizmap. - (par défaut : **/var/www/lizmap-web-client-X.X.X/lizmap/** ) +.. _créer une base travail: ./db.html#creation-d-une-base-postgresql +.. _détail des options disponibles: ./config-report.html +.. _Qgis map server: http://hub.qgis.org/projects/quantum-gis/wiki/QGIS_Server_Tutorial +.. _Lizmap: http://www.3liz.com/lizmap.html \ No newline at end of file diff --git a/src/site/site_fr.xml b/src/site/site_fr.xml index 12027bb..2bd2e26 100644 --- a/src/site/site_fr.xml +++ b/src/site/site_fr.xml @@ -97,6 +97,7 @@ <menu name="Dev"> <item name="Modèle" href="model.html"/> + <item name="Visualisation Gis" href="gis.html"/> <item name="Roadmap" href="https://forge.codelutin.com/projects/echobase/roadmap"/> <item name="Historique des versions" href="changes-report.html"/> </menu> -- To stop receiving notification emails like this one, please contact codelutin.com SCM administrator <admin+scm@codelutin.com>.