Code source wiki de 3 - Je rédige

Version 64.2 par Camille Herry le 24/04/2024 - 08:00
Afficher les derniers auteurs
1 (((
2 {{box cssClass="floatinginfobox" title="**Sommaire**"}}
3 {{toc/}}
4 {{/box}}
5
6 = Comprendre la structure d'une page =
7
8 [[image:6 (2).png||height="441" width="791"]]
9
10 1. Arborescence de la page
11 1. Titre de la page
12 1. Date de la dernière modification et nom de son éditeur
13 1. Bouton d'action : (((
14 - Modifier la page 
15 - Créer une sous page 
16 - [[image:1694002492349-273.PNG]] Accéder aux paramètres supplémentaires (export, suppression ...)
17 )))
18 1. Contenu de la page
19 1. Créateur de la page et date de la dernière modification
20 1. Zone d'onglets : les commentaires, les pièces jointes, l'historique et les informations.
21 )))
22
23 (((
24 = Créer une page =
25
26 1. (((
27 Allez sur la page dans laquelle la nouvelle page doit être créée (il est aussi possible de modifier l’emplacement de la page depuis l’écran de création).
28 )))
29 1. Cliquez sur le bouton « Créer » dans le menu contextuel en haut à droite 
30 [[image:Accueil-XWiki (1).png||height="124" width="1000"]]
31 1. Ensuite, vous verrez cet écran :
32 Ici, vous pouvez définir un titre et sélectionner le type de document que vous souhaitez créer.[[image:Design sans titre.png||height="500" width="1000"]](((
33 1 : Titre : Le titre de la page apparaitra dans le fil d'Ariane.
34 {{warning title="Attention"}}Le titre est différent du nom de la page, qui est l'identifiant présent dans l'URL de la page.
35 Il faut donc privilégier un court identifiant pour le nom de la page{{/warning}}
36 2 : Emplacement : L’URL du document sera directement liée à l’emplacement du document dans l’arbre des pages.
37 3 : Type de page : Choix de l'agencement de base de la page (une page blanche, ou un modèle de page déjà structurée)
38 )))
39 1. Cliquez sur "Créer" pour commencer à rédiger votre page.
40
41 = Organiser le contenu/ mettre en forme =
42
43 (% class="wikigeneratedid" id="H-1" %)
44 Le wiki utilise l'éditeur WYSIWYG, le formatage standard : titres, texte simple, gras, italique, souligné, barré, indice, exposant, listes, tables, liens…,
45
46 == Ajouter une image ==
47
48 Il existe deux façons pour importer une image :
49
50 * Glisser-déposer l'image directement dans le bloc d'édition ;
51 * Importer l'image depuis l'éditeur.
52
53 {{info}}
54 Les images importées sont automatiquement envoyées en pièce jointe de la page éditée
55 {{/info}}
56
57 (% class="wikigeneratedid" id="HImporterdepuisl27E9diteur:" %)
58 **Importer depuis l'éditeur :**
59
60 1. Cliquez sur le bouton  [[image:imageef1.PNG]] dans l'éditeur
61 1. Allez dans l'onglet "Envoi" 
62 [[image:image2.png||height="305" width="800"]]
63 1. Cliquez sur "Choisir un fichier" pour importer votre image. 
64 Cliquez ensuite sur "Envoyer", et sur "Sélectionnez"
65 1. Vous pouvez maintenant choisir les paramètres d'affichage de votre image (légende, taille…)
66 [[image:imagee3.PNG||height="433" width="800"]]
67 1. Cliquez sur "Insérer" pour intégrer votre image.(((
68
69 )))
70
71 == Ajouter des macros ==
72
73 Les macros sont des extensions qui permettent d'enrichir votre page.
74
75 {{info}}
76 __Retrouvez le comparatif des macros confluence vs macro xwiki dans cette page :__ [[https:~~/~~/xwiki.com/en/confluence-macros-alternatives>>url:https://xwiki.com/en/confluence-macros-alternatives]]
77 {{/info}}
78
79 Pour ajouter une macro, cliquez sur le bouton [[image:boutonplus.PNG]] dans l'éditeur.
80 Exemples de macro :
81
82 (% border="1" class="table-bordered" style="margin-right:auto" %)
83 |(% style="text-align:center; width:474px" %)(((
84 **Table des matières**
85 Génère une table des matières des titres de page
86
87 [[image:toc.png||height="249" width="500"]]
88 )))|(% style="text-align:center; width:537px" %)(((
89 **Caractère spécial **
90
91 Permets d'intègre des caractères spéciaux
92
93 [[image:1694172487802-425.png||height="338" width="400"]]
94
95
96 )))|(% style="width:468px" %)(((
97 (% style="text-align: center;" %)
98 **Message**
99
100 (% style="text-align: center;" %)
101 Affiche un message dans une boite stylisée
102
103
104 [[image:bloc$.PNG||height="249" width="500"]]
105 )))
106 |(% style="width:474px" %)(((
107 (% style="text-align: center;" %)
108 **Arborescence des pages**
109
110 (% style="text-align: center;" %)
111 Affiche la hiérarchie des pages.
112
113 [[image:tree.png]]
114 )))|(% style="text-align:center; width:537px" %)(((
115 **Notifications **
116 Affiche les activités récentes réalisées par les utilisateurs sur les pages.
117
118 [[image:notifications.png]]
119 )))|(% style="width:468px" %)(((
120 (% style="text-align: center;" %)
121 **Graphique **
122 Génère des graphiques à partir de sources de données.
123
124 [[image:chart.png||data-xwiki-image-style-alignment="center" height="249" width="500"]]
125 )))
126 |(% style="width:474px" %)(((
127 (% style="text-align: center;" %)
128 **Ligne horizontale**
129
130 (% style="text-align: center;" %)
131 Ajouter une ligne fine grise au-dessus du texte.
132
133 ----
134
135
136 )))|(% style="width:537px" %)(((
137 (% style="text-align: center;" %)
138 **Fragment de code**
139 Permet d'afficher des lignes de code dans un langage informatique donné.
140
141 (((
142
143 )))
144 )))|(% style="width:468px" %)(((
145 (% style="text-align: center;" %)
146 ...
147 )))
148
149 (% style="color:#1d2d44; font-family:~"Roboto Condensed~",sans-serif; font-size:29px; font-weight:700" %)**Modifier une page**
150 )))
151
152 (((
153 1. Pour modifier une page, cliquez sur le bouton « Modifier » en haut à droite ;
154 [[image:modifierpage.PNG||height="130" width="1000"]]
155 1. Utilisez l'éditeur pour modifier le contenu ;
156 1. Une fois vos modifications terminées, vous pouvez saisir une note dans le bloc "Résumez vos modifications..." pour expliquer ce que vous avez modifié.
157 Si vous sélectionnez le case "Modification mineure" vos modifications n'apparaitront pas directement dans l'historique de la page. [[image:enr.PNG]](((
158
159 )))
160 1. Cliquez ensuite sur "Enregistrer" ou sur "Enregistrer".
161 Après avoir enregistré la page, la nouvelle version contenant votre modification sera immédiatement en ligne.
162
163 = Insérer un lien =
164
165 Il existe plusieurs options pour insérer un lien, après avoir effectué votre sélection, vous cliquez sur le bouton [[image:1713167342021-858.png||data-xwiki-image-style-border="true"]]
166
167 [[image:1713167415618-148.png]]
168
169 * Pour des liens provenant d'autres pages xwiki, il faut privilégier l'insertion de lien par page et pointer la page correspondante, en cas de modification de nom de celle-ci ou de déplacement de la page, le lien inséré sera directement mis à jour.
170 La page peut être recherchée au travers de l'arborescence proposé.
171 * Pour des liens externes à xwiki, il faut utiliser les liens par URL
172
173 Vous avez la possibilité également de préciser si vous souhaitez que le lien s'ouvre dans un "Nouvel onglet", il faudre aller dans l'onglet "Cible" pour définir votre choix, par défaut le lien s'ouvrira dans l'onglet en cours.
174
175 = Rédiger en mode collaboratif =
176
177 Lorsque vous éditez une page, une session collaborative est initiée, elle permet à différents participants qui souhaiteraient contribuer à la documentation de rejoindre la même session que vous.
178
179 [[image:1699514716152-387.png]]
180
181 Si vous souhaitez désactiver cette option pour l'édition en cours, il suffira de décocher la case "Collaboration temps-réel" dans le bas de page.
182
183 [[image:coche.PNG]]
184
185
186 = Visualiser l'historique d'une page =
187
188 Chaque fois que vous apportez une modification à une page dans XWiki, elle est stockée dans l'historique des versions de cette page.
189 Ainsi, vous pouvez facilement revenir à une version précédente d'une page si une modification récente semble erronée.
190 Il est également possible de comparer deux versions d'une page pour voir ce qui a été changé entre elles.
191 \\Pour accéder à l'historique d'une page, cliquez sur "Historique" dans la zone à onglets en bas de la page. (Vous pouvez également trouver l'élément de menu "Historique" en cliquant sur le bouton "Plus d'actions" en haut d'une page.)
192 [[image:3.png||height="682" width="1000"]]
193
194
195 1. Afficher les différentes versions avec l'éditeur et la date et le commentaire (les versions mineures sont masquées par défaut);
196 1. Revenir à une version précédente ;
197 1. Supprimer une version ;
198 1. Comparer deux versions de la même page.
199
200 = Exporter une page =
201
202 1. (((
203 Cliquez sur le bouton [[image:1694002492349-273.PNG]]en haut à droite de la page puis sur "Exporter"
204 [[image:exporter.PNG||height="553" width="1000"]]
205 )))
206 1. (((
207 Vous avez ensuite le choix entre plusieurs formats d'export.
208 [[image:exporter2.PNG||height="322" width="600"]]
209
210 * **Html : **permet d'exporter des pages wiki sous forme de pages HTML statiques indépendantes du moteur XWiki. Toutes les pages sont exportées en mode vue. De cette façon, vous pouvez exporter tout un espace contenant de la documentation et y accéder sur votre ordinateur sans serveur Web.
211 * **XAR : **permet d'exporter des pages au format XML interne utilisé par XWiki. C'est le format que vous pouvez utiliser [[Importer / Exporter>>url:https://platform.xwiki.org/xwiki/bin/view/AdminGuide/ImportExport]] pages et applications dans / à partir des instances XWiki.
212 * **PDF :** génére un fichier PDF.
213 )))
214
215 = Déplacer ou renommer une page =
216
217 1. Cliquez sur le bouton [[image:1694002492349-273.PNG]] en haut à droite de la page puis sur "Déplacer / renommer"?
218 [[image:deplacer.PNG||height="552" width="1000"]]
219 1. Pour chercher un nouvel emplacement à la page, cliquez sur le bouton [[image:renommer - Copie.PNG]] dans la section "Nouvel emplacement". 
220 Une modale apparait alors avec l'arborescence du wiki, sélectionnez le nouvel emplacement et cliquer sur "Sélectionner". 
221 [[image:renommer.PNG||height="333" width="1000"]]
222 {{warning title="Remarque" width="50%"}}Il est possible de cocher l'option "Rediriger vers la nouvelle page", qui permettra de conserver l'ancien lien d'accès à la page lorsqu'elle sera déplacée. Cette redirection sera supprimée, si une nouvelle page est nommée comme la page déplacée, ou si l'arborescence de l'ancienne page est supprimée.
223 Il n'est pas recommandé d'utiliser cette option.{{/warning}}
224
225 1. (((
226 Cliquez sur le bouton "Renommer".
227 )))
228
229 = Supprimer une page =
230
231 1. (((
232 Cliquez sur le bouton [[image:1694002492349-273.PNG]] en haut à droite de la page et sur "Supprimer".
233 [[image:supprimer.PNG||height="558" width="1000"]]
234 )))
235
236 = Gérer la hiérarchie des pages/sous-pages =
237
238 Il n'est pas possible de choisir la hiérarchie des pages enfants dans une page parente. 
239 Les pages sont classés automatiquement par ordre alphabétique. 
240
241
242 ----
243
244 {{include reference="publique.dn.outils.wiki.Test besoin d'aide.WebHome"/}}
245 )))