Merge pull request #147 from georchestra/documentation

Update of the doc page for the 3 languages

Author: pierrejego

_includes/card_doc_tool.html

@@ -0,0 +1,9 @@
+<div class="col-md-4 col-sm-12 p-0 mb-1">
+    <a class="card-tool-doc" href="{{ include.site_url }}" target="_blank">
+        <img class="rounded-1 me-3" src="{{ include.img_url }}" alt="Icône {{ include.name }}" style="width: 3em;">
+        <div>
+            <h4>{{ include.name }}</h4>
+            <p>{{ include.text }}</p>
+        </div>
+    </a>
+</div>

css/georchestra-theme.css

@@ -10394,4 +10394,35 @@ a.nav-link {
 
 #cardPresentation img {
     display: none;
+}
+
+/* Documentation > card tool */
+.card-tool-doc {
+    display: flex;
+    background-color: var(--bs-gray-100);
+    color: #495057!important;
+    align-items: center;
+    flex-direction: row;
+    flex-wrap: nowrap;
+    align-content: center;
+    justify-content: flex-start;
+    padding: 1em;
+    border-radius: 0.3em;
+    text-decoration: none;
+    margin: 0 0.5em 0.5em 0;
+    height: 100%;
+}
+
+.card-tool-doc:hover {
+    text-decoration: none;
+    background-color: #cea0cb26;
+}
+
+.card-tool-doc p{
+    line-height:1.1;
+    margin:0;
+}
+
+.card-tool-doc h4{    
+    margin: 0 0 5px 0;
 }

documentation.md

@@ -6,19 +6,41 @@ uid: documentation
 permalink: /documentation.html
 ---
 
-The installation and configuration documentation is now part of the [source repository](https://github.com/georchestra/georchestra/).  
-Please refer to the [README](https://github.com/georchestra/georchestra/blob/master/README.md) and explore the links.
+<p class="lead">
+    From this page you can access the installation and user documentation for the geOrchestra platform.
+</p>
 
-The **reference manuals** of the underlying standalone modules are also valuable sources of information:
+<div class="row py-2 d-flex align-items-stretch">
+    {% include card_doc_tool.html img_url="/favicon.ico" name="geOrchestra" text="Installation guide" site_url="https://github.com/georchestra/georchestra/blob/master/docs/index.md" %}   
+</div>
 
- * on the [GeoServer website](https://docs.geoserver.org/maintain/en/user/) for the 2.20 version,
- * on the [GeoNetwork website](https://www.geonetwork-opensource.org/manuals/4.0.x/en/) for the 4 version,
- * on the [GeoWebCache website](https://www.geowebcache.org/docs/current/index.html) for the 1.16 version.
+## The different components of geOrchestra
 
-## OID registry
+### View
+<div class="row py-2 d-flex align-items-stretch">
+    {% include card_doc_tool.html img_url="/public/icons/mapstore_icon.svg" name="MapStore2" text="An advanced geographic data viewer" site_url="https://docs.georchestra.org/mapstore2/" %}
+    {% include card_doc_tool.html img_url="/public/icons/datafeeder_icon.svg" name="Land registry plugin" text="A plugin for land registry consultation" site_url="https://docs.georchestra.org/cadastrapp/" %}
+    {% include card_doc_tool.html img_url="/public/icons/mapstore_icon.svg" name="Mviewer" text="A geographic data viewer for the public" site_url="https://mviewerdoc.readthedocs.io/fr/latest/" %}
+    {% include card_doc_tool.html img_url="/public/icons/datafeeder_icon.svg" name="Urban planning plugin" text="A plugin for consulting planning documents" site_url="https://docs.georchestra.org/mapstore2-urbanisme/fr/latest/" %}    
+</div>
 
-The geOrchestra project [has been assigned](https://www.iana.org/assignments/enterprise-numbers/enterprise-numbers)
-an Object Identifier (OID): `1.3.6.1.4.1.53611`. It is particularly useful to
-manage custom LDAP objects specific to geOrchestra. Below this root OID, the
-geOrchestra community maintains its own
-[OID registry]({{ site.baseurl }}{% link oid.md %}).
+### Supply
+<div class="row py-2 d-flex align-items-stretch">
+    {% include card_doc_tool.html img_url="/public/icons/datafeeder_icon.svg" name="Datafeeder" text="A data integration wizard" site_url="https://georchestra-user-guide.readthedocs.io/en/latest/setup/datafeeder/" %}   
+</div>
+
+### Publish
+<div class="row py-2 d-flex align-items-stretch">
+    {% include card_doc_tool.html img_url="/public/icons/geonetwork_icon.svg" name="GeoNetwork" text="A metadata catalogue" site_url="https://geonetwork-opensource.org/manuals/3.12.x/fr/" %}
+    {% include card_doc_tool.html img_url="/public/icons/datafeeder_icon.svg" name="GeoServer" text="A powerful geographic data server that complies with OGC WxS standards" site_url="https://docs.geoserver.org/stable/en/user/" %}
+    {% include card_doc_tool.html img_url="/public/icons/geowebcache_icon.svg" name="GeoWebCache" text="A tile server" site_url="https://www.osgeo.org/projects/geowebcache/" %}
+    {% include card_doc_tool.html img_url="/public/icons/geowebcache_icon.svg" name="Data API" text="An open data API complying with the new OGC 'Features API' standards" site_url="https://github.com/georchestra/data-api" %}        
+</div>
+
+### Manage
+<div class="row py-2 d-flex align-items-stretch">
+    {% include card_doc_tool.html img_url="/public/icons/geofence_icon.svg" name="GeoFence" text="A module for advanced management of data access rights" site_url="https://github.com/NielsCharlier/geofence" %}
+    {% include card_doc_tool.html img_url="/public/icons/ldapadmin_icon.svg" name="Console" text="An administration console for users, roles and organisations" site_url="https://github.com/georchestra/georchestra/tree/master/console" %}
+    {% include card_doc_tool.html img_url="/public/icons/analytics_icon.svg" name="Analytics" text="A module presenting statistics on use of the platform" site_url="https://github.com/georchestra/analytics" %}  
+    {% include card_doc_tool.html img_url="/public/icons/ldapadmin_icon.svg" name="Mviewer Studio" text="An mviewer application generator" site_url="https://mviewerstudio.readthedocs.io/fr/stable/index.html" %}   
+</div>

es/documentacion.md

@@ -6,19 +6,42 @@ uid: documentation
 permalink: /es/documentacion.html
 ---
 
-La documentación de la instalación y configuratión es ahora parte del repositorio de [código fuente](https://github.com/georchestra/georchestra/), en idioma Inglés.
-Puede acceder a ella desde el archivo [README](https://github.com/georchestra/georchestra/blob/master/README.md) en la raíz del proyecto.
+<p class="lead">
+    Desde esta página puede acceder a la documentación de instalación y uso de la plataforma geOrchestra.
+</p>
 
-Los **manuales de referencia** de los módulos independientes subyacentes también son valiosas fuentes de información:
+<div class="row py-2 d-flex align-items-stretch">
+    {% include card_doc_tool.html img_url="/favicon.ico" name="geOrchestra" text="Guía de instalación" site_url="https://github.com/georchestra/georchestra/blob/master/docs/index.md" %}   
+</div>
 
-  * En el [sitio web de GeoServer](https://docs.geoserver.org/maintain/en/user/) para la versión 2.20,
-  * En el [sitio web de GeoNetwork](https://www.geonetwork-opensource.org/manuals/4.0.x/en/) para la versión 4,
-  * En el [sitio web de GeoWebCache](https://www.geowebcache.org/docs/current/index.html) para la versión 1.16.
+## Los componentes de geOrchestra
 
-## Registro OID
+### Ver
+<div class="row py-2 d-flex align-items-stretch">
+    {% include card_doc_tool.html img_url="/public/icons/mapstore_icon.svg" name="MapStore2" text="Un visor avanzado de datos geográficos" site_url="https://docs.georchestra.org/mapstore2/" %}
+    {% include card_doc_tool.html img_url="/public/icons/datafeeder_icon.svg" name="Plugin del registro de la propiedad" text="Un complemento para la consulta del catastro" site_url="https://docs.georchestra.org/cadastrapp/" %}
+    {% include card_doc_tool.html img_url="/public/icons/mapstore_icon.svg" name="Mviewer" text="Un visor de datos geográficos para el público" site_url="https://mviewerdoc.readthedocs.io/fr/latest/" %}
+    {% include card_doc_tool.html img_url="/public/icons/datafeeder_icon.svg" name="Plugin de urbanismo" text="Un plugin para consultar documentos de planificación" site_url="https://docs.georchestra.org/mapstore2-urbanisme/fr/latest/" %}    
+</div>
 
-El proyecto geOrchestra [recibió](https://www.iana.org/assignments/enterprise-numbers/enterprise-numbers)
-un *Object Identifier* (OID): `1.3.6.1.4.1.53611`. Es particularmente util para
-para manejar los objetos LDAP específicos a geOrchestra. Por debajo de este OID
-raíz, la comunidad geOrchestra administra su propio
-[registro OID]({{ site.baseurl }}{% link oid.md %}) (en inglés).
+### Suministro
+<div class="row py-2 d-flex align-items-stretch">
+    {% include card_doc_tool.html img_url="/public/icons/datafeeder_icon.svg" name="Datafeeder" text="Un asistente de integración de datos" site_url="https://georchestra-user-guide.readthedocs.io/en/latest/setup/datafeeder/" %}   
+</div>
+
+### Publicar
+<div class="row py-2 d-flex align-items-stretch">
+    {% include card_doc_tool.html img_url="/public/icons/geonetwork_icon.svg" name="GeoNetwork" text="Un catálogo de metadatos" site_url="https://geonetwork-opensource.org/manuals/3.12.x/fr/" %}
+    {% include card_doc_tool.html img_url="/public/icons/datafeeder_icon.svg" name="GeoServer" text="Un servidor de datos geográficos que cumple las normas WxS del OGC" site_url="https://docs.geoserver.org/stable/en/user/" %}
+    {% include card_doc_tool.html img_url="/public/icons/geowebcache_icon.svg" name="GeoWebCache" text="Un servidor de azulejos" site_url="https://www.osgeo.org/projects/geowebcache/" %}
+    {% include card_doc_tool.html img_url="/public/icons/geowebcache_icon.svg" name="Data API" text="Una API de datos abierta que cumple las nuevas normas 'Features API' del OGC" site_url="https://github.com/georchestra/data-api" %}        
+</div>
+
+### Administrar
+<div class="row py-2 d-flex align-items-stretch">
+    {% include card_doc_tool.html img_url="/public/icons/geofence_icon.svg" name="GeoFence" text="Un módulo para la gestión avanzada de los derechos de acceso a los datos" site_url="https://github.com/NielsCharlier/geofence" %}
+    {% include card_doc_tool.html img_url="/public/icons/ldapadmin_icon.svg" name="Console" text="Una consola de administración para usuarios, funciones y organizaciones" site_url="https://github.com/georchestra/georchestra/tree/master/console" %}
+    {% include card_doc_tool.html img_url="/public/icons/analytics_icon.svg" name="Analytics" text="Un módulo que presenta estadísticas sobre el uso de la plataforma" site_url="https://github.com/georchestra/analytics" %}   
+    {% include card_doc_tool.html img_url="/public/icons/ldapadmin_icon.svg" name="Mviewer Studio" text="Un generador de aplicaciones mviewer" site_url="https://mviewerstudio.readthedocs.io/fr/stable/index.html" %}  
+    {% include card_doc_tool.html img_url="/public/icons/ldapadmin_icon.svg" name="Mviewer Studio" text="Un generador de aplicaciones mviewer" site_url="https://mviewerstudio.readthedocs.io/fr/stable/index.html" %} 
+</div>

fr/documentation.md

@@ -6,19 +6,41 @@ uid: documentation
 permalink: /fr/documentation.html
 ---
 
-La documentation d'installation et de configuration est centralisée sur le [dépôt du code source](https://github.com/georchestra/georchestra/), en langue anglaise.
-Vous pouvez y accéder depuis le fichier [README](https://github.com/georchestra/georchestra/blob/master/README.md) à la racine du projet.
+<p class="lead">
+    Depuis cette page accédez à la documentation d'installation et d'utilisation de la plateforme geOrchestra.
+</p>
 
-Par ailleurs, il est toujours utile de consulter les **documentations publiques** de référence des différents projets communautaires sous-jacents:
+<div class="row py-2 d-flex align-items-stretch">
+    {% include card_doc_tool.html img_url="/favicon.ico" name="geOrchestra" text="Guide d'installation" site_url="https://github.com/georchestra/georchestra/blob/master/docs/index.md" %}   
+</div>
 
- * sur le [site de GeoServer](https://docs.geoserver.org/maintain/en/user/) pour la version 2.20,
- * sur le [site de GeoNetwork](https://www.geonetwork-opensource.org/manuals/4.0.x/en/) pour la version 4,
- * sur le [site de GeoWebCache](https://www.geowebcache.org/docs/current/index.html) pour la version 1.16.
+## Les différents composants de geOrchestra
 
-## Registre OID
+### Visualiser
+<div class="row py-2 d-flex align-items-stretch">
+    {% include card_doc_tool.html img_url="/public/icons/mapstore_icon.svg" name="MapStore2" text="Un visualiseur de données géographiques avancé" site_url="https://docs.georchestra.org/mapstore2/" %}
+    {% include card_doc_tool.html img_url="/public/icons/datafeeder_icon.svg" name="Plugin Cadastre" text="Un plugin pour la consultation du cadastre" site_url="https://docs.georchestra.org/cadastrapp/" %}
+    {% include card_doc_tool.html img_url="/public/icons/mapstore_icon.svg" name="Mviewer" text="Un visualiseur de données géographiques destiné au grand public" site_url="https://mviewerdoc.readthedocs.io/fr/latest/" %}
+    {% include card_doc_tool.html img_url="/public/icons/datafeeder_icon.svg" name="Plugin Urbanisme" text="Un plugin pour la consultation des documents d'urbanisme" site_url="https://docs.georchestra.org/mapstore2-urbanisme/fr/latest/" %}    
+</div>
 
-Le projet geOrchestra [a reçu](https://www.iana.org/assignments/enterprise-numbers/enterprise-numbers)
-un *Object Identifier* (OID): `1.3.6.1.4.1.53611`. C'est particulièrement utile
-pour gérer les objets LDAP spécifiques à geOrchestra. Sous ce OID racine, la
-communauté geOrchestra administre son propre
-[registre OID]({{ site.baseurl }}{% link oid.md %}) (en anglais).
+### Fournir
+<div class="row py-2 d-flex align-items-stretch">
+    {% include card_doc_tool.html img_url="/public/icons/datafeeder_icon.svg" name="Datafeeder" text="Un assistant d'intégration des données" site_url="https://georchestra-user-guide.readthedocs.io/en/latest/setup/datafeeder/" %}   
+</div>
+
+### Publier
+<div class="row py-2 d-flex align-items-stretch">
+    {% include card_doc_tool.html img_url="/public/icons/geonetwork_icon.svg" name="GeoNetwork" text="Un  catalogue de métadonnées" site_url="https://geonetwork-opensource.org/manuals/3.12.x/fr/" %}
+    {% include card_doc_tool.html img_url="/public/icons/datafeeder_icon.svg" name="GeoServer" text="Un puissant serveur de données géographiques respectant les standards WxS de l'OGC" site_url="https://docs.geoserver.org/stable/en/user/" %}
+    {% include card_doc_tool.html img_url="/public/icons/geowebcache_icon.svg" name="GeoWebCache" text="Un serveur de tuiles" site_url="https://www.osgeo.org/projects/geowebcache/" %}
+    {% include card_doc_tool.html img_url="/public/icons/geowebcache_icon.svg" name="Data API" text="Une API open data respectant les nouveaux standards 'Features API' de l'OGC" site_url="https://github.com/georchestra/data-api" %}        
+</div>
+
+### Administrer
+<div class="row py-2 d-flex align-items-stretch">
+    {% include card_doc_tool.html img_url="/public/icons/geofence_icon.svg" name="GeoFence" text="Un module de gestion avancée des droits d’accès aux données" site_url="https://github.com/NielsCharlier/geofence" %}
+    {% include card_doc_tool.html img_url="/public/icons/ldapadmin_icon.svg" name="Console" text="Une console d’administration des utilisateurs, rôles et organismes" site_url="https://github.com/georchestra/georchestra/tree/master/console" %}
+    {% include card_doc_tool.html img_url="/public/icons/analytics_icon.svg" name="Analytics" text="Un module présentant les statistiques d’utilisation de la plateforme" site_url="https://github.com/georchestra/analytics" %}     
+    {% include card_doc_tool.html img_url="/public/icons/ldapadmin_icon.svg" name="Mviewer Studio" text="Un générateur d'applications mviewer" site_url="https://mviewerstudio.readthedocs.io/fr/stable/index.html" %}
+</div>