diff --git a/docs-users/fr/tutorials/10-embed-remote-data.md b/docs-users/fr/tutorials/10-embed-remote-data.md index be665ef8..cfa611c7 100644 --- a/docs-users/fr/tutorials/10-embed-remote-data.md +++ b/docs-users/fr/tutorials/10-embed-remote-data.md @@ -7,6 +7,7 @@ - Utiliser un portail *open data* - Créditer la source des données pour respecter la licence + ## Procédons par étapes Jusqu’ici toutes les cartes que nous avons créées montrent des données @@ -156,8 +157,11 @@ calque*. Les différents types de calques sont : cercle. - **Heatmap** : les données sont représentées sous forme de *carte de chaleur*. -- **Cloroplèthe** : cet affichage est adapté aux polygones, et permet +- **Choroplèthe** : cet affichage est adapté aux polygones, et permet de graduer leur couleur. +- **Cercles proportionnels** : cette représentation est adaptée pour + des valeurs quantitatives absolues (qui peuvent s’ajouter). + La surface des cercles est proportionnelle à la quantité. Les types *Avec cluster* et *Heatmap* sont plutôt adaptés aux calques contenant uniquement des points. Lorsqu’on choisit un de ces modes, un diff --git a/docs-users/fr/tutorials/12-display-grist-data.md b/docs-users/fr/tutorials/12-display-grist-data.md new file mode 100644 index 00000000..f6f819d0 --- /dev/null +++ b/docs-users/fr/tutorials/12-display-grist-data.md @@ -0,0 +1,141 @@ +!!! abstract "Ce que nous allons apprendre" + + - Créer un gabarit Grist compatible uMap + - Géocoder des adresses (:fontawesome-solid-landmark-flag: pour les agents publics seulement) + - Rendre un document Grist public + - Lier le CSV de Grist avec un calque uMap + + +Un [un film tutoriel](https://tube.numerique.gouv.fr/w/kya6m1aFtgDcy2LMkgUBya?start=12s) +a été créé pour montrer le déroulé de ce tutoriel. + + +## 1. Créer un gabarit Grist compatible uMap + +!!! osm-instance "Pour le grand public, les associations…" + + Rendez-vous sur le [site officiel de Grist](https://www.getgrist.com/) ou votre propre instance. + +!!! french-instance "Pour les agents publics" + + Rendez-vous sur le site Grist agents publics via + [La Suite Numérique](https://lasuite.numerique.gouv.fr/services/grist). + +Créer un nouveau document vide : + +![Interface pour créer un nouveau document Grist.](../../static/tutoriels/grist-new-document.png) + +Ajouter les colonnes nécessaires, plus au moins ces trois colonnes : `Adresse`, `Latitude`, `Longitude`. + +![Interface d’un nouveau document Grist vide.](../../static/tutoriels/grist-empty-document.png) + + +!!! warning + + Attention, il faut mettre les colonnes `Latitude` et `Longitude` en type `Texte` : + + ![Interface pour renseigner le type des colonnes.](../../static/tutoriels/grist-column-type-text.png) + + +## 2. Géocoder des adresses (:fontawesome-solid-landmark-flag: pour les agents publics seulement) + +!!! french-instance "Pour les agents publics" + + Cette conversion n’est accessible qu’aux agents publics, elle consiste + à convertir automatiquement les adresses en coordonnées géographiques + (latitude, longitude). Si vous avez déjà ces informations dans votre + document, vous pouvez passer à l’étape 3 ci-dessous. + + +Il faut maintenant ajouter l’outil de géocodage développé par l’ANCT. +Pour ça, cliquer sur « Ajouter une vue à la page » : + +![Interface pour créer une vue Grist.](../../static/tutoriels/grist-empty-view.png) + + +Puis choisir `Custom`, sélectionner le nom de la table dans la source des données +(ici « Table1 »), et aussi sélectionner la table dans `Select by` : + +![Interface pour créer une vue custom Grist.](../../static/tutoriels/grist-custom-view.png) + +Dans la colonne de droite, si on est sur l’instance Grist de l’ANCT, +choisir « Geocodeur » dans la liste déroulante, +sinon choisir `Custom URL` et ajouter l’URL suivante: + + + +Dans le panneau de droite, sélectionner les colonnes permettant de connecter +l’outil à notre tableau : + +![Interface pour associer les colonnes sur une vue Grist.](../../static/tutoriels/grist-columns-view.png) + +La colonne `Adresse` comme source, puis bien référence les colonnes `Latitude` et `Longitude`. + +On peut optionnellement ajouter une colonne `Adresse normalisée` (dans le tableur) +et la référencer ici, dans ce cas le géocodeur affichera l’adresse qu’il a trouvé. +Ça permet un contrôle de plus. + +Renseigner ensuite une ou plusieurs lignes de données, +en essayant d’avoir une adresse aussi précise que possible : + +![Interface pour convertir via une vue Grist.](../../static/tutoriels/grist-conversion-view.png) + +Puis cliquer sur « Traitement spécifique » pour ne traiter +que la ligne sélectionnée, ou bien sur « Traitement global » +pour traiter toutes les lignes du document. + +![Interface pour convertir via une vue Grist (résultat).](../../static/tutoriels/grist-conversion-view-result.png) + + +## 3. Rendre un document Grist public + +Il faut ensuite rendre le document Grist public pour pouvoir ensuite le référencer côté uMap. + +Pour ça, aller dans « Gérer les utilisateurs » : + +![Interface pour gérer les utilisateurs dans Grist.](../../static/tutoriels/grist-user-management.png) + +Puis activer l’accès public : + +![Interface pour ouvrir les permissions dans Grist.](../../static/tutoriels/grist-permissions-management.png) + + +## 4. Lier le CSV de Grist avec un calque uMap + +Pour copier l’URL qu’on va indiquer côté uMap, c’est ici +(clic droit « enregistrer le lien ») : + +![Interface pour copier le lien vers l’export CSV dans Grist.](../../static/tutoriels/grist-download-csv.png) + +Le lien devrait ressembler à quelque chose comme ça : + +https://grist.incubateur.net/o/docs/api/docs/4McELEs6kBpQAkmzupHy9F/download/csv?viewSection=1&tableId=Table1&activeSortSpec=%5B%5D&filters=%5B%5D&linkingFilter=%7B%22filters%22%3A%7B%7D%2C%22operations%22%3A%7B%7D%7D + +Maintenant, créer une carte sur uMap et ajouter un calque : + +![Interface pour ajouter un calque dans uMap.](../../static/tutoriels/grist-umap-newlayer.png) + +![Interface pour ajouter un calque dans uMap avec un nom.](../../static/tutoriels/grist-umap-newlayer-name.png) + +Dans « Données distantes », ajouter l’URL de Grist et choisir le format `CSV` : + +![Interface pour ajouter un calque dans uMap avec une URL.](../../static/tutoriels/grist-umap-newlayer-url.png) + +Pour une meilleure expérience utilisateurs, vous pouvez choisir +l’option `Proxy` avec un cache de la bonne durée selon la fréquence +de mise à jour des données dans Grist : + +![Interface pour ajouter un calque dans uMap avec un proxy.](../../static/tutoriels/grist-umap-newlayer-proxy.png) + +Pour améliorer l'intégration des données, allez dans les paramètres avancés +de la carte, puis dans les propriétés par défaut et : + +- ajouter `Nom` comme clé pour le libellé, le filtre et la recherche +- ajouter `Catégorie` pour générer des filtres automatiques + +![Interface pour ajouter un calque avec des filtres dans uMap.](../../static/tutoriels/grist-umap-newlayer-advanced.png) + +Et voilà ! + +![Interface de la carte finale dans uMap.](../../static/tutoriels/grist-umap-result.png) + diff --git a/docs-users/fr/tutorials/2-first-map.md b/docs-users/fr/tutorials/2-first-map.md index a7207789..713e5e24 100644 --- a/docs-users/fr/tutorials/2-first-map.md +++ b/docs-users/fr/tutorials/2-first-map.md @@ -11,14 +11,14 @@ lieux (domicile, vacances, travail, etc.). Procédons par étapes. ### 1. Le mode édition -#### Pour le grand public, les associations… +!!! osm-instance "Pour le grand public, les associations…" -Rendez-vous sur l’instance uMap d’OSM + Rendez-vous sur l’instance uMap d’OSM -#### Pour les agents publics +!!! french-instance "Pour les agents publics" -Rendez-vous sur le site uMap agents publics -et connectez-vous en haut à gauche. La connexion utilise MonComptePro. + Rendez-vous sur le site uMap agents publics + et connectez-vous en haut à gauche. La connexion utilise MonComptePro. +#### :fontawesome-solid-landmark-flag: Pour les agents publics + +1. Se connectez à MonComptePro :
Toute personne qui travaille pour un service public y a accès. 2. Créez un compte sur MonComptePro. L’opération prend quelques minutes. 3. Sur [le site uMap pour les agents publics](https://umap.incubateur.anct.gouv.fr/fr/), @@ -70,7 +71,7 @@ récipiendaires ne pourront pas modifier vos cartes. Le tableau de bord s’ouvre, il affiche l’ensemble des cartes que vous créez ainsi que les équipes auxquelles vous participez. -!!! note "Pour les agents publics" +!!! french-instance "Pour les agents publics" Associer une carte à une équipe vous permet d’afficher le nom de cette équipe au lieu du vôtre sur une carte (noms de votre commune, de votre service,…). Une équipe peut se composer d’une seule personne. ### 2. Créer une équipe diff --git a/docs-users/static/tutoriels/grist-column-type-text.png b/docs-users/static/tutoriels/grist-column-type-text.png new file mode 100644 index 00000000..6d19c3ce Binary files /dev/null and b/docs-users/static/tutoriels/grist-column-type-text.png differ diff --git a/docs-users/static/tutoriels/grist-columns-view.png b/docs-users/static/tutoriels/grist-columns-view.png new file mode 100644 index 00000000..8fbc2c8d Binary files /dev/null and b/docs-users/static/tutoriels/grist-columns-view.png differ diff --git a/docs-users/static/tutoriels/grist-conversion-view-result.png b/docs-users/static/tutoriels/grist-conversion-view-result.png new file mode 100644 index 00000000..c7a78ce6 Binary files /dev/null and b/docs-users/static/tutoriels/grist-conversion-view-result.png differ diff --git a/docs-users/static/tutoriels/grist-conversion-view.png b/docs-users/static/tutoriels/grist-conversion-view.png new file mode 100644 index 00000000..bf174668 Binary files /dev/null and b/docs-users/static/tutoriels/grist-conversion-view.png differ diff --git a/docs-users/static/tutoriels/grist-custom-view.png b/docs-users/static/tutoriels/grist-custom-view.png new file mode 100644 index 00000000..5e6acb1f Binary files /dev/null and b/docs-users/static/tutoriels/grist-custom-view.png differ diff --git a/docs-users/static/tutoriels/grist-download-csv.png b/docs-users/static/tutoriels/grist-download-csv.png new file mode 100644 index 00000000..c30ccfd8 Binary files /dev/null and b/docs-users/static/tutoriels/grist-download-csv.png differ diff --git a/docs-users/static/tutoriels/grist-empty-document.png b/docs-users/static/tutoriels/grist-empty-document.png new file mode 100644 index 00000000..9fdd188d Binary files /dev/null and b/docs-users/static/tutoriels/grist-empty-document.png differ diff --git a/docs-users/static/tutoriels/grist-empty-view.png b/docs-users/static/tutoriels/grist-empty-view.png new file mode 100644 index 00000000..a5e65fa7 Binary files /dev/null and b/docs-users/static/tutoriels/grist-empty-view.png differ diff --git a/docs-users/static/tutoriels/grist-new-document.png b/docs-users/static/tutoriels/grist-new-document.png new file mode 100644 index 00000000..b1c3ce2d Binary files /dev/null and b/docs-users/static/tutoriels/grist-new-document.png differ diff --git a/docs-users/static/tutoriels/grist-permissions-management.png b/docs-users/static/tutoriels/grist-permissions-management.png new file mode 100644 index 00000000..c0c2e825 Binary files /dev/null and b/docs-users/static/tutoriels/grist-permissions-management.png differ diff --git a/docs-users/static/tutoriels/grist-umap-newlayer-advanced.png b/docs-users/static/tutoriels/grist-umap-newlayer-advanced.png new file mode 100644 index 00000000..f947b530 Binary files /dev/null and b/docs-users/static/tutoriels/grist-umap-newlayer-advanced.png differ diff --git a/docs-users/static/tutoriels/grist-umap-newlayer-name.png b/docs-users/static/tutoriels/grist-umap-newlayer-name.png new file mode 100644 index 00000000..b7383149 Binary files /dev/null and b/docs-users/static/tutoriels/grist-umap-newlayer-name.png differ diff --git a/docs-users/static/tutoriels/grist-umap-newlayer-proxy.png b/docs-users/static/tutoriels/grist-umap-newlayer-proxy.png new file mode 100644 index 00000000..5c54c17e Binary files /dev/null and b/docs-users/static/tutoriels/grist-umap-newlayer-proxy.png differ diff --git a/docs-users/static/tutoriels/grist-umap-newlayer-url.png b/docs-users/static/tutoriels/grist-umap-newlayer-url.png new file mode 100644 index 00000000..6829c55d Binary files /dev/null and b/docs-users/static/tutoriels/grist-umap-newlayer-url.png differ diff --git a/docs-users/static/tutoriels/grist-umap-newlayer.png b/docs-users/static/tutoriels/grist-umap-newlayer.png new file mode 100644 index 00000000..d64ee98d Binary files /dev/null and b/docs-users/static/tutoriels/grist-umap-newlayer.png differ diff --git a/docs-users/static/tutoriels/grist-umap-result.png b/docs-users/static/tutoriels/grist-umap-result.png new file mode 100644 index 00000000..cb04033e Binary files /dev/null and b/docs-users/static/tutoriels/grist-umap-result.png differ diff --git a/docs-users/static/tutoriels/grist-user-management.png b/docs-users/static/tutoriels/grist-user-management.png new file mode 100644 index 00000000..a34fd94b Binary files /dev/null and b/docs-users/static/tutoriels/grist-user-management.png differ diff --git a/docs-users/stylesheets/extra.css b/docs-users/stylesheets/extra.css index ded19ade..e061a9bc 100644 --- a/docs-users/stylesheets/extra.css +++ b/docs-users/stylesheets/extra.css @@ -3,4 +3,30 @@ } .md-typeset a { color: #7990be !important; -} \ No newline at end of file +} + +:root { + --md-admonition-icon--french-instance: url('data:image/svg+xml;charset=utf-8,'); + --md-admonition-icon--osm-instance: url('data:image/svg+xml;charset=utf-8,'); +} +.md-typeset .admonition.french-instance, +.md-typeset details.french-instance { + border-color: rgb(0, 0, 145); +} +.md-typeset .french-instance > .admonition-title::before, +.md-typeset .french-instance > summary::before { + background-color: rgb(0, 0, 145); + -webkit-mask-image: var(--md-admonition-icon--french-instance); + mask-image: var(--md-admonition-icon--french-instance); +} + +.md-typeset .admonition.osm-instance, +.md-typeset details.osm-instance { + border-color: #77cc6d; +} +.md-typeset .osm-instance > .admonition-title::before, +.md-typeset .osm-instance > summary::before { + background-color: #77cc6d; + -webkit-mask-image: var(--md-admonition-icon--osm-instance); + mask-image: var(--md-admonition-icon--osm-instance); +} diff --git a/docs-users/tutorials/12-display-grist-data.md b/docs-users/tutorials/12-display-grist-data.md new file mode 100644 index 00000000..a8a0b308 --- /dev/null +++ b/docs-users/tutorials/12-display-grist-data.md @@ -0,0 +1,4 @@ +!!! example "This is an ongoing work." + + [Let us know](https://github.com/umap-project/umap/issues) + if you are interested [to translate it from French](/fr/tutorials/12-display-grist-data/).