Modifications pour le document Documenter l’aide en ligne
Modifié par Doriane Bautista le 2025/09/17 16:01
Depuis la version 65.1
modifié par Doriane Bautista
sur 2025/09/11 16:40
sur 2025/09/11 16:40
Commentaire de modification :
Il n'y a aucun commentaire pour cette version
À la version 70.1
modifié par Doriane Bautista
sur 2025/09/17 16:00
sur 2025/09/17 16:00
Commentaire de modification :
Il n'y a aucun commentaire pour cette version
Résumé
-
Propriétés de la Page (1 modifications, 0 ajouts, 0 suppressions)
Détails
- Propriétés de la Page
-
- Contenu
-
... ... @@ -33,30 +33,6 @@ 33 33 ))) 34 34 ))) 35 35 36 -(% class="box successmessage" %) 37 -((( 38 -**Bonnes pratiques : ** 39 - 40 -**Présentation et lisibilité** 41 - 42 -* Uniformisez la présentation : adoptez une structure homogène pour toutes vos aides (ex. : définition, usage, remarques). 43 -* Soyez clairs et concis : rédigez des explications courtes et immédiatement compréhensibles. 44 -* Employez le vocabulaire métier partagé : utilisez les termes définis dans la charte de saisie de votre institution. 45 -* Ajoutez des exemples concrets : illustrez les valeurs attendues afin d’éviter toute ambiguïté. 46 - 47 -**Contenu et cohérence métier** 48 - 49 -* Précisez le contexte d’utilisation : indiquez si le champ ou le bloc est lié à un processus particulier (inventaire, récolement, prêt, dépôt, restauration). 50 -* Limitez les redondances : n’intégrez que ce qui est pertinent, sans recopier inutilement l’aide du wiki. 51 -* Documentez aussi les blocs de champs : expliquez leur rôle global en plus des champs qu’ils contiennent. 52 - 53 -**Suivi et maintenance** 54 - 55 -* 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. 56 -* Vérifiez l’accessibilité : testez l’ouverture des pop-up d’aide dans les navigateurs utilisés. 57 -* Mettez à jour régulièrement : adaptez vos contenus lorsque vos procédures internes ou règles métier évoluent. 58 -))) 59 - 60 60 = Identifier le nom interne du champ ou du bloc = 61 61 62 62 Pour retrouver le fichier d’aide correspondant, vous devez d’abord identifier le nom interne du champ ou du bloc de champs. Pour cela : ... ... @@ -109,22 +109,43 @@ 109 109 110 110 Une fois le champ ou le bloc trouvé, cliquez sur son nom pour ouvrir l’éditeur HTML. 111 111 112 - *(((113 -**Saisir le contenu** 88 +((( 89 +1. **Saisir le contenu** 114 114 115 115 * Tapez directement votre texte dans l’éditeur. 116 116 * Vous pouvez aussi copier-coller l’aide issue du wiki et l’adapter à vos besoins internes. 93 + 94 +(% class="box successmessage" %) 95 +((( 96 +**Bonnes pratiques : ** 97 + 98 +**Présentation et clarté** 99 + 100 +* Uniformisez la présentation : adoptez une structure homogène pour toutes vos aides (ex. : définition, usage, remarques). 101 +* Soyez clairs et concis : rédigez des explications courtes et immédiatement compréhensibles. 102 +* Employez le vocabulaire métier partagé : utilisez les termes définis dans la charte de saisie de votre institution. 103 +* Ajoutez des exemples concrets : illustrez les valeurs attendues afin d’éviter toute ambiguïté. 104 + 105 +**Contenu et cohérence** 106 + 107 +* Précisez le contexte : indiquez si le champ ou bloc est lié à un processus particulier (inventaire, récolement, prêt, dépôt, restauration). 108 +* Ajoutez des exemples concrets : illustrez les valeurs attendues pour éviter toute ambiguïté. 109 +* Limitez les redondances : n’intégrez que ce qui est pertinent, sans recopier inutilement l’aide du wiki. 110 +* Documentez aussi les blocs de champs : expliquez leur rôle global en plus des champs qu’ils contiennent. 117 117 ))) 118 -* ((( 119 -**Mettre en forme l’aide** 120 -L’éditeur fonctionne comme un traitement de texte (type Word) et vous permet d’appliquer différents outils : 112 +))) 121 121 122 -* **Mise en forme du texte** : gras, italique, souligné, exposant, indice. 123 -* **Organisation du contenu** : listes à puces, listes numérotées, retrait, alignement. 124 -* **Styles et formats** : titres, styles prédéfinis, choix de la police et de la taille. 125 -* **Tableaux et images** : insertion et gestion de tableaux, ajout d’images. 126 -* **Éléments enrichis** : caractères spéciaux, symboles. 127 -* **Outils pratiques** : correcteur orthographique, recherche/remplacement, annuler/rétablir, affichage du code source. 114 +((( 115 +(% start="2" %) 116 +1. **Mettre en forme l’aide** 117 + 118 +* L’éditeur fonctionne comme un traitement de texte (type Word) et vous permet d’appliquer différents outils : 119 +** **Mise en forme du texte** : gras, italique, souligné, exposant, indice. 120 +** **Organisation du contenu** : listes à puces, listes numérotées, retrait, alignement. 121 +** **Styles et formats** : titres, styles prédéfinis, choix de la police et de la taille. 122 +** **Tableaux et images** : insertion et gestion de tableaux, ajout d’images. 123 +** **Éléments enrichis** : caractères spéciaux, symboles. 124 +** **Outils pratiques** : correcteur orthographique, recherche/remplacement, annuler/rétablir, affichage du code source. 128 128 ))) 129 129 130 130 (% class="box warningmessage" %) ... ... @@ -135,8 +135,9 @@ 135 135 * Copiez-collez ensuite ce lien dans l’éditeur d’aide en ligne. Il sera reconnu correctement et restera actif. 136 136 ))) 137 137 138 -* ((( 139 -**Sauvegarder la personnalisation** 135 +((( 136 +(% start="3" %) 137 +1. **Sauvegarder la personnalisation** 140 140 141 141 * Cliquez sur **Sauvegarder** pour enregistrer vos modifications. 142 142 * Dès la sauvegarde, l’aide en ligne du wiki disparaît : elle est remplacée par votre aide personnalisée. ... ... @@ -143,31 +143,12 @@ 143 143 * Cette personnalisation ne s’applique que dans votre base institutionnelle et n’a aucun impact sur le wiki ni sur les autres musées. 144 144 ))) 145 145 146 -(% class="box warningmessage" %) 147 -((( 148 - 149 -))) 150 - 151 151 (% class="box successmessage" %) 152 152 ((( 153 153 **Bonnes pratiques : ** 154 154 155 -**Présentation et clarté** 156 - 157 -* Uniformisez la présentation : adoptez une structure homogène (définition, usage, remarques). 158 -* Soyez clairs et concis : rédigez des explications courtes et directement utiles. 159 -* Employez le vocabulaire métier partagé : utilisez les termes définis dans la charte de saisie de votre institution. 160 - 161 -**Contenu et cohérence** 162 - 163 -* Précisez le contexte : indiquez si le champ ou bloc est lié à un processus particulier (inventaire, récolement, prêt, dépôt, restauration). 164 -* Ajoutez des exemples concrets : illustrez les valeurs attendues pour éviter toute ambiguïté. 165 -* Limitez les redondances : n’intégrez que ce qui est pertinent, sans recopier inutilement l’aide du wiki. 166 -* Documentez aussi les blocs de champs : expliquez leur rôle global en plus des champs qu’ils contiennent. 167 - 168 -**Suivi et maintenance** 169 - 170 -* 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 148 +* 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. 149 +* Mettez à jour régulièrement : adaptez vos contenus lorsque vos procédures internes ou règles métier évoluent. 171 171 ))) 172 172 173 173 >(% class="small" %)L’exemple ci-dessous illustre le champ **Numéro d’inventaire** avec une aide en ligne enrichie : ... ... @@ -227,7 +227,7 @@ 227 227 228 228 **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. 229 229 230 -[[//Repérage nom interne du champ - survol d 'unchamp//>>image:1757599364051-795.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]209 +[[//Repérage nom interne du champ - une infobulle apparait avec le survol du champ//>>image:1757599364051-795.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]] 231 231 232 232 233 233 [[//Choix de **la source** et de la** table**//>>image:1757599467798-396.png||data-xwiki-image-style-alignment="center" data-xwiki-image-style-border="true"]]