Modifié par Xavier Richard le 10/06/2023 à 23:26
Masquer les derniers auteurs
Xavier Richard 52.1 1 {{numberedheadings/}}
2
Xavier Richard 29.1 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
Xavier Richard 114.2 15 [[Voir ce qu'il reste à faire>>doc:1XWikiCustomXRI.ToDoNew]].
Xavier Richard 84.1 16
17
Xavier Richard 29.1 18 = Personnaliser la traduction =
19
Xavier Richard 114.2 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.
Xavier Richard 109.1 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}}
Xavier Richard 39.1 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"]]
Xavier Richard 29.1 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
Xavier Richard 52.1 25 = Configurer le Wiki =
Xavier Richard 29.1 26
Xavier Richard 120.1 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 :
Xavier Richard 29.1 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
Xavier Richard 62.2 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
Xavier Richard 29.1 38 == Désactiver les Annotations ==
39
Xavier Richard 39.1 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"]]
Xavier Richard 29.1 41
42 == Personnaliser le texte de la barre titre du navigateur Web ==
43
Xavier Richard 47.1 44 * [[http://tutos.myxwiki.org/xwiki/bin/admin/XWiki/XWikiPreferences?editor=globaladmin&section=Elements&space=XWiki||rel="__blank"]]
Xavier Richard 29.1 45 * dans la zone "Titre", indiquer le code :
Xavier Richard 39.1 46 {{code}}$tdoc.getRenderedTitle("plain/1.0") - Les tutos de Toto - XWiki{{/code}}
Xavier Richard 40.1 47
Xavier Richard 42.1 48 == Personnaliser le pied de page ==
49
Xavier Richard 114.2 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
Xavier Richard 112.1 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"
Xavier Richard 114.2 52 ** /!\ Attention : la taille (nombre de caractères) de ces champ est réduit en BDD
Xavier Richard 112.1 53 ** dans la zone 1 "Copyright", indiquez le code :
Xavier Richard 114.2 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}}
Xavier Richard 42.1 57
XWikiGuest 85.1 58 == Ajouter un Favicon ==
59
Xavier Richard 109.1 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]]
Xavier Richard 111.1 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 ;) ).
XWikiGuest 85.1 63
Xavier Richard 97.1 64 == Filtrer la panneau / panel "Recently Modified" / "Dernières modifications" ==
65
Xavier Richard 98.1 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) :
Xavier Richard 97.1 67 {{code}}#if ( $rdoc.getSpace().contains("tutos") ){{/code}}
68
Xavier Richard 52.1 69 == Configurer la barre d'outils de l'éditeur WYSIWYG ==
Xavier Richard 49.1 70
Xavier Richard 62.2 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...).
Xavier Richard 49.1 72
Xavier Richard 62.2 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
Xavier Richard 120.1 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 :
Xavier Richard 62.2 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
Xavier Richard 47.1 82 == Modifier le profil de l'administrateur ==
83
Xavier Richard 49.1 84 Connectez vous en tant qu'admin, allez dans **Profil **> **Preferences **puis
Xavier Richard 47.1 85
Xavier Richard 49.1 86 * activer **Display hidden documents** = Yes
87 * définir **User type** = Advanced
88
Xavier Richard 52.1 89 == Créer l'utilisateur "principal" Toto ==
Xavier Richard 49.1 90
Xavier Richard 52.1 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).
Xavier Richard 49.1 92
Xavier Richard 89.1 93 == Autoriser les utilisateurs Anonymes à poster des commentaires ==
Xavier Richard 86.1 94
Xavier Richard 93.1 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** :
Xavier Richard 86.1 96
Xavier Richard 93.1 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**"
Xavier Richard 84.1 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**".
Xavier Richard 79.1 99
Xavier Richard 84.1 100 {{warning}}
Xavier Richard 93.1 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) !
Xavier Richard 84.1 102 {{/warning}}
103
Xavier Richard 93.1 104 Illustration des opérations à réaliser :
105
Xavier Richard 120.1 106 (% style="text-align:center" %)
107 [[image:DroitsPourAnonymes.PNG||style="display:block; margin-left:auto; margin-right:auto" width="1000"]]
Xavier Richard 93.1 108
Xavier Richard 48.1 109 = Personnalisation des écrans =
Xavier Richard 40.1 110
Xavier Richard 96.1 111 == Mettre en place une redirection sur la page d'accueil (pour anonyme) ==
Xavier Richard 95.1 112
Xavier Richard 114.2 113 [[Voir l'article dédié>>doc:1XWikiCustomXRI.RedirectionAutomatique||rel="__blank"]].
Xavier Richard 95.1 114
Xavier Richard 98.2 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
Xavier Richard 48.1 123 == Simplifier les résultats de recherche ==
124
Xavier Richard 99.2 125 === Pour la recherche Solr ===
Xavier Richard 48.1 126
Xavier Richard 109.1 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 :
Xavier Richard 99.2 128
Xavier Richard 109.1 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
Xavier Richard 99.2 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
Xavier Richard 109.1 145 ==== Lister tous les résultats (sans pagination) ====
Xavier Richard 99.2 146
Xavier Richard 109.1 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
Xavier Richard 99.2 156 {{code}}
Xavier Richard 109.1 157 displayRSSLink
Xavier Richard 99.2 158 {{/code}}
159
160
161 === Pour la recherche de type "base de donnée" ===
162
Xavier Richard 109.1 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.
Xavier Richard 99.2 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
Xavier Richard 109.1 169 (% class="TnITTtw-translate-selection-button" style="top: 153.05px; left: 1592.45px;" %)
Xavier Richard 99.2 170 (((
171
172 )))
173
Xavier Richard 78.1 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
Xavier Richard 78.2 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").
Xavier Richard 78.1 180
Xavier Richard 77.2 181 == Modifier la couleur des liens hypertextes ==
Xavier Richard 67.1 182
Xavier Richard 77.2 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) :
Xavier Richard 67.1 184
Xavier Richard 98.2 185 [[image:Changer Couleur Lien Hypertexte pour bleu.jpg||style="display:block; margin-left:auto; margin-right:auto" width="500"]]
Xavier Richard 70.1 186
Xavier Richard 49.1 187 == Numéroter automatiquement les titres en fonction de leur niveau ==
188
Xavier Richard 120.1 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 :
Xavier Richard 49.1 198 {{code}}{{numberedheadings/}}{{/code}}
199
Xavier Richard 62.2 200 {{info}}
Xavier Richard 120.1 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
Xavier Richard 62.2 209 {{/info}}
210
Xavier Richard 48.1 211 = Déclarer le Wiki au moteur de recherche Google =
212
Xavier Richard 41.2 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"]]