From 5d1b85bfae13798b213049cbb0f6029f8cb6ffb2 Mon Sep 17 00:00:00 2001 From: bruhnild Date: Wed, 11 Dec 2024 10:23:54 +0100 Subject: [PATCH 1/8] improve doc and theme --- README.rst | 182 ++++++++++++++++++------------- docs/_static/geotrek-admin.png | Bin 0 -> 7806 bytes docs/changelog.rst | 5 + docs/conf.py | 8 +- docs/usage/apis.rst | 2 +- docs/usage/configuration-ttw.rst | 36 +++--- 6 files changed, 133 insertions(+), 100 deletions(-) create mode 100644 docs/_static/geotrek-admin.png diff --git a/README.rst b/README.rst index 71279fa2b7..45382fbd4f 100644 --- a/README.rst +++ b/README.rst @@ -1,112 +1,138 @@ -**Geotrek**, *paths* management for *National Parks* and *Tourism organizations*. - -.. image:: http://geotrek.fr/assets/img/logo.svg - -:master: |master-status| |master-coverage| |master-e2e| |master-rtd| - -.. |master-status| image:: - https://github.com/GeotrekCE/Geotrek-admin/actions/workflows/test.yml/badge.svg - :alt: CI Status - :target: https://github.com/GeotrekCE/Geotrek-admin/actions/workflows/test.yml - -.. |master-coverage| image:: - https://codecov.io/gh/GeotrekCE/Geotrek-admin/branch/master/graph/badge.svg - :alt: Coverage - :target: https://codecov.io/gh/GeotrekCE/Geotrek-admin +Geotrek-admin +============= + +.. raw:: html + +

Geotrek-admin

+ +

geotrek admin image

+ +

+ Documentation + Geotrek Admin demo + Chat Matrix + Forum Google Group +

+

+ CI Status + Coverage + End to End + Documentation +

+ +.. raw:: html + +

+ Admin • + Features • + User manual • + Installation and configuration • +

+

+ Support • + Contribution • + Contributors • + License • +

+ +Admin +----- + +**Geotrek-admin** is a web application designed to manage, centralize, and structure geographical and touristic information for your territory. It is the back-office application of the Geotrek ecosystem. + +With Geotrek-admin, you can: + +- Manage treks, touristic information, and related content (media, descriptions, etc.). +- Organize your data with maps, layers, and metadata. +- Export content to various public interfaces, such as Geotrek-rando or printed topoguides. + +You can explore Geotrek-admin in action through our demonstration website: + +- `https://demo-admin.geotrek.fr/ `_ (demo / demo) + +Geotrek-admin is built on Django and leverages a PostGIS database for handling geographical data. It serves as the data source for Geotrek-rando, Geotrek-widget, and other tools of the Geotrek ecosystem. + +Learn more about Geotrek-admin in the `general documentation (French) `_. + +Features +-------- -.. |master-e2e| image:: - https://img.shields.io/endpoint?url=https://dashboard.cypress.io/badge/simple/ktpy7v/master&style=flat&logo=cypress - :alt: End to End - :target: https://dashboard.cypress.io/projects/ktpy7v/runs +Geotrek-Admin is a powerful web mapping application designed for managing trekking, outdoor, and tourism data with ease. Tailored to support GIS features and extensive customization, it empowers organizations to manage, maintain, and publish their outdoor assets seamlessly: -.. |master-rtd| image:: - https://readthedocs.org/projects/geotrek/badge/?version=latest&style=flat - :alt: Documentation - :target: https://geotrek.readthedocs.io +- **Management tool**: manage paths, interventions, signage, treks, POIs, touristic events, and much more. +- **Maintenance tracking**: track the maintenance of equipment and infrastructures with precision. +- **Advanced GIS capabilities**: control objects by district, protected areas, physical and legal status of paths, and compute 3D attributes using DEM draping. +- **Data synchronization**: interconnect with external platforms like Suricate, Apidae, and Tourinsoft for real-time data updates. +- **Publishing tools**: + - Create public websites with `Geotrek-rando `_ (e.g., `Destination Écrins `_, `Alpes Rando `_). + - Embed trek information into existing websites with `Geotrek-widget `_ for flexible and lightweight integration (e.g., `Sidobre Vallée Tourisme `_, `la Toscane Occitane `_). + - Develop mobile applications with `Geotrek-mobile `_ (e.g., `Grand Carcassonne `_, `Jura outdoor `_). +- **Customizable outputs**: export data in various formats (PDF, GPX, KML) for offline use and tailored user experiences. +- **Interactive mapping**: enable users to visualize and explore data-rich maps with detailed elevation profiles. +- **Documentation and support**: access comprehensive documentation, best practices, and community support for all your needs in the `official documentation `_. +Learn more on the `Geotrek product website `_. -In brief --------- +User manual (french) +-------------------- -* Web mapping application offering GIS features -* Manage paths, interventions, signage, treks, POIs, touristic events and so much more -* Track maintenance of equipments and infrastructures -* Control objets by district, protected areas, physical and legal status of paths -* Compute 3D attributes using DEM draping -* Allow to interconnect with multiple applications to synchronize data (Suricate, Apidae, Tourinsoft, etc.) -* Publish a public website with `Geotrek-rando `_ (e.g. `PNE `_, `PNM-PNAM `_) -* Publish a public mobile application with `Geotrek-mobile `_ (e.g. `OTGC `_, `CD39 `_) +- `Presentation `_ +- `Management modules `_ +- `Touristic modules `_ -.. image:: http://geotrek.fr/assets/img/screen-1.png +Installation and configuration +------------------------------ -More information on product website http://geotrek.fr +- `Installation `_ +- `Configuration `_ +- `Advanced configuration `_ -Documentation -------------- - -* `User manual (in french) `_ -* `Installation and configuration instructions `_ -* Help us translate `on Weblate `_ +Support +------- +- To report bugs or suggest features, please `submit a ticket `_. +- Join our community to stay updated and share your experience! Connect on `Matrix `_ for real-time discussions, or connect through the `Google Group `_ to exchange ideas and insights. Contribution ------------ -* `Contributing guide `_ -* `Development documentation `_ +Interested in contributing? See our `Contributing Guide `_. You can help in many ways, the ability to code is not necessary. + +Thanks to all contributors ❤ +---------------------------- +.. image:: https://contrib.rocks/image?repo=GeotrekCE/Geotrek-admin + :target: https://github.com/GeotrekCE/Geotrek-admin/graphs/contributors + +Made with `contrib.rocks `_. License ------- -* OpenSource - BSD -* Copyright (c) 2012-2023 - Makina Corpus / Parc national des Ecrins - Parc National du Mercantour - Parco delle Alpi Marittime +This project is under the MIT License. See the `LICENSE `_ for details. + +- OpenSource - BSD +- Copyright (c) 2012-2024 - Makina Corpus Territoires / Parc national des Ecrins - Parc National du Mercantour - Parco delle Alpi Marittime .. image:: https://geotrek.fr/assets/img/logo_makina.svg + :alt: Logo MCT + :width: 115 :target: https://territoires.makina-corpus.com/ - :width: 170 .. image:: https://geotrek.fr/assets/img/logo_autonomens-h120m.png - :target: https://datatheca.com + :alt: Logo Autonomens + :target: https://datatheca.com/ ---- .. image:: http://geotrek.fr/assets/img/parc_ecrins.png + :alt: Parc des Ecrins :target: http://www.ecrins-parcnational.fr - .. image:: http://geotrek.fr/assets/img/parc_mercantour.png + :alt: Parc du Mercantour :target: http://www.mercantour.eu - .. image:: http://geotrek.fr/assets/img/alpi_maritime.png + :alt: Parco delle Alpi Marittime :target: http://www.parcoalpimarittime.it - - -Status of sub-projects ----------------------- - -* |django-mapentity| `django-mapentity `_ -* |django-leaflet| `django-leaflet `_ -* |convertit| `ConvertIt `_ -* |Leaflet.GeometryUtil| `Leaflet.GeometryUtil `_ -* |Leaflet.FileLayer| `Leaflet.FileLayer `_ -* |Leaflet.AlmostOver| `Leaflet.AlmostOver `_ - -.. |django-mapentity| image:: https://github.com/makinacorpus/django-mapentity/actions/workflows/python-ci.yml/badge.svg - :target: https://github.com/makinacorpus/django-mapentity/actions/workflows/python-ci.yml - -.. |django-leaflet| image:: https://github.com/makinacorpus/django-leaflet/actions/workflows/python-app.yml/badge.svg - :target: https://github.com/makinacorpus/django-leaflet/actions/workflows/python-app.yml - -.. |convertit| image:: https://circleci.com/gh/makinacorpus/convertit.svg?style=shield - :target: https://circleci.com/gh/makinacorpus/convertit - -.. |Leaflet.GeometryUtil| image:: https://travis-ci.org/makinacorpus/Leaflet.GeometryUtil.png?branch=master - :target: https://travis-ci.org/makinacorpus/Leaflet.GeometryUtil?branch=master - -.. |Leaflet.FileLayer| image:: https://travis-ci.org/makinacorpus/Leaflet.FileLayer.png?branch=master - :target: https://travis-ci.org/makinacorpus/Leaflet.FileLayer?branch=master - -.. |Leaflet.AlmostOver| image:: https://travis-ci.org/makinacorpus/Leaflet.GeometryUtil.png?branch=master - :target: https://travis-ci.org/makinacorpus/Leaflet.AlmostOver?branch=master diff --git a/docs/_static/geotrek-admin.png b/docs/_static/geotrek-admin.png new file mode 100644 index 0000000000000000000000000000000000000000..58dfa890f86cfad2838a32b74342b4544acb2020 GIT binary patch literal 7806 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 Qh5!Hn07*qoM6N<$f;w8k1poj5 literal 0 HcmV?d00001 diff --git a/docs/changelog.rst b/docs/changelog.rst index d25336077d..87c8183fc6 100644 --- a/docs/changelog.rst +++ b/docs/changelog.rst @@ -5,6 +5,11 @@ CHANGELOG 2.111.0+dev (XXXX-XX-XX) ---------------------------- +**Documentation** + +- Update theme color +- Fix typo in documentation +- Update and homogenize README.rst 2.111.0 (2024-12-05) ---------------------------- diff --git a/docs/conf.py b/docs/conf.py index 898591e6f4..cfe0641383 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -60,8 +60,8 @@ { "media": "(prefers-color-scheme: light)", "scheme": "default", - "primary": "green", - "accent": "light green", + "primary": "red", + "accent": "deep-orange", "toggle": { "icon": "material/weather-night", "name": "Switch to dark mode", @@ -70,8 +70,8 @@ { "media": "(prefers-color-scheme: dark)", "scheme": "slate", - "primary": "green", - "accent": "light green", + "primary": "red", + "accent": "deep-orange", "toggle": { "icon": "material/weather-sunny", "name": "Switch to light mode", diff --git a/docs/usage/apis.rst b/docs/usage/apis.rst index b017595f02..afedcf8891 100644 --- a/docs/usage/apis.rst +++ b/docs/usage/apis.rst @@ -27,7 +27,7 @@ APIs externes Geotrek et IGNrando' -------------------- -Geotrek-admin est capable de produire un flux des itinéraires et POIs présents dans sa BDD au format Cirkwi pour pouvoir les importer directement dans IGNrando' (https://makina-corpus.com/sig-webmapping/geotrek-et-lign-ca-fonctionne). +Geotrek-admin est capable de produire un flux des itinéraires et POIs présents dans sa BDD au format Cirkwi pour pouvoir les importer directement dans IGNrando' `(voir cet article) `_. Exemple des randonnées et POIs du Parc national des Ecrins publiées sur IGNrando' depuis Geotrek-admin : https://ignrando.fr/fr/communautes/parc-national-des-ecrins diff --git a/docs/usage/configuration-ttw.rst b/docs/usage/configuration-ttw.rst index f0728b5085..201a559e3f 100644 --- a/docs/usage/configuration-ttw.rst +++ b/docs/usage/configuration-ttw.rst @@ -53,10 +53,12 @@ Exemple : ajouter une étiquette ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Les étiquettes sont des encarts "pré-configurés" pouvant être réutilisés sur de multiples itinéraires. Elles présentent plusieurs avantages : + - ne pas avoir à saisir à chaque itinéraire les même informations - permet de filtrer les itinéraires dans la vue liste (catégorie "Autres") sur Geotrek-Rando. Pour les configurer, vous devez : + - vous rendre dans le module de configuration - dans la section Étiquettes du groupe **COMMUN** cliquer sur :guilabel:`+ Ajouter` @@ -285,7 +287,7 @@ Geotrek permet de configurer un ou plusieurs portails. Ce terme est utilisé pou Ainsi, il est possible d'avoir plusieurs Geotrek-Rando branchés sur un seul Geotrek-Admin. Grâce à leur distinction sous forme de portail, il sera alors aisé de choisir sur quel Geotrek-Rando on souhaite faire apparaitre une information. -Avec le widget Geotrek (https://github.com/GeotrekCE/geotrek-rando-widget) il est également possible d'utiliser cette fonctionnalité pour distinguer les contenus à afficher dans un widget ou dans un autre (https://makina-corpus.com/logiciel-libre/developpement-geotrek-widget-finance-parc-naturel-regional-haut-jura). +Avec `Geotrek-widget `_ il est également possible d'utiliser cette fonctionnalité pour distinguer les contenus à afficher dans un widget ou dans un autre `(voir cet article) `_. Pour configurer un ou pluseurs portails, il faut se rendre dans le module de configuration sur la section "Portails cibles". @@ -314,9 +316,9 @@ Intégration des fonds de cartes Il est possible d'intégrer dans Geotrek différents fonds de carte comme : -* OpenStreetMap : https://www.openstreetmap.org/#map=6/46.449/2.210 -* OpenTopoMap : https://opentopomap.org/#map=6.49.000/10.000 -* ou les données IGN : https://geoservices.ign.fr/services-geoplateforme-diffusion +* `OpenStreetMap `_ +* `OpenTopoMap  `_ +* `ou les données IGN  `_ Pour configurer l'ajout de fonds de plan, référez vous à cette section :ref:`Map settings ` @@ -345,16 +347,16 @@ Afin de s'intégrer au mieux dans le design standard, les couleurs suivantes son Voici quelques ressources en ligne proposant des pictogrammes (sous licence libre) : -- `https://pictogrammers.com/library/mdi/ `_ -- `https://thenounproject.com/ `_ -- `http://map-icons.com/ `_ -- `https://www.opensymbols.org/ `_ -- `https://www.svgrepo.com/ `_ -- `http://www.entypo.com/ `_ -- `https://icons.getbootstrap.com/ `_ -- `https://icongr.am/ `_ -- `https://cocomaterial.com/ `_ -- `https://icofont.com/ `_ -- `https://fontello.com/ `_ -- `https://iconmonstr.com/ `_ -- `https://fontawesome.com/icons `_ +- `Pictogrammers `_ +- `The Noun Project `_ +- `Map icons `_ +- `Opensymbols `_ +- `SVG repo `_ +- `Entypo `_ +- `Icons Getbootstrap `_ +- `Icongr `_ +- `Cocomaterial `_ +- `Icofont `_ +- `Fontello `_ +- `Iconmonstr `_ +- `Fontawesome `_ From a7cbab929a058be797097c001b89a104e4a275d4 Mon Sep 17 00:00:00 2001 From: bruhnild Date: Wed, 11 Dec 2024 10:41:20 +0100 Subject: [PATCH 2/8] Update documentation badge --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 45382fbd4f..954beacb8c 100644 --- a/README.rst +++ b/README.rst @@ -8,7 +8,7 @@ Geotrek-admin

geotrek admin image

- Documentation + Documentation Geotrek Admin demo Chat Matrix Forum Google Group From 3a4109706ca8bdc17ceba0e691b46afe41f9eac5 Mon Sep 17 00:00:00 2001 From: Marine Faucher Date: Wed, 11 Dec 2024 11:54:32 +0100 Subject: [PATCH 3/8] Update README.rst Co-authored-by: Camille Monchicourt --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 954beacb8c..2993505320 100644 --- a/README.rst +++ b/README.rst @@ -46,7 +46,7 @@ With Geotrek-admin, you can: - Organize your data with maps, layers, and metadata. - Export content to various public interfaces, such as Geotrek-rando or printed topoguides. -You can explore Geotrek-admin in action through our demonstration website: +You can explore Geotrek-admin in action through the demonstration website: - `https://demo-admin.geotrek.fr/ `_ (demo / demo) From e5f33b913d95e08a91ff2b49bd748318d0c9e2b5 Mon Sep 17 00:00:00 2001 From: Marine Faucher Date: Wed, 11 Dec 2024 11:54:43 +0100 Subject: [PATCH 4/8] Update README.rst Co-authored-by: Camille Monchicourt --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 2993505320..6bd43898dd 100644 --- a/README.rst +++ b/README.rst @@ -66,7 +66,7 @@ Geotrek-Admin is a powerful web mapping application designed for managing trekki - **Publishing tools**: - Create public websites with `Geotrek-rando `_ (e.g., `Destination Écrins `_, `Alpes Rando `_). - Embed trek information into existing websites with `Geotrek-widget `_ for flexible and lightweight integration (e.g., `Sidobre Vallée Tourisme `_, `la Toscane Occitane `_). - - Develop mobile applications with `Geotrek-mobile `_ (e.g., `Grand Carcassonne `_, `Jura outdoor `_). + - Deploy mobile applications with `Geotrek-mobile `_ (e.g., `Grand Carcassonne `_, `Jura outdoor `_). - **Customizable outputs**: export data in various formats (PDF, GPX, KML) for offline use and tailored user experiences. - **Interactive mapping**: enable users to visualize and explore data-rich maps with detailed elevation profiles. - **Documentation and support**: access comprehensive documentation, best practices, and community support for all your needs in the `official documentation `_. From cb1d2eb6f798946efab2ce785575f432ac351f14 Mon Sep 17 00:00:00 2001 From: Marine Faucher Date: Wed, 11 Dec 2024 11:54:54 +0100 Subject: [PATCH 5/8] Update README.rst Co-authored-by: Camille Monchicourt --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 6bd43898dd..a7ca2770f3 100644 --- a/README.rst +++ b/README.rst @@ -126,7 +126,7 @@ This project is under the MIT License. See the `LICENSE Date: Wed, 11 Dec 2024 11:55:03 +0100 Subject: [PATCH 6/8] Update README.rst Co-authored-by: Camille Monchicourt --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index a7ca2770f3..03b99a8963 100644 --- a/README.rst +++ b/README.rst @@ -130,7 +130,7 @@ This project is under the MIT License. See the `LICENSE Date: Wed, 11 Dec 2024 12:00:49 +0100 Subject: [PATCH 7/8] Fix license in readme --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 03b99a8963..0a0be988d7 100644 --- a/README.rst +++ b/README.rst @@ -109,7 +109,7 @@ Made with `contrib.rocks `_. License ------- -This project is under the MIT License. See the `LICENSE `_ for details. +This project is under the BSD License. See the `LICENSE `_ for details. - OpenSource - BSD - Copyright (c) 2012-2024 - Makina Corpus Territoires / Parc national des Ecrins - Parc National du Mercantour - Parco delle Alpi Marittime From ef41df034a6fa3c4041ae7a09f9f089be7ec8526 Mon Sep 17 00:00:00 2001 From: bruhnild Date: Wed, 11 Dec 2024 13:28:38 +0100 Subject: [PATCH 8/8] Replace .rst REAME file by .md --- README.md | 111 ++++++++++++++++++++++++++++++++++++++++++ README.rst | 138 ----------------------------------------------------- 2 files changed, 111 insertions(+), 138 deletions(-) create mode 100644 README.md delete mode 100644 README.rst diff --git a/README.md b/README.md new file mode 100644 index 0000000000..c72875251c --- /dev/null +++ b/README.md @@ -0,0 +1,111 @@ +

Geotrek-admin

+ +

geotrek admin image

+ +

+Documentation +Geotrek Admin demo +Chat Matrix +Forum Google Group +

+

+CI Status +Coverage +End to End +Documentation +

+ +

+ Admin • + Features • + User manual • + Installation and configuration • +

+

+ Support • + Contribution • + Contributors • + License • +

+ +[![Alt text](http://geotrek.fr/assets/img/screen-1.png "Interface de Geotrek-admin")](http://geotrek.fr) + +## Admin + +**Geotrek-admin** is a web application designed to manage, centralize, and structure geographical and touristic information for your territory. It is the back-office application of the Geotrek ecosystem. + +With Geotrek-admin, you can: +- Manage treks, touristic information, and related content (media, descriptions, etc.). +- Organize your data with maps, layers, and metadata. +- Export content to various public interfaces, such as Geotrek-rando or printed topoguides. + +You can explore Geotrek-admin in action through the demonstration website: +- [https://demo-admin.geotrek.fr/](https://demo-admin.geotrek.fr/) (demo / demo) : + +Geotrek-admin is built on Django and leverages a PostGIS database for handling geographical data. It serves as the data source for Geotrek-rando, Geotrek-widget and other tools of the Geotrek ecosystem. + +Learn more about Geotrek-admin in the [general documentation (French)](https://geotrek.readthedocs.io/fr/latest/about/geotrek.html). + +## Features + +Geotrek-Admin is a powerful web mapping application designed for managing trekking, outdoor and tourism data with ease. Tailored to support GIS features and extensive customization, it empowers organizations to manage, maintain, and publish their outdoor assets seamlessly: + +- **Management tool**: manage paths, interventions, signage, treks, POIs, touristic events, and much more. +- **Maintenance tracking**: track the maintenance of equipment and infrastructures with precision. +- **Advanced GIS capabilities**: control objects by district, protected areas, physical and legal status of paths, and compute 3D attributes using DEM draping. +- **Data synchronization**: interconnect with external platforms like Suricate, Apidae, and Tourinsoft for real-time data updates. +- **Publishing tools**: + - create public websites with [Geotrek-rando](https://github.com/GeotrekCE/Geotrek-rando-v3) (e.g., [Destination Écrins](https://rando.ecrins-parcnational.fr), [Alpes Rando](https://alpesrando.net/)). + - embed trek information into existing websites with [Geotrek-widget](https://github.com/GeotrekCE/Geotrek-rando-widget) for flexible and lightweight integration (e.g., [Sidobre Vallée Tourisme](https://sidobre-vallees-tourisme.com/type_activite/balades-et-randonnees-sidobre-vallees/), [la Toscane Occitane](https://www.la-toscane-occitane.com/a-voir-a-faire/balades-randonnees)).. + - deploy mobile applications with [Geotrek-mobile](https://github.com/GeotrekCE/Geotrek-mobile) (e.g., [Grand Carcasssonne](https://play.google.com/store/apps/details?id=io.geotrek.grandcarcassonne), [Jura outdoor](https://apps.apple.com/app/jura-outdoor/id6446137384)). +- **Customizable outputs**: export data in various formats (PDF, GPX, KML) for offline use and tailored user experiences. +- **Interactive mapping**: enable users to visualize and explore data-rich maps with detailed elevation profiles. +- **Documentation and support**: access comprehensive documentation, best practices and community support for all your needs in the ([official documentation](https://geotrek.readthedocs.io/en/2.111.0/usage/overview.html)). + +Learn more on the [Geotrek product website](http://geotrek.fr). + +## User manual (french) + +- [Presentation](https://geotrek.readthedocs.io/fr/latest/usage/overview.html) +- [Management modules](https://geotrek.readthedocs.io/fr/latest/usage/management-modules.html) +- [Touristic modules](https://geotrek.readthedocs.io/fr/latest/usage/touristic-modules.html) + +## Installation and configuration + +- [Installation](https://geotrek.readthedocs.io/fr/latest/install/installation.html) +- [Configuration](https://geotrek.readthedocs.io/fr/latest/install/configuration.html) +- [Advanced configuration](https://geotrek.readthedocs.io/fr/latest/install/advanced-configuration.html) + +## Support + +- To report bugs or suggest features, please [submit a ticket](https://github.com/GeotrekCE/Geotrek-admin/issues). +- Join our community to stay updated and share your experience! Connect on [Matrix](https://matrix.to/#/%23geotrek:matrix.org) for real-time discussions, or connect through the [Google Group](https://groups.google.com/g/geotrek-fr) to exchange ideas and insights. + +## Contribution + +Interested in contributing? See our [Contributing Guide](https://geotrek.readthedocs.io/en/latest/contribute/contributing.html +). You can help in many ways, the ability to code is not necessary. + +## Thanks to all contributors ❤ + + + + + +Made with [contrib.rocks](https://contrib.rocks). + +## License + +This project is under the BSD License. See the [LICENSE](Geotrek-admin/blob/main/LICENSE) for details. + +- OpenSource - BSD +- Copyright (c) 2012-2024 - Makina Corpus Territoires / Parc national des Ecrins - Parc National du Mercantour - Parco delle Alpi Marittime + +Logo de Makina Corpus Territoires +[![Alt text](https://geotrek.fr/assets/img/logo_autonomens-h120m.png "Logo Autonomens")](https://datatheca.com/) + +---- + +[![Alt text](http://geotrek.fr/assets/img/parc_ecrins.png "Logo du Parc national des Ecrins")](http://www.ecrins-parcnational.fr) +[![Alt text](http://geotrek.fr/assets/img/parc_mercantour.png "Logo du Parc national du Mercantour")](http://www.mercantour.eu) +[![Alt text](http://geotrek.fr/assets/img/alpi_maritime.png "Logo du Parc naturel des Alpes maritimes")](http://www.parcoalpimarittime.it) diff --git a/README.rst b/README.rst deleted file mode 100644 index 0a0be988d7..0000000000 --- a/README.rst +++ /dev/null @@ -1,138 +0,0 @@ -Geotrek-admin -============= - -.. raw:: html - -

Geotrek-admin

- -

geotrek admin image

- -

- Documentation - Geotrek Admin demo - Chat Matrix - Forum Google Group -

-

- CI Status - Coverage - End to End - Documentation -

- -.. raw:: html - -

- Admin • - Features • - User manual • - Installation and configuration • -

-

- Support • - Contribution • - Contributors • - License • -

- -Admin ------ - -**Geotrek-admin** is a web application designed to manage, centralize, and structure geographical and touristic information for your territory. It is the back-office application of the Geotrek ecosystem. - -With Geotrek-admin, you can: - -- Manage treks, touristic information, and related content (media, descriptions, etc.). -- Organize your data with maps, layers, and metadata. -- Export content to various public interfaces, such as Geotrek-rando or printed topoguides. - -You can explore Geotrek-admin in action through the demonstration website: - -- `https://demo-admin.geotrek.fr/ `_ (demo / demo) - -Geotrek-admin is built on Django and leverages a PostGIS database for handling geographical data. It serves as the data source for Geotrek-rando, Geotrek-widget, and other tools of the Geotrek ecosystem. - -Learn more about Geotrek-admin in the `general documentation (French) `_. - -Features --------- - -Geotrek-Admin is a powerful web mapping application designed for managing trekking, outdoor, and tourism data with ease. Tailored to support GIS features and extensive customization, it empowers organizations to manage, maintain, and publish their outdoor assets seamlessly: - -- **Management tool**: manage paths, interventions, signage, treks, POIs, touristic events, and much more. -- **Maintenance tracking**: track the maintenance of equipment and infrastructures with precision. -- **Advanced GIS capabilities**: control objects by district, protected areas, physical and legal status of paths, and compute 3D attributes using DEM draping. -- **Data synchronization**: interconnect with external platforms like Suricate, Apidae, and Tourinsoft for real-time data updates. -- **Publishing tools**: - - Create public websites with `Geotrek-rando `_ (e.g., `Destination Écrins `_, `Alpes Rando `_). - - Embed trek information into existing websites with `Geotrek-widget `_ for flexible and lightweight integration (e.g., `Sidobre Vallée Tourisme `_, `la Toscane Occitane `_). - - Deploy mobile applications with `Geotrek-mobile `_ (e.g., `Grand Carcassonne `_, `Jura outdoor `_). -- **Customizable outputs**: export data in various formats (PDF, GPX, KML) for offline use and tailored user experiences. -- **Interactive mapping**: enable users to visualize and explore data-rich maps with detailed elevation profiles. -- **Documentation and support**: access comprehensive documentation, best practices, and community support for all your needs in the `official documentation `_. - -Learn more on the `Geotrek product website `_. - -User manual (french) --------------------- - -- `Presentation `_ -- `Management modules `_ -- `Touristic modules `_ - -Installation and configuration ------------------------------- - -- `Installation `_ -- `Configuration `_ -- `Advanced configuration `_ - -Support -------- - -- To report bugs or suggest features, please `submit a ticket `_. -- Join our community to stay updated and share your experience! Connect on `Matrix `_ for real-time discussions, or connect through the `Google Group `_ to exchange ideas and insights. - -Contribution ------------- - -Interested in contributing? See our `Contributing Guide `_. You can help in many ways, the ability to code is not necessary. - -Thanks to all contributors ❤ ----------------------------- - -.. image:: https://contrib.rocks/image?repo=GeotrekCE/Geotrek-admin - :target: https://github.com/GeotrekCE/Geotrek-admin/graphs/contributors - -Made with `contrib.rocks `_. - -License -------- - -This project is under the BSD License. See the `LICENSE `_ for details. - -- OpenSource - BSD -- Copyright (c) 2012-2024 - Makina Corpus Territoires / Parc national des Ecrins - Parc National du Mercantour - Parco delle Alpi Marittime - -.. image:: https://geotrek.fr/assets/img/logo_makina.svg - :alt: Logo MCT - :width: 115 - :target: https://territoires.makina-corpus.com/ - -.. image:: https://geotrek.fr/assets/img/logo_autonomens-h120m.png - :alt: Logo Autonomens - :target: https://datatheca.com/ - ----- - -.. image:: http://geotrek.fr/assets/img/parc_ecrins.png - :alt: Parc national des Ecrins - :target: http://www.ecrins-parcnational.fr - -.. image:: http://geotrek.fr/assets/img/parc_mercantour.png - :alt: Parc national du Mercantour - :target: http://www.mercantour.eu - -.. image:: http://geotrek.fr/assets/img/alpi_maritime.png - :alt: Parco delle Alpi Marittime - :target: http://www.parcoalpimarittime.it