Documentation utilisateur

[alhyss]

Proposition de plan :

1. Introduction
   1. La démarche → Les objectifs, le rôle du GT PostGIS et du sous-groupe Métadonnées, le Git...
   2. Les grands principes → Principaux choix techniques : stockage en JSON-LD dans les descriptifs PostgreSQL, DCAT... Avec renvoi à la documentation technique pour plus de précisions.
2. Installer et gérer le plugin QGIS Plume
   1. Compatibilité → Essentiellement pour rappeler qu'il faut au moins QGIS 3.10.
   2. Installation
      1. Depuis le dépôt du pôle ministériel → Partant du principe que la publication sur le dépôt sera effective au moment de la mise en production.
      2. Manuellement → ZIP à télécharger sur GitHub + modalités d'installation depuis un ZIP sous QGIS.
   3. Mise à jour
   4. Désinstallation
3. Visualiser les métadonnées d'une couche → En introduction, une capture avec la barre d'outils complète version lecture, et des renvois vers les parties correspondant à chaque bouton.
   1. Ouverture d'une fiche de métadonnées
      1. Lorsque Plume n'est pas encore lancé
      2. Lorsque Plume est lancé
   2. Organisation d'une fiche de métadonnées → Organisation du formulaire, onglet spécifique pour les descriptions de champs, hyperliens cliquables...
   3. Choix du modèle de fiche
   4. Choix de la langue
   5. Visualisation des métadonnées géométriques
   6. Verrouillage de la fiche courante
4. Éditer les métadonnées d'une couche → En introduction, une capture avec la barre d'outils complète version édition, et des renvois vers les parties correspondant à chaque bouton.
   1. Activation et désactivation du mode édition
   2. Manipulation du formulaire de saisie
      1. Saisie d'une valeur → En évoquant les différents types de valeur, les contraintes, les cas de standardisation automatique à l'enregistrement....
      2. Ajout/suppression d'un élément
      3. Choix du thésaurus → Inclut le cas des catégories pour lesquels l'utilisateur a le choix entre une valeur de thésaurus et une description manuelle.
      4. Aide à la saisie des géométries
      5. Calcul côté serveur
   3. Enregistrement
   4. Choix du modèle de fiche → Surtout pour évoquer les différences par rapport au mode lecture, notamment avec les catégories hors modèles mais non vides qui se retrouvent dans l'onglet "Autres".
   5. Traductions
   6. Réinitialisation de la fiche de métadonnées
   7. Copie d'une fiche de métadonnées
   8. Import d'une fiche de métadonnées
      1. Depuis un fichier RDF
      2. Depuis un catalogue distant (CSW)
5. Exporter les métadonnées d'une couche
6. Personnalisation de l'interface
   1. Apparence
   2. Paramètres avancés
7. Gérer les modèles de fiches de métadonnées avec PlumePg → En précisant bien que cette partie-là concerne uniquement l'ADL.
   1. Principe
   2. Gestion de l'extension → _À transférer depuis la documentation technique, sauf pour ce qui concerne la distribution Eole._
      1. Compatibilité
      2. Installation
         1. Sur un serveur PostgreSQL Eole
         2. Sur un autre serveur
      3. Localisation des objets de l'extension
      4. Cohabitation avec Asgard
      5. Mise à jour
         1. Sur un serveur PostgreSQL Eole
         2. Sur un autre serveur
      6. Désinstallation
      7. Sauvegarde et restauration de la base
   3. Construction d'un nouveau modèle
      1. Définition du modèle → _Cf. documentation technique._
      2. Définition des onglets → _Cf. documentation technique._
      3. Définition des catégories de métadonnées → _Cf. documentation technique._
         1. Ajustement des catégories communes
         2. Ajout de catégories locales
      4. Association de catégories de métadonnées au modèle
   4. Suppression d'un modèle
   5. Modèles pré-configurés → _Cf. documentation technique._
8. Assistance

[alhyss]

J'ai édité mon premier message avec une proposition de plan. Évidemment, il n'est pas question de le figer complètement, c'est surtout pour savoir ce que tu en penses, @WREATCHED . Est-ce que je pars là-dessus où vois-tu d'ores-et-déjà des choses à ajouter ou organiser autrement ?

[alhyss]

@WREATCHED Si tu veux mettre dans Plume le lien vers la future doc, c'est celui-ci : https://snum.scenari-community.org/Plume/Documentation.

C'est une coquille vide à ce stade. En plus, la feuille de style n'est pas la bonne, il faut que je vois avec GSG pourquoi Titania n'est plus proposée (y compris d'ailleurs pour Asgard...).

[WREATCHED]

OK, D'ailleurs pour info, j'avais mis les paramètres dans le QGIS3.ini Le type PDF ou HTML Les urls correspondantes