Modifié par Xavier Richard le 10/06/2023 à 23:26
Afficher les derniers auteurs
1 {{numberedheadings/}}
2
3 (% class="floatinginfobox" %)
4 (((
5 **Sommaire**
6
7 {{toc numbered="true"/}}
8 )))
9
10 Cette page permet de recenser tous les paramétrages et développements spécifiques réalisés sur le Wiki.
11
12 L'objectif est de pouvoir accélérer ou reproduire les paramétrages (par exemple à l'issu d'une migration ou lors de la création d'un nouveau Wiki qui devrait reprendre les mêmes paramétrages).
13
14
15 [[Voir ce qu'il reste à faire>>doc:1XWikiCustomXRI.ToDoNew]].
16
17
18 = Personnaliser la traduction =
19
20 * Accès à la [[page custom contenant les traductions personnalisées>>doc:1XWikiCustomXRI.TraductionPersonnelleXWiki]]. (!) Il faut modifier la page en mode **Source **et non WYSIWIG. Note : cette page était initialement stockée dans Main pour éviter les problèmes de caractère "espace" dans le nom de l'espace / de la page, finalement elle a été déplacée dans un espace dédié aux personnalisations de XWiki, espace qui respecte ces contraintes de nommage.
21 * Cette page doit être déclarée dans l'admin du Wiki (= nom de page personnalisable) : **Contenu **> **Localisation**, zone en bas. Saisir le page sous la forme {{code}}ESPACE.PAGE{{/code}}
22 * La dernière version "officielle" des fichiers de traduction de XWiki est ici (utiliser le fichier _fr pour retrouver le nom des clefs de trad à partir des libellés affichés dans XWiki) : [[https:~~/~~/github.com/xwiki/xwiki-platform/tree/master/xwiki-platform-core/xwiki-platform-oldcore/src/main/resources>>url:https://github.com/xwiki/xwiki-platform/tree/master/xwiki-platform-core/xwiki-platform-oldcore/src/main/resources||rel="__blank"]]
23 * Aide officielle : [[https:~~/~~/network.xwiki.com/xwiki/bin/view/DocXE41Fr/EditerPreferencesLocalisation#HC9criredesapplicationsXWikiinternationalisE9es>>url:https://network.xwiki.com/xwiki/bin/view/DocXE41Fr/EditerPreferencesLocalisation#HC9criredesapplicationsXWikiinternationalisE9es||rel="__blank"]]
24
25 = Configurer le Wiki =
26
27 (% style="font-family:sans-serif; font-size:14px; font-style:normal; line-height:19.600000381469727px; text-align:start" %)Se connecter en admin (xrichard) puis :
28
29 == Paramétrer le format date - heure ==
30
31 * Dans le Configuration du Wiki > **Localisation **> **FORMAT DES DATES** indiquer :
32 {{code}}dd/MM/yyyy HH:mm{{/code}}
33
34 == Désactiver les suggestions de recherche ==
35
36 * Modifier l'option dans [[http:~~/~~/tutos.myxwiki.org/xwiki/bin/admin/XWiki/XWikiPreferences?editor=globaladmin&section=searchSuggest>>url:http://tutos.myxwiki.org/xwiki/bin/admin/XWiki/XWikiPreferences?editor=globaladmin&section=searchSuggest||rel="__blank"]]
37
38 == Désactiver les Annotations ==
39
40 * Editer la section "Annotation" dans la configuration du Wiki [[http:~~/~~/tutos.myxwiki.org/xwiki/bin/admin/XWiki/XWikiPreferences?editor=globaladmin&section=Annotations>>url:http://tutos.myxwiki.org/xwiki/bin/admin/XWiki/XWikiPreferences?editor=globaladmin&section=Annotations||rel="__blank"]]
41
42 == Personnaliser le texte de la barre titre du navigateur Web ==
43
44 * [[http://tutos.myxwiki.org/xwiki/bin/admin/XWiki/XWikiPreferences?editor=globaladmin&section=Elements&space=XWiki||rel="__blank"]]
45 * dans la zone "Titre", indiquer le code :
46 {{code}}$tdoc.getRenderedTitle("plain/1.0") - Les tutos de Toto - XWiki{{/code}}
47
48 == Personnaliser le pied de page ==
49
50 * **Objectifs **: logo "Powered By XWiki" + indication de la version XWiki utilisée (présente en standard) + lien d'envoi d'un mail + licence Creative Common pour ré-utiliser le contenu XRI ; le tout en limitant la hauteur / place occupée
51 * Allez sur la page d'admin [[http://tutos.myxwiki.org/xwiki/bin/admin/XWiki/XWikiPreferences?editor=globaladmin&section=Presentation&space=XWiki||rel="__blank"]] puis dans la section "Pied de page"
52 ** /!\ Attention : la taille (nombre de caractères) de ces champ est réduit en BDD
53 ** dans la zone 1 "Copyright", indiquez le code :
54 {{code language="html"}}<a title="xwiki.org" target="_blank" href="http://www.xwiki.org"><img src="http://www.ip-m.com/skins/toucanet/xwiki-powered.png"></a> <b>version $xwiki.getVersion()</b> - <a href="mailto:<ldmpub@gmail.com>?subject=Les Tutos de Toto">Contactez-moi</a>{{/code}}
55 ** dans la zone 2 "Version", indiquez le code :
56 {{code language="html"}}Vous pouvez ré-utiliser le contenu de ce site : <a title="Creative Commons BY-NC" target="_blank" href="https://creativecommons.org/licenses/by-nc/4.0/deed.fr"><img src="https://i.creativecommons.org/l/by-nc/4.0/80x15.png"></a>{{/code}}
57
58 == Ajouter un Favicon ==
59
60 * Suivre pas à pas le paragraphe "**For the Flamingo skin**"de [[l'article de la FAQ>>https://www.xwiki.org/xwiki/bin/view/FAQ/How%20do%20I%20add%20a%20favicon%20for%20my%20wiki||rel="__blank"]] sur le sujet. En bref :
61 ** Allez sur la page skin du Wiki [[http:~~/~~/tutos.myxwiki.org/xwiki/bin/view/XWiki/DefaultSkin#Attachments>>http://tutos.myxwiki.org/xwiki/bin/view/XWiki/DefaultSkin#Attachments]]
62 ** et ajoutez en pièce jointe les [[4 images qui sont regroupées dans le fichier zip joint>>attach:Favicon-XRI.zip||target="_blank"]] (en fait il s'agit de 4 fois la même image favicon mais avec les noms et extensions précisés dans l'article de FAQ => un renommage du même fichier fait parfaitement illusion ;) ).
63
64 == Filtrer la panneau / panel "Recently Modified" / "Dernières modifications" ==
65
66 Ajouter une condition supplémentaire dans le code (syntaxe velocity) pour n'afficher que les "vrais" articles de contenu c'est-à-dire ceux de l'espace "Tutos" (et ignorer l'affichage dans ce panneau, par exemple, des dernières pages d'admin modifiées) :
67 {{code}}#if ( $rdoc.getSpace().contains("tutos") ){{/code}}
68
69 == Configurer la barre d'outils de l'éditeur WYSIWYG ==
70
71 Dans l'éditeur WYSIWYG : ajouter les options d'alignement d'un paragraphe (à gauche, centré, à droite), les mises en formes utiles (style TT, couleur du texte, effacer la mise en forme), supprimer les éléments inutiles (indice, exposant...).
72
73 Cette personnalisation est possible dans l'administration du Wiki (les options complètes figurent [[sur cette page>>url:http://platform.xwiki.org/xwiki/bin/view/AdminGuide/WysiwygEditor#HPluginsandFeatures||rel="__blank"]]) :
74
75 * Aller dans l'(% style="color:#ff0000" %)**Administration du Wiki**(%%), partie (% style="color:#ff0000" %)**Editeur WYSIWYG**
76 * (% style="color:#ff0000" %)**Ajouter les plugins**(%%) ##color ##et ##justify##
77 * Puis (% style="color:#ff0000" %)**ajouter les éléments à la barre d'outils**(%%) pour obtenir le résultat ci-dessous :
78 [[image:Barre d'outils WYSIWYG.png]]
79 * Tester l'éditeur WYSIWYG en modifiant une page du Wiki, vous devez obtenir le résultat suivant :
80 [[image:Editeur WYSIWYG personnalisé.png]]
81
82 == Modifier le profil de l'administrateur ==
83
84 Connectez vous en tant qu'admin, allez dans **Profil **> **Preferences **puis
85
86 * activer **Display hidden documents** = Yes
87 * définir **User type** = Advanced
88
89 == Créer l'utilisateur "principal" Toto ==
90
91 Créer un utilisateur "Toto" qui sera l'auteur de tous les articles ;) et lui donner les droits pour qu'il puisse faire l'import du XAR venant de l'ancien Wiki (ie articles importés sous son nom).
92
93 == Autoriser les utilisateurs Anonymes à poster des commentaires ==
94
95 Afin d'autoriser les utilisateurs Anonymes (non enregistrés) à poster des commentaires avec Captcha, il faut réaliser 2 opérations dans l'administration du **Wiki **> **Droits d'accès** :
96
97 * Basculez en mode d'affichage "**Utilisateurs**" puis sur la ligne "**Utilisateurs non enregistrés**" cochez (c'est-à-dire mettre une coche verte) la colonne "**Commenter**"
98 * Enfin sous cette grille, cochez l'option "**Force un utilisateur non enregistré à renseigner un captcha lors de l'ajout d'un commentaire sur une page**".
99
100 {{warning}}
101 Ce paramétrage n'est pas disponible sur les Wikis hébergés sur la plateforme http://xxx.cloud.xwiki.com => l'option "Commentaires anonymes" a été volontairement désactivée par l'hébergeur (ie l'option a été retirée de la distribution Cloud) !
102 {{/warning}}
103
104 Illustration des opérations à réaliser :
105
106 (% style="text-align:center" %)
107 [[image:DroitsPourAnonymes.PNG||style="display:block; margin-left:auto; margin-right:auto" width="1000"]]
108
109 = Personnalisation des écrans =
110
111 == Mettre en place une redirection sur la page d'accueil (pour anonyme) ==
112
113 [[Voir l'article dédié>>doc:1XWikiCustomXRI.RedirectionAutomatique||rel="__blank"]].
114
115 == Définir la page d'accueil du Wiki ==
116
117 Afin que lors d'un clic sur l'icône présent en haut à gauche du header, l'utilisateur arrive sur la page d'accueil public du Wiki :
118
119 * créer une page Redirect contenant un code velocity de redirection, type :
120 {{code}}$response.sendRedirect("http://xxx"){{/code}}
121 * puis dans **Administration > Wikis > Description > Page d'accueil**, indiquer cette page par : Les_tutos_de_Toto.Redirect
122
123 == Simplifier les résultats de recherche ==
124
125 === Pour la recherche Solr ===
126
127 Modifiez la page [[http:~~/~~/tutos.myxwiki.org/xwiki/bin/edit/Main/SolrSearchMacros?editor=wiki>>http://tutos.myxwiki.org/xwiki/bin/edit/Main/SolrSearchMacros?editor=wiki]]. L'idée est de simplifier les pages des résultats de recherche soit en commentant soit en supprimant les éléments pour obtenir les éléments suivants :
128
129 (% style="text-align:center" %)
130 [[image:Synthèse des modifications Résultats de Recherche Solr.png]]
131
132 ==== Auteur et Date de dernière modification ====
133
134 * rechercher les lignes qui affichent l'**auteur et la date de modification** de chaque résultat (info n'ayant aucune valeur ajoutée), au 28/10/2018, les lignes supprimées sont :
135
136 {{code}}
137 <div class="search-result-author">
138 $services.localization.render('core.footer.modification', [
139 "#displayUserProfileLink($searchResult.author $searchResult.author_display)",
140 $xwiki.formatDate($searchResult.date)
141 ])
142 </div>
143 {{/code}}
144
145 ==== Lister tous les résultats (sans pagination) ====
146
147 * pour avoir **tous les résultats sur la même page** passez la valeur à 200 (chiffre supérieur au nombre de pages du Wiki) :
148
149 {{code}} #set ($rows = 200){{/code}}
150
151
152 ==== Supprimer le lien avec le flux RSS ====
153
154 * pour **supprimer le flux RSS en bas de la page des résultats** (lien inutile, qui utilise encore le RSS ?), recherchez et supprimez la ligne contenant :
155
156 {{code}}
157 displayRSSLink
158 {{/code}}
159
160
161 === Pour la recherche de type "base de donnée" ===
162
163 * Éditez la page [[http:~~/~~/tutos.myxwiki.org/xwiki/bin/edit/Main/DatabaseSearch>>http://tutos.myxwiki.org/xwiki/bin/edit/Main/DatabaseSearch||rel="noopener noreferrer" target="_blank"]] afin de retirer la partie RSS en bas de page ou la ligne avec la date et l'auteur de la modification de chaque résultat.
164
165 === Anciennes modifications (avant Solr) ===
166
167 * --Éditez le code de la page [[http:~~/~~/tutos.myxwiki.org/xwiki/bin/view/XWiki/Results>>url:http://tutos.myxwiki.org/xwiki/bin/view/XWiki/Results||rel="__blank"]], en commentant ou supprimant les lignes qui affichent l'auteur et la date de modification de chaque résultat (info n'ayant aucune valeur ajoutée).--
168
169 (% class="TnITTtw-translate-selection-button" style="top: 153.05px; left: 1592.45px;" %)
170 (((
171
172 )))
173
174 == Ajouter un logo personnel ==
175
176 1. Aller sur la page : [[http:~~/~~/tutos.myxwiki.org/xwiki/bin/view/ColorThemes/Mint>>url:http://tutos.myxwiki.org/xwiki/bin/view/ColorThemes/Mint||rel="__blank"]]
177 1. Ajouter le logo en pièce jointe à ce document
178 1. Passer en mode modification sur le document puis cliquer sur l'emplacement du logo
179 1. Enfin dans la boite de propriétés qui apparaît : indiquer le nom du fichier logo ajouté à l'étape 2 (par exemple : "Final.png").
180
181 == Modifier la couleur des liens hypertextes ==
182
183 * Dans l'**Administration > Apparence > Présentation** en bas **Thème de couleur**, cliquez sur le bouton **Personnaliser **à côté du thème (le thème Mint est utilisé actuellement). Puis modifiez la couleur pour les liens hypertextes comme dans la copie écran ci-dessous, en indiquant une couleur bleue (standard du web) :
184
185 [[image:Changer Couleur Lien Hypertexte pour bleu.jpg||style="display:block; margin-left:auto; margin-right:auto" width="500"]]
186
187 == Numéroter automatiquement les titres en fonction de leur niveau ==
188
189 Pour avoir une numérotation automatique des niveaux de titre, j'ai installé l'extension [[Numbered Headings>>url:http://extensions.xwiki.org/xwiki/bin/view/Extension/Numbered+Headings||rel="__blank"]] . Cette extension ajoute une macro qu'on peut mettre sur chaque page où l'on souhaite avoir la numérotation automatique des titres ...
190
191 **Procédure "pas à pas" :**
192
193 * Installation
194 ** Ajouter l'extension via Administration > Extension Manager
195 ** (optionnel) Modifier la Portée de la macro en définissant "Current Wiki" au lieu de "Global" par défaut, [[ça se passe ici>>url:http://tutos.myxwiki.org/xwiki/bin/edit/Macros/NumberedHeadingsStylesheetExtensionMacro?editor=object||rel="__blank"]].
196 * Utilisation
197 ** pour bénéficier de cette numérotation, ajoutez la macro suivante en début de page :
198 {{code}}{{numberedheadings/}}{{/code}}
199
200 {{info}}
201 A noter : j'ai personnalisé le CSS de la macro pour ajouter le caractère "." et un espace après chaque numérotation afin d'éviter les confusions lorsque le titre du paragraphe débute lui-même par un nombre (afin par exemple que le titre original : "2 modifications à faire dans l'admin" qui donne avec la "macro standard" : "52 modifications à faire dans l'admin" devienne plus lisible avec "5. 2 modifications à faire dans l'admin"). Pour cela :
202
203 * Allez sur la page [[https:~~/~~/tutos.myxwiki.org/xwiki/bin/edit/Macros/NumberedHeadingsStylesheetExtensionMacro?editor=object>>https://tutos.myxwiki.org/xwiki/bin/edit/Macros/NumberedHeadingsStylesheetExtensionMacro?editor=object||rel=" noopener noreferrer" target="_blank"]] puis cliquez sur la ligne "**StyleSheetExtension 0: numberedheadings" **; cette opération affiche le code CSS et permet de le modifier
204 * Dans le code CSS : recherchez **" "** et remplacer le par **".\00a0"** (à faire pour chaque niveau de titre) :
205
206 [[image:image-20220128234733-2.png]]
207
208 * Enregistrer et Fermer la page
209 {{/info}}
210
211 = Déclarer le Wiki au moteur de recherche Google =
212
213 * Pour que le Wiki apparaisse dans les résultats du moteur de recherche Google, il faut ajouter le Wiki à la base de données de Google :
214 ** complétez le formulaire à l'adresse : [[https://www.google.com/webmasters/tools/submit-url||rel="__blank"]]