Petit guide technique à l'usage des contributeurs avertis et des responsables documentaires.
Ne jamais oublier que tout document (a l'exception des pages protégées, accessibles aux seuls administrateurs) peut être modifiable n'importe quand par tout le monde. Voir ci-après (Modifications puis Validation (permanente) du contenu) les bonnes pratiques à adopter.
Il est souvent utile, pratique ou indispensable de laisser un message à autrui. Or une page « Discussion » est associée à chaque document lors de sa création, par exemple ici : Discussion:Guide Technique du wiki [[Discussion:{{FULLPAGENAME}}]]
.
Dans tous les cas de figure, il faut essayer de maintenir quelque chose de lisible, donc chaque sujet commencera par un titre ==Titre du sujet abordé==
. Il vaut mieux cinquante petits sujets séparés dotés chacun d'un titre, qu'un seul paquet de cinquante sujets. Cela facilite les réponses discriminées dans leur prise en compte, leur réalisation, etc.
À la fin du sujet, toujours signer par ~~~~
. Cela permet de savoir immédiatement qui a posté le message, et quand.
Traditionnellement les réponses se font en indentant comme dans les courriels. Cela se fait en commençant la ligne avec un :
de plus que la partie antérieure. Évidement chaque réponse, chaque rebondissement sera signé. C'est très utile pour quelqu'un qui se posera les mêmes questions plus tard et qui verra ainsi cette discussion comme un élément de « Base de Connaissances ».
En final, il peut être utile d'accoler au titre une ✓ pour indiquer que le sujet est clos ==Titre du sujet abordé {{OK}}==
. Si le sujet doit être rouvert on pourra remplacer la ✓ par une ✗ {{KO}}
.
Malheureusement, les personnes concernées par le questionnement ne sont pas nécessairement prévenues (le nombre d'articles suivis — donc susceptibles de voir leurs modifications notifiées — est plafonné pour ne pas faire sauter la base). Donc, pensez aussi à prévenir la ou les personnes qui peuvent être concernées en indiquant le lien vers la discussion. Là aussi, titre et signature, même si c'est très court, sont bienvenus.
En première lecture on pourra se rendre compte que si le Wiki est facile à la rédaction, il est lourd à gérer avec toutes ses règles de convivialité et d'efficacité, ses traditions construites sur l'expérience des prédécesseurs, etc. C'est que le wiki a aussi sa « Lore » (emprunté à l'anglais signifiant « tradition orale »).
Vous voulez vraiment vous investir dans le wiki ? Alors, n'hésitez pas à vous faire parrainer, sans gêne, ni timidité, ni honte… Nous avons tous débuté, et peut-être, nous l'espérons, ce sera à vous de parrainer plus tard. Vous ne connaissez personne ? Essayez de contacter des « anciens » sur https://chat.ryzom.com/channel/pj-ryzom_wiki ou contactez-les à partir de Spécial:Utilisateurs_actifs
Il y a quatre règles qui cohabitent :
Il faut néanmoins respecter certaines règles de convivialité constructive.
Tout d'abord il faut évaluer si les modifications sont profondes ou pas. Il n'y a pas de règles et c'est plus du feeling, mais si la modification est profonde, il est sage de commencer par regarder son histoire (bouton à côté de « Modifier ». Si le fond (non la forme, l'apparence, l'orthographe…) n'a pas évolué depuis un certain temps on peut supposer que son auteur l'a laissé pour tel et que le document a peut-être vieilli, qu'il nécessite peut-être une mise à jour. Un exemple est affiché ci-contre.
On peut considérer qu'une mise à jour est profonde dès lors qu'elle supprime des paragraphes, voire des lignes fondamentales au développement du sujet. Dans ce cas il devient convenable de laisser un message dans la page « Discussion utilisateur:xyz ». En attendant sa réponse (une semaine ?), il est sage de conserver dans la page modifiée le texte original passé en commentaire. Le plus simple pour passer un texte en commentaire est de le faire précéder par <!--
et de le faire suivre par -->
. Mais il y a parfois des problèmes, surtout s'il y a déjà d'autres commentaires. Dans ce cas, on peut utiliser le marteau et le burin en encadrant le texte par <noinclude><includeonly>
et </includeonly></noinclude>
. Pourquoi une telle complication ? Parce qu'il faut toujours respecter les écrits d'un auteur et sa paternité intellectuelle, même dans le libre. Sinon, on court le risque d'une :
Extrait de Wikipédia Guerre d'édition :
« Lors d'une guerre d'édition, deux ou plusieurs éditeurs expriment un profond désaccord sur un point particulier (le contenu ou le titre d'un article, sa subdivision en plusieurs articles de petite taille, un paragraphe non neutre…). On parle de guerre d'édition lorsque l'on peut observer les signes suivants : cycle de révocation actif sur l'article lui-même, commentaires agressifs, attaques personnelles, absence de discussion sur le sujet de l'article entre les protagonistes.
La détérioration délibérée du contenu, le blanchiment des pages ou le recours aux insultes dans la page de discussion ou la boîte de résumé sont considérés comme du vandalisme.
[...]
En dernier recours, un administrateur extérieur au débat pourra protéger la page. Dans ce cas, les éditeurs ayant tous les mêmes droits en matière d'édition, les personnes impliquées dans la polémique sont priées de respecter la règle de non-édition. Il est également rappelé que participer à une guerre d'édition peut conduire à un blocage des contributeurs engagés et qu'à tout moment s'applique la règle des trois révocations.»
Il ne faut pas confondre avec le conflit d'édition. Extrait de Wikipédia Aide:Conflit de versions :
« Dans Wikipédia, un conflit de versions ou conflit d’édition survient lorsque deux contributeurs travaillent sur une même page en même temps : le second qui enregistre, ayant travaillé avec une version obsolète de la page, voit sa modification rejetée. Depuis la version 1.3 de MediaWiki, cela ne se produit que si les modifications ne peuvent pas être fusionnées automatiquement. »
Bien sûr les incidents de parcours et les maladresses ne seront jamais évitées à 100% aussi le plus sage est de suivre les recommandations suivantes (extraites et adaptées de Wikipédia Aide:Conflit de versions) :
« Pour éviter les conflits de versions, le plus simple est d’éviter des modifications trop longues.
Cependant ce n’est pas toujours possible. C’est pourquoi il est possible, lors de la modification en profondeur d’une page, d’ajouter préalablement le bandeau {{WIP|~~~~}}
qui s'affiche comme suit :
Une fois la page publiée avec ce bandeau, vous pouvez la modifier tranquillement. Limitez le nombre de modifications en utilisant la prévisualisation pour procéder aux ajustements (cela permet un gain de temps et évite d’encombrer la page de modifications récentes).
Quand vous avez terminé, n’oubliez pas de retirer le modèle {{WIP}}
. »
Une autre méthode pour travailler en paix, est de travailler dans son propre espace utilisateur. Cet espace c'est [[Utilisateur:Zorroargh/Brouillons/...]]
.
Les documents que vous y préparez ne sont pas trouvables par les moteurs de recherche (sauf explicitement). Même Google ne doit pas y aller !
Normalement, dans le Wiki de Ryzom toutes les pages sont libres de traitement tant qu'il n'y a pas vandalisme. Néanmoins, les joueurs peuvent avoir besoin de documents fiables. Cela concerne essentiellement :
D'autres documents peuvent être jugés sensibles pour la maintenance, comme les modèles très utilisés pouvant changer l'aspect, voire la lisibilité, des documents.
Enfin les contributeurs, qu'ils soient développeurs, joueurs (RP ou non), animateurs ou autres, peuvent juger utile de demander la validation de leur travail.
Un document validé par les Loristes, les responsables de communications officielles ou les "administrateurs", est protégé contre toutes modifications non expressément autorisées.
Résumé du traitement spécifique des documents liés à la Lore.
Texte rédigé par les Loristes et retranscrit ou traduit par des encyclopatystes.
On appose tout en haut de la page le logo de la Lore {{Lore Officielle}}
qui affichera l'image .
Pour demander une validation de l'équipe Lore, apposer tout en haut de la page la bannière {{Demande validation Lore}}
qui s'affiche comme suit :
Un Loriste appose, si ce n'est déjà fait, le logo de la Lore, et il efface les bannières éventuelles de demande de validation. Ensuite il protège la page. Il peut déléguer cette tâche à un administrateur. Le logo de la Lore devient alors : .
Toutes les données, articles, images, modèles, portails..., doivent être catégorisées.
Les catégories sont très utiles pour cataloguer les documents et faciliter leur recherche. Il faut comprendre qu'une catégorie ressemble un ensemble au sens mathématique du terme, autrement dit :
Exemple : une chaussette rouge peut appartenir aux catégories: chaussettes, objets de couleur rouge, vêtements rouges, vêtements. Normalement, déclarer que cette chaussette appartient aux vêtements rouges, est suffisant. Mais on pourrait aussi dire qu'elle appartient aux chaussettes et objets de couleur rouge sans faire référence aux vêtements rouges. Dans ces deux cas, il est inutile de déclarer qu'elle appartient aux vêtements.
Le choix des catégories peut parfois être lié aux outils qui permettent de fouiller dans une catégorie et qui sont souvent affichés dans les portails (par exemple:
Le portail ...
Il y a actuellement 19 pages sur ...
Ce qui est obtenu par Il y a actuellement {{Number of pages}} pages sur ...
Bien sûr, il ressort de l'exemple précédent qu'il peut y avoir des exceptions essentiellement liées à l'ergonomie de la recherche. En effet, la recherche automatique (recherche au hasard d'un article à inclure, par exemple — voir Doc du jour ci-après) dans les arborescences de catégories est très gourmande en temps et en énergie. C'est pourquoi, il est préférable d'utiliser {{Number of pages}}
qui ne descend pas dans les sous-catégories.
Ce wiki, lié à l'univers de Ryzom, est censé partager des données communes aux langues de base du Wiki. Ces données communes sont regroupée dans 4 arborescences détaillées dans l'article Catégorisation. Seules les « grosses branches » sont détaillées pour laisser la liberté d'organisation des données à chaque groupe linguistique. Mais ces troncs et leurs "grosses branches" sont indispensables, surtout pour les traducteurs qui veulent facilement naviguer entre les groupes d'articles.
Extrait de Wikipédia Aide:Modèle « Un modèle sert à reproduire sur plusieurs pages le même message, ou la même mise en page, parfois en fonction de paramètres.
Il s'agit d'un élément pré-écrit, plus ou moins complexe, destiné à être incrusté dans une page afin d'obtenir instantanément le résultat visuel souhaité (formatage, affichage d'éléments spécifiques, etc.). Les bandeaux en haut des articles, les infobox, l'affichage des siècles… sont des modèles. »
L'aspect visuel doit rappeler l'identité du jeu. Par exemple: les infobox rappellent les « ambres mémoire » (RP) ou les interfaces de la Karavan (HRP). Les icônes en général font référence plus ou moins explicitement à l'univers du jeu.
Une charte graphique a deux fonctions (au moins) :
Pour ces deux raisons, il faut le plus possible s'y tenir.
Les modèles d'en-tête ou de paragraphe, servent à alerter le lecteur sur la manière dont il faut interpréter la page qu'il consulte (obsolescence, en cours de rédaction, etc.) ainsi qu'a souligner les annonces importantes concernant l'article.
Les modèles de bas de page servent à informer le lecteur sur des compléments d'information qui pourraient l'intéresser après sa lecture de la page.
Les modèles de corps de page servent à compléter ou à mettre en évidence des informations liées à la page en cours. La mise en évidence peut être diverse comme l'apparition de gros encarts ou des mises en forme typographique diverses.
(Attention : pas rigoureusement identique pour toutes les langues, mais essayons de les harmoniser le plus possible.)
Tous les templates sont dans la catégorie:modèles dont l'arborescence est explicitée dans le document Catégorisation#Le_Wikipatys
Les portails dans notre wiki servent de pages d’accueil des différents grands centres d'intérêt du jeu. Ils sont répertoriés dans le cartouche {{Portal bottom}}
Ryzom: La Lore • Le JeuHRP
Atys: Le monde d'Atys • Flore • Faune
Nations: Fyros • Matis • Tryker • Zoraï
Factions: Kami • Karavan • Maraudeurs • Rangers • Trytonistes
Tous les portails ont une structure similaire, mais leur apparence varie selon la complexité des données qu'ils présentent. En général un portail comporte, de haut en bas :
{{Portal bottom|}}
).Les portails n'ont pas été fabriqués en un jour et donc leur modèle s'est affiné au cours du temps. En général on essaye d'y inclure des documents en utilisant le modèle {{:NOMDOC}}
où NOMDOC=Nom du document à inclure.
Il est parfois agréable d'avoir une documentation qui donne un aperçu des thèmes présentés réunis sous le portail. Cela peut se faire comme suit :
Un document différent inclus | ENGLISH | FRANÇAIS |
---|---|---|
Quand nécessaire | {{:Featured article/...}} | {{:Lumière sur/...}} |
Chaque jour de la semaine | {{:Featured article/GBA/Week/{{CURRENTDOW}}}} | {{:Lumière sur/.../Jour/{{CURRENTDOW}}}} |
Chaque jour du mois | {{:Featured article/GBA/Month/{{CURRENTDAY2}}}} | {{:Lumière sur/.../Mois/{{CURRENTDAY2}}}} |
Les panneaux d'affichage contiennent des informations concernant aussi bien les lecteurs que le contributeur. Cela peut aller de la simple information aux urgences en passant par les « "To do lists" et les « Trucs et astuces ».
Pour associer un article à un portail, il suffit d'ajouter en bas du texte de l'article en question un bloc d'instructions du type suivant :
{{clear}}{{Last version link}} <noinclude>{{Portal|xxx}} [[Category:yyy]]</noinclude>
où:
L'ajout de la bannière de navigation vers le portail range en outre l'article dans des catégories « cachées », catégories qui ne seront pas affichées pour le lecteur, car inopportunes, mais qui sont signalées par un [+] placé après la dernière catégorie affichée. La technique de choix au hasard a été condamnée par Mediawiki, car trop coûteuse. Actuellement, on lui préfère un choix bridé (jour de la semaine ou du mois). Cela impose de créer une à une les redirections vers les pages qu'on souhaite mettre en lumière. Ainsi, par exemple, la page "Lumière sur/GBA/Jour/3" (3 du mois ou le mercredi) est redirigée vers "Primes Raider".
Que faire si l'article est trop long à inclure, ou si seulement certaines de ses parties sont intéressantes ?
Le plus sage est d'indiquer les parties à afficher ou occulter dans la future inclusion en les balisant dans larticle original.
<noinclude>
et </noinclude>
permettent d'exclure les parties qu'elles encadrent de la future inclusion.<onlyinclude>
et </onlyinclude>
permettent d'inclure les seules parties qu'elles encadrent dans la future inclusion.<includeonly>
et </includeonly>
permettent d'inclure les seules parties qu'elles encadrent dans la future inclusion, tout en les masquant dans l'article original (à manipuler prudemment dans un modèle).{{read more|<l'article original>}}
affiché ci-dessous) mais l'affiche dans l'inclusion.
Les pages d’accueil sont « spécifiques » car ce sont celles qui s'affichent par défaut lorsque l'on se connecte sur le wiki. Ces pages ne sont pas modifiables et peuvent contenir de nombreux artifices en HTML (et java). Cela implique que seuls des contributeurs avertis peuvent les modifier sur consensus de la communauté ou impératifs de communication.