Modifications pour le document Documenter l’aide en ligne

Modifié par Doriane Bautista le 2025/09/17 16:01

Depuis la version 61.1
modifié par Doriane Bautista
sur 2025/09/11 16:33
Commentaire de modification : Il n'y a aucun commentaire pour cette version
À la version 66.1
modifié par Doriane Bautista
sur 2025/09/11 16:42
Commentaire de modification : Il n'y a aucun commentaire pour cette version

Résumé

Détails

Propriétés de la Page
Contenu
... ... @@ -109,19 +109,44 @@
109 109  
110 110  Une fois le champ ou le bloc trouvé, cliquez sur son nom pour ouvrir l’éditeur HTML.
111 111  
112 -Vous pouvez saisir directement votre texte ou copier-coller l’aide du wiki avant de l’adapter à vos besoins internes.
112 +(((
113 +1. **Saisir le contenu**
113 113  
114 -Cet éditeur fonctionne comme un traitement de texte (type Word) et propose de nombreuses options :
115 +* Tapez directement votre texte dans l’éditeur.
116 +* Vous pouvez aussi copier-coller l’aide issue du wiki et l’adapter à vos besoins internes.
115 115  
116 -* **Mise en forme du texte** : gras, italique, souligné, exposant, indice.
117 -* **Organisation du contenu** : listes à puces, listes numérotées, retrait, alignement.
118 -* **Styles et formats** : titres, styles prédéfinis, choix de la police et de la taille.
119 -* **Tableaux et images** : insertion et gestion de tableaux, ajout d’images.
120 -* **Éléments enrichis** : caractères spéciaux, symboles.
121 -* **Outils pratiques** : correcteur orthographique, recherche/remplacement, annuler/rétablir, affichage du code source.
118 +(% class="box successmessage" %)
119 +(((
120 +**Bonnes pratiques : **
122 122  
123 -Une fois votre saisie terminée, cliquez sur **Sauvegarder** pour enregistrer votre personnalisation. **Dès la sauvegarde, l’aide en ligne par défaut issue du wiki est remplacée par votre aide personnalisée** : celle-ci ne s’affichera que dans votre base de données institutionnelle et n’aura aucun impact sur le wiki ni sur les autres musées.
122 +**Présentation et clarté**
124 124  
124 +* Uniformisez la présentation : adoptez une structure homogène (définition, usage, remarques).
125 +* Soyez clairs et concis : rédigez des explications courtes et directement utiles.
126 +* Employez le vocabulaire métier partagé : utilisez les termes définis dans la charte de saisie de votre institution.
127 +
128 +**Contenu et cohérence**
129 +
130 +* Précisez le contexte : indiquez si le champ ou bloc est lié à un processus particulier (inventaire, récolement, prêt, dépôt, restauration).
131 +* Ajoutez des exemples concrets : illustrez les valeurs attendues pour éviter toute ambiguïté.
132 +* Limitez les redondances : n’intégrez que ce qui est pertinent, sans recopier inutilement l’aide du wiki.
133 +* Documentez aussi les blocs de champs : expliquez leur rôle global en plus des champs qu’ils contiennent.
134 +)))
135 +)))
136 +
137 +(((
138 +(% start="2" %)
139 +1. **Mettre en forme l’aide**
140 +
141 +* L’éditeur fonctionne comme un traitement de texte (type Word) et vous permet d’appliquer différents outils :
142 +** **Mise en forme du texte** : gras, italique, souligné, exposant, indice.
143 +** **Organisation du contenu** : listes à puces, listes numérotées, retrait, alignement.
144 +** **Styles et formats** : titres, styles prédéfinis, choix de la police et de la taille.
145 +** **Tableaux et images** : insertion et gestion de tableaux, ajout d’images.
146 +** **Éléments enrichis** : caractères spéciaux, symboles.
147 +** **Outils pratiques** : correcteur orthographique, recherche/remplacement, annuler/rétablir, affichage du code source.
148 +)))
149 +
125 125  (% class="box warningmessage" %)
126 126  (((
127 127  **Point d’attention : insérer des liens**
... ... @@ -130,18 +130,20 @@
130 130  * Copiez-collez ensuite ce lien dans l’éditeur d’aide en ligne. Il sera reconnu correctement et restera actif.
131 131  )))
132 132  
158 +(((
159 +(% start="3" %)
160 +1. **Sauvegarder la personnalisation**
161 +
162 +* Cliquez sur **Sauvegarder** pour enregistrer vos modifications.
163 +* Dès la sauvegarde, l’aide en ligne du wiki disparaît : elle est remplacée par votre aide personnalisée.
164 +* Cette personnalisation ne s’applique que dans votre base institutionnelle et n’a aucun impact sur le wiki ni sur les autres musées.
165 +)))
166 +
133 133  (% class="box successmessage" %)
134 134  (((
135 135  **Bonnes pratiques : **
136 136  
137 -* **Uniformisez la présentation** : adoptez une structure homogène (définition, usage, remarques).
138 -* **Soyez clairs et concis** : rédigez des explications courtes et directement utiles.
139 -* **Employez le vocabulaire métier partagé** : utilisez les termes définis dans la charte de saisie de votre institution.
140 -* **Précisez le contexte** : indiquez si le champ ou bloc est lié à un processus particulier (inventaire, récolement, prêt, dépôt, restauration).
141 -* **Ajoutez des exemples concrets** : illustrez les valeurs attendues pour éviter toute ambiguïté.
142 -* **Limitez les redondances** : n’intégrez que ce qui est pertinent, sans recopier inutilement l’aide du wiki.
143 -* **Documentez aussi les blocs de champs** : expliquez leur rôle global en plus des champs qu’ils contiennent.
144 -* **Conservez une mémoire interne** : gardez une copie (Word, tableur, etc.) de vos aides personnalisées pour en assurer le suivi et la maintenance lors des mises à jour Flora.
171 +* Conservez une mémoire interne : gardez une copie (Word, tableur, etc.) de vos aides personnalisées pour en assurer le suivi et la maintenance lors des mises à jour Flora
145 145  )))
146 146  
147 147  >(% class="small" %)L’exemple ci-dessous illustre le champ **Numéro d’inventaire** avec une aide en ligne enrichie :
... ... @@ -165,7 +165,7 @@
165 165  (% class="wikigeneratedid" id="H200B200B200B200B200B200B200B200B200B200B200B200B200B200B" %)
166 166  ​​​​​​​​​​​​​​
167 167  
168 -[[//Sauvegarde de l'aide en ligne//>>image:1757597668258-471.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
195 +[[//Sauvegarder l'aide en ligne//>>image:1757597668258-471.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
169 169  
170 170  
171 171  = Contrôler le rendu dans Flora =
... ... @@ -201,7 +201,7 @@
201 201  
202 202  **Résultat :** l’aide en ligne personnalisée disparaît et l’aide générique du wiki réapparaît automatiquement pour ce champ ou ce bloc.
203 203  
204 -[[//Repérage nom interne du champ - survol//>>image:1757599364051-795.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
231 +[[//Repérage nom interne du champ - survol d'un champ//>>image:1757599364051-795.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]
205 205  
206 206  
207 207  [[//Choix de **la source** et de la** table**//>>image:1757599467798-396.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]