Ryzom
Guide Technique du wiki : Différence entre versions

De EncyclopAtys

m (Autres commandes avancées)
m (retire le wip)
(30 révisions intermédiaires par 2 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
<noinclude>{{Trad
+
{{Trad
 
|DE=Technischer Wiki-Leitfaden|DEs=2
 
|DE=Technischer Wiki-Leitfaden|DEs=2
 
|EN=Wiki Technical Guide|ENs=4
 
|EN=Wiki Technical Guide|ENs=4
Ligne 49 : Ligne 49 :
 
Il faut néanmoins respecter certaines règles de convivialité constructive.
 
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 l'histoire de la page (bouton à côté de « Modifier »). Si le fond (non la forme, l'aspect, 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.
+
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 l'histoire de la page (bouton '''Historique''' à côté de « Modifier »). Si le fond (non la forme, l'aspect, 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 '''<code><nowiki><!--</nowiki></code>''' et de le faire suivre par '''<code><nowiki>--></nowiki></code>'''. 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 '''<code><nowiki><noinclude><includeonly></nowiki></code>''' et '''<code><nowiki></includeonly></noinclude></nowiki></code>'''. 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 :
 
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 '''<code><nowiki><!--</nowiki></code>''' et de le faire suivre par '''<code><nowiki>--></nowiki></code>'''. 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 '''<code><nowiki><noinclude><includeonly></nowiki></code>''' et '''<code><nowiki></includeonly></noinclude></nowiki></code>'''. 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 :
Ligne 155 : Ligne 155 :
 
===Bannières, sceaux et indicateurs d'en-tête===
 
===Bannières, sceaux et indicateurs d'en-tête===
 
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 (obsolète, en cours de rédaction, etc.) ainsi qu'a souligner les annonces importantes concernant l'article.
 
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 (obsolète, en cours de rédaction, etc.) ainsi qu'a souligner les annonces importantes concernant l'article.
 +
 +
Pour les trouver plus facilement, ils sont regroupés sous la catégorie [[:Catégorie:Modèle:Bandeau]] - par ex: WIP, Obsolète, Ebauche...
 +
 
===Bannières, navigation, horodateur===
 
===Bannières, navigation, horodateur===
 
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 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.
 +
 +
Plus à [[:Catégorie:Lien portail]], qui explique le rapport entre les bannières et les portails.
 +
 
===Corps de page===
 
===Corps de 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'affichage de grand encarts ou des mises en forme typographique diverses.
 
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'affichage de grand encarts ou des mises en forme typographique diverses.
===Nommer son Modèle===
 
Quelques règles de nomenclature des noms des modèles.
 
 
Merci d'ajouter <nowiki>[[Catégorie:User Templates]]</nowiki> à vos templates personnalisés.
 
 
 
===Tous les modèles===
 
===Tous les modèles===
 
<big>'''Attention''' : pas rigoureusement identiques pour toutes les langues, mais essayons de les harmoniser le plus possible.</big>
 
<big>'''Attention''' : pas rigoureusement identiques pour toutes les langues, mais essayons de les harmoniser le plus possible.</big>
  
 
Tous les ''templates'' sont rangés dans la [[:Catégorie:Modèles]] dont l'arborescence est explicitée dans le document [[Catégorisation#Le_Wikipatys]]
 
Tous les ''templates'' sont rangés dans la [[:Catégorie:Modèles]] dont l'arborescence est explicitée dans le document [[Catégorisation#Le_Wikipatys]]
 +
 +
====Nommer son Modèle====
 +
Quelques règles de nomenclature des noms des modèles (à déterminer et écrire [[Nommer ses Templates]]).
 +
 +
Merci d'ajouter <nowiki>[[Catégorie:User Templates]]</nowiki> à vos templates personnalisés.
  
 
=='''<big>Portail</big>'''==
 
=='''<big>Portail</big>'''==
Ligne 207 : Ligne 213 :
 
*le « ''last version link'' » permet d'horodater la page et ajoute un onglet discret permettant de retrouver l'original d'une inclusion ;
 
*le « ''last version link'' » permet d'horodater la page et ajoute un onglet discret permettant de retrouver l'original d'une inclusion ;
 
*le « ''noinclude'' » peut être mis pour ne pas polluer l'inclusion.
 
*le « ''noinclude'' » peut être mis pour ne pas polluer l'inclusion.
 +
 +
'''Plus''' à [[:Catégorie:Lien portail]], qui explique le rapport entre les bannières et les portails.
  
 
====À la une====
 
====À la une====
Ligne 223 : Ligne 231 :
  
 
Voir aussi ce commentaire (avril 2019) [[Discussion catégorie:Lumière sur]]
 
Voir aussi ce commentaire (avril 2019) [[Discussion catégorie:Lumière sur]]
 +
<!--- ce lien n'est pas sur la version EN de la page. A mon avis à creuser, d'autant que la petite flèche est trop discrète --->
  
 
=='''<big>Accueil</big>'''==
 
=='''<big>Accueil</big>'''==
Ligne 228 : Ligne 237 :
  
 
== Autres commandes avancées ==
 
== Autres commandes avancées ==
 +
{{Encart|titre=Une question sur les wikis?|contenu=Besoin d'aide ? '''merci''' d'utiliser la bonne discussion FAQ (voir '''plus bas''')<br />
 +
Une remarque ? <br />
 +
Merci de contacter [[File:RClogo211905.png|center|#pj-ryzom_wiki est le canal RC pour parler du wiki|link=https://chat.ryzom.com/channel/pj-ryzom_wiki]]}}
 +
* Consulter les catégories [[:catégorie:Aide]] et (plus technique)  [[:catégorie:Wikipatys]].
 +
*Merci d'utiliser le canal public dédié au wikis (et non des MP perso, car souvent, vous posez les même questions - de plus, vous aurez plus rapidement une réponse, car tous peuvent y avoir accès D)  https://chat.ryzom.com/channel/pj-ryzom_wiki
 +
* Sous pj-ryzom_wiki, il y a des thèmes regroupé dans des discussions, avec dans le titre le mot FAQ (voir comment chercher dans RC à [[Chat/FAQ_RC#Recherche]], RC a des fonctionnalités très puissantes et '''inutilisées''' D):
 +
** '''[https://chat.ryzom.com/group/ipDas8uYukHG9PdoA FAQ - common]''' : pour les questions et réponses sur le wiki Common (qui a toutes les images, pour les 5 wikis) et les images
 +
** '''[https://chat.ryzom.com/group/qzaLyYkfjmRxGh5Xs FAQ Templates/Modèles]''' : pour les questions et réponses sur les Modèles
 +
** '''[https://chat.ryzom.com/group/r54Lqh6wemqhEM7vB FAQ - backgroud colors]''' : pour les questions et réponses relatives à la mise en forme, charte graphique... (et les divers modèles liés)
 +
** [https://chat.ryzom.com/group/aQbnxFQtsKHaDops4 FAQ - category]
 +
** '''FAQ - bot'''
 +
 +
 
* comparaison des portails et catégories à https://atys.wiki.ryzom.com/wiki/Ryzom_Wiki_Categories_v_Portals  
 
* comparaison des portails et catégories à https://atys.wiki.ryzom.com/wiki/Ryzom_Wiki_Categories_v_Portals  
 
* Voir la version Anglaise (à [[:en:Wiki_Technical_Guide#Other advanced commands]]) ou directement:
 
* Voir la version Anglaise (à [[:en:Wiki_Technical_Guide#Other advanced commands]]) ou directement:
Ligne 233 : Ligne 255 :
 
** [[:en:Wiki Technical Guide/API]] Notes sur les commandes d'API (passer des commandes au wiki via les URL, aidé avec un formulaire Bac à Sable)
 
** [[:en:Wiki Technical Guide/API]] Notes sur les commandes d'API (passer des commandes au wiki via les URL, aidé avec un formulaire Bac à Sable)
  
* Arbres '''dynamiques''' des catégories: 🇫🇷  [[Utilisatrice:Craftjenn/ArboCaté]] • 🇬🇧 • 🇩🇪  et common à [[:atys:User:Craftjenn/common categories tree and info‎‎]]
+
* Arbres '''dynamiques''' des catégories: 🇫🇷  [[Utilisatrice:Craftjenn/ArboCaté]] • 🇬🇧 [[:en:Wiki Technical Guide#Wiki codes about categories]] • 🇩🇪  et common à [[:atys:User:Craftjenn/common categories tree and info‎‎]]
  
 
* Attention (peux être dangereux) - '''réservé aux admins''' [https://fr.wiki.ryzom.com/wiki/Sp%C3%A9cial:MassEditRegex Modification en masse à l'aide des expressions rationnelles] +  https://regex101.com/
 
* Attention (peux être dangereux) - '''réservé aux admins''' [https://fr.wiki.ryzom.com/wiki/Sp%C3%A9cial:MassEditRegex Modification en masse à l'aide des expressions rationnelles] +  https://regex101.com/
Ligne 250 : Ligne 272 :
 
** Aide:Aide (le nom de la page est Aide, mais dans le ns Aide:)
 
** Aide:Aide (le nom de la page est Aide, mais dans le ns Aide:)
 
** Discussion:Aide (la page Discussion de la page d'aide) - car chaque espace de nom a son propre ns Discussion  :)
 
** Discussion:Aide (la page Discussion de la page d'aide) - car chaque espace de nom a son propre ns Discussion  :)
* Par exemple, nos profils (avec ambre personnel, brouillons et biographie) devraient être, sous l'espace de noms Utilisateur ou Utilisatrice <ref>Un bon exemple concerne la grammaire Française: les homins et les homines n'ont pas le meme nom dans le ns Utilisateur. Voir: pour une homine c'est '''Utilisatrice''' [[Utilisatrice:Craftjenn]], et pour un homin '''Utilisateur''' [[Utilisateur:Zorroargh]]. Il faut pour cela avoir configuré dans ses préférences wiki son genre </ref>.
+
* [[Fichier:EN search on wiki 2020-04-05.png|vignette|Dans la recherche, le ns Utilisateur n'est PAS coché]]Par exemple, nos profils (avec ambre personnel, brouillons et biographie) devraient être, sous l'espace de noms Utilisateur ou Utilisatrice <ref>[[Fichier:FR wiki preferences langue 2020-04-16.png|vignette|Dans les Préférences]]Un bon exemple concerne la grammaire Française: les homins et les homines n'ont pas le meme nom dans le ns Utilisateur. Voir: pour une homine c'est '''Utilisatrice''' [[Utilisatrice:Craftjenn]], et pour un homin '''Utilisateur''' [[Utilisateur:Zorroargh]]. Il faut pour cela avoir configuré dans ses préférences wiki son genre  
** Si dans ces pages de brouillons, il n'y a pas de catégorie, alors vous pouvez travailler tranquillement sur vos écrits et vos brouillons (pas de risque de conflit d'édition), car par défaut, les pages de l'espace de nom Utilisateur n'apparaissent pas dans les résultats de recherche (voir image : le ns utilisateur n'est '''pas''' par défaut coché).
+
 
 +
</ref>.
 +
** Si dans ces pages de brouillons, il n'y a pas de catégorie, alors vous pouvez travailler tranquillement sur vos écrits et vos brouillons (pas de risque de conflit d'édition), car par défaut, les pages de l'espace de nom Utilisateur n'apparaissent pas dans les résultats de recherche (le ns utilisateur n'est '''pas''' par défaut coché).
 
** Si votre brouillon a des catégories : un homin peut trouver votre page de brouillon, en surfant sur les catégories.
 
** Si votre brouillon a des catégories : un homin peut trouver votre page de brouillon, en surfant sur les catégories.
  
  
 
'''Voici la valeur et le contenu''' des divers espaces de noms dans nos principaux wikis (en raison de l'histoire et de la fusion des wikis) :
 
'''Voici la valeur et le contenu''' des divers espaces de noms dans nos principaux wikis (en raison de l'histoire et de la fusion des wikis) :
* Sur les name space (ns) voir  🇫🇷  [[Guide Technique du wiki/FR ns liste]] • 🇬🇧  [[:en:Wiki Technical Guide/EN ns list]] • 🇩🇪 [[:de:Technischer Wiki-Leitfaden/DE ns list]] et  pour le common [[:atys:Help:Common ns list]] issue de [[:atys:User:Heernis/Common ns list]] (en  🇬🇧 )
+
* 🇫🇷  [[Guide Technique du wiki/FR ns liste]] • 🇬🇧  [[:en:Wiki Technical Guide/EN ns list]] • 🇩🇪 [[:de:Technischer Wiki-Leitfaden/DE ns list]] et
 +
* pour le common [[:atys:Help:Common ns list]] issue de [[:atys:User:Heernis/Common ns list]] (en  🇬🇧 )
 +
* [[:en:Wiki Technical Guide/Comparaison of lists ns and other]] est un résumé, avec des notes et des questions.
 +
 
 
=== Pages spéciales ===
 
=== Pages spéciales ===
 
'''Tableau trilingue pour les Pages Spéciales''' (avec aussi common) [[:en:Wiki_Technical_Guide/Special_Pages]]
 
'''Tableau trilingue pour les Pages Spéciales''' (avec aussi common) [[:en:Wiki_Technical_Guide/Special_Pages]]
 
==== Demande de validation d'un nouveau compte wiki ====
 
==== Demande de validation d'un nouveau compte wiki ====
Pour l'instant (2020 avril), les bureaucrates doivent valider les demandes de comptes wiki (plus tard, tous les utilisateurs se connecteront au wiki avec leurs identifiants de jeu).
+
Pour l'instant (2020 avril), les bureaucrates voient les demandes, mais ne peux pas les valider. Seuls les administrateurs (role dans les wikis) peuvent valider les demandes de comptes wiki (plus tard, tous les utilisateurs se connecteront au wiki avec leurs identifiants de jeu).
  
 
Tu verras ce message <ref>1 open email confirmed account request is pending. Your attention is needed</ref>, sur la page spéciale Modifications récentes [[File:Message on recent changes de 2020-04-07 22-13-59.png|thumb|center|Demande de compte wiki]]
 
Tu verras ce message <ref>1 open email confirmed account request is pending. Your attention is needed</ref>, sur la page spéciale Modifications récentes [[File:Message on recent changes de 2020-04-07 22-13-59.png|thumb|center|Demande de compte wiki]]
  
Plus à [[SOS/Créer un compte wiki]]
+
Plus à [[SOS/Créer un compte wiki]].
 
 
  
 
=== effacer du contenu ===
 
=== effacer du contenu ===
Ligne 273 : Ligne 299 :
  
  
la réponse de [[Utilisateur:Zorroargh|Zo]]:
+
Réponse 2 de [[Utilisateur:Zorroargh|Zo]]:
  
 
:'''Très important''': les catégories ne sont pas des pages gérées par médiawiki comme des pages.
 
:'''Très important''': les catégories ne sont pas des pages gérées par médiawiki comme des pages.
:C'est un "objet à part dans la base de données.
+
:C'est un "objet à part" dans la base de données.
  
 
:Lorsqu'on ne commente pas une catégorie, ne fut-ce qu'on lui ajoute une catégorie mère, '''la catégorie s'efface d’elle-même''' quand elle est vide au bout d'un certain délai, que mes super pouvoirs 😈 permettent de rendre instantané.
 
:Lorsqu'on ne commente pas une catégorie, ne fut-ce qu'on lui ajoute une catégorie mère, '''la catégorie s'efface d’elle-même''' quand elle est vide au bout d'un certain délai, que mes super pouvoirs 😈 permettent de rendre instantané.
Ligne 289 : Ligne 315 :
  
  
==== rapport catés et templates ====  
+
==== rapport entre les catégories et templates ====  
Oui pratiquement toute les bannières crée le catégorie correspondante. Avantage:
+
Oui pratiquement toutes les bannières créent la catégorie correspondante. Avantage:
 
- ça évite au rédacteur de se casser la tête avec les catégories ou de les oublier.
 
- ça évite au rédacteur de se casser la tête avec les catégories ou de les oublier.
 
- ça nous permet de modifier à faible coût TOUTES les pages contenant cette bannières. Si on était sur un Wikipédia avec un millier d'articles ayant cette bannière, il suffit de changer le template, pour changer les catégories de ce millier d'articles.
 
- ça nous permet de modifier à faible coût TOUTES les pages contenant cette bannières. Si on était sur un Wikipédia avec un millier d'articles ayant cette bannière, il suffit de changer le template, pour changer les catégories de ce millier d'articles.
Ligne 296 : Ligne 322 :
  
  
<references/>
+
 
 
{{clear}}{{Last version link}}
 
{{clear}}{{Last version link}}
<noinclude>{{Portail|Wikipatys|}}</noinclude>
+
<noinclude>{{Portail|Wikipatys|}}
[[Catégorie:Wikipatys]][[Catégorie:Aide]]
+
[[Catégorie:Aide]]
 +
</noinclude>

Version du 31 mai 2020 à 13:28


de:Technischer Wiki-Leitfaden
en:Wiki Technical Guide
es:Guía Técnica de la Wiki
fr:Guide Technique du wiki
ru:Техническое руководство по Вики
 
UnderConstruction.png
Traduction à revoir !
Ne blâmez pas les contributeurs, mais venez les aider 😎
Texte de référence (original utilisé comme référence) :
Notes :

Petit guide technique à l'usage des contributeurs avertis et des responsables documentaires. Voir aussi le Guide de rédaction.

Le travail d'équipe

Ne jamais oublier que tout document (à 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.

Pour rédiger à plusieurs, mieux vaut utiliser un PAD. Plus à Format de fichiers#Les pads .pad.

Pages de discussions

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.

Parrainage

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.

Traductions

Il y a quatre règles qui cohabitent :

• Forge (partie développement), Charte de comportement dans le jeu, Charte graphique, Catégories fondamentales
  • tout doit être traduit en anglais pour être accessible au plus grand nombre dont la majorité comprend, peu ou prou, l'anglais écrit ;
• Charte de comportement dans le jeu, Charte graphique, Modèles de gestion du Wiki, Catégories fondamentales
  • tout doit être traduit dans toutes les langues ;
• Lore, Chroniques, Animations publiques 
  • tout doit être traduit au moins dans les trois langues « maternelles » de Ryzom: DE, EN et FR ;
• le reste et surtout les parties roleplay
  • il n'y a aucune règle, seul l'intérêt des joueurs et des traducteurs prévaut.

Pour l'aide concernant la traduction sur ce wiki, voir WikiTrad/WikiTrad-FR ou sa version anglaise d'échange entre traducteurs.

Modifications

FR wiki history comparing.png
FR wiki history see.png
À l'exception des documents archivés et des documents ayant le statut officiel de « document définitif » (Lore, Chronique), tout est perfectible et c'est l'une des richesses des wikis.

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 l'histoire de la page (bouton Historique à côté de « Modifier »). Si le fond (non la forme, l'aspect, 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 :

Guerre d'édition

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. »

Travailler en paix

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 recommandé, lors de la modification en profondeur d’une page, d’ajouter préalablement le bandeau {{WIP|~~~~}} qui s'affiche comme suit :


Important.png
Under Construction Panel.png !!! En travaux !!! Under Construction Panel.png
Il reste actuellement encore 67 articles en préparation dans la catégorie «WIP»
Article en préparation. Laissez l'auteur le terminer avant de le modifier.
La dernière édition était de Jenn le 31.05.2020. -- Zo'ro-Argh Woren Siloy 28 mai 2019 à 14:19 (CEST)


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}}. »

Le brouillon

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 accessibles aux moteurs de recherche (sauf explicitement). Même Google ne doit pas y aller !

Validation (permanente) du contenu

Normalement, dans les wikis 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 :

  • La charte comportementale dans tout le jeu, ce wiki inclus.
  • La Lore qui fixe les caractéristiques fondamentales du jeu (les homins ne parlent pas klingon, la Karavan ne vole pas sur des dragons de feu et les Kamis ne surgissent pas d'une lampe à huile). Ces caractéristiques sont détaillées dans le portail de la Lore. Ici, elles seront brièvement décrites pour signaler sur leur existence.

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.

La Lore

Résumé du traitement spécifique des documents liés à la Lore.

Copie officielle

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 Rubber-Stamp-Lore choix Vert.png.

Création d'utilisateur non Loriste

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 :

Dummy.png
Cette page est soumise aux responsables de la Lore pour validation.
Date d'édition :2020-05-31

Validation

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 : Rubber-Stamp-Lore choix H.png.

Catégories

Toutes les données, articles, images, modèles, portails..., doivent être catégorisées.

De l'usage des catégories

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 :

  • un article peut appartenir à plusieurs ensembles ;
  • un ensemble d'articles peut être entièrement inclus dans un autre ;
  • il est inutile de déclarer qu'un article appartient à deux ensembles si l'un d'eux est complètement inclus dans l'autre.

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 aux 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.

Les catégories fondamentales de ce wiki

Les wikis, liés à l'univers de Ryzom, sont censés partager des données communes aux langues de base du jeu. Ces données communes sont regroupées dans quatre 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.


6 wikis, 6 ensembles de catégories, toutes images en commun
—• Six wikis, six ensembles de catégories, toutes images en commun •—

Dans common, les catégories sont sensibles à la casse (majuscules, minuscules).

Modèle (Template)

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. »

Aspect visuel et charte graphique

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) :

  • une fonction d'identification, en rappelant l'esprit du site (par exemple en utilisant les couleurs emblématiques des nations, des factions) ;
  • une fonction ergonomique, en permettant d'éviter l' « effet de surprise », c'est à dire d'éviter des comportements différents d'une page à l'autre, d'une traduction à l'autre.

Pour ces deux raisons, il faut le plus possible s'y tenir.

Bannières, sceaux et indicateurs d'en-tête

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 (obsolète, en cours de rédaction, etc.) ainsi qu'a souligner les annonces importantes concernant l'article.

Pour les trouver plus facilement, ils sont regroupés sous la catégorie Catégorie:Modèle:Bandeau - par ex: WIP, Obsolète, Ebauche...

Bannières, navigation, horodateur

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.

Plus à Catégorie:Lien portail, qui explique le rapport entre les bannières et les portails.

Corps de 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'affichage de grand encarts ou des mises en forme typographique diverses.

Tous les modèles

Attention : pas rigoureusement identiques pour toutes les langues, mais essayons de les harmoniser le plus possible.

Tous les templates sont rangés dans la Catégorie:Modèles dont l'arborescence est explicitée dans le document Catégorisation#Le_Wikipatys

Nommer son Modèle

Quelques règles de nomenclature des noms des modèles (à déterminer et écrire Nommer ses Templates).

Merci d'ajouter [[Catégorie:User Templates]] à vos templates personnalisés.

Portail

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 panneau {{Portal bottom}}

Spe labs.png

Les principaux portails du Wiki de Ryzom

Ryzom: La LoreLe JeuHRP
Atys: Le monde d'AtysFloreFaune
Nations: FyrosMatisTrykerZoraï
Factions: KamiKaravanMaraudeursRangersTrytonistes

L'encyclopédie: Les Chroniques d'AtysLa Grande BibliothèqueLes arcanesHRP

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 :

  • plusieurs onglets de sous-thèmes, l'accueil général positionnant la lecture sur le premier d'entre eux ; dans certains cas, il peut y avoir une seconde rangée d'onglets ;
  • le nombre d'articles concernés et catégorisés (voir les catégories associées) ;
  • un résumé ;
  • des informations (à gauche la « Doc du jour », à droite un panneau d'affichage) ;
  • le panneau récapitulant les principaux portails du Wiki de Ryzom ({{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.

Doc du jour

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 ANGLAIS 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}}}}

Panneau d'affichage

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 ».

Les catégories associées

Toutes les pages concernées

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>{{Portail|xxx}}
[[Category:yyy]]</noinclude>

où:

  • le « clear » permet d'assurer que la barre de navigation vers le portail est bien en-dessus de la dernière image ;
  • le « last version link » permet d'horodater la page et ajoute un onglet discret permettant de retrouver l'original d'une inclusion ;
  • le « noinclude » peut être mis pour ne pas polluer l'inclusion.

Plus à Catégorie:Lien portail, qui explique le rapport entre les bannières et les portails.

À la une

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 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 l'article original.

  • Les balises <noinclude> et </noinclude> permettent d'exclure les parties qu'elles encadrent de la future inclusion.
  • Les balises <onlyinclude> et </onlyinclude> permettent d'inclure les seules parties qu'elles encadrent dans la future inclusion.
  • Les balises <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).
Ce dernier balisage est par exemple utilisé pour cacher dans l'article original le « À suivre… » ({{read more|<l'article original>}} affiché ci-dessous) mais l'affiche dans l'inclusion.


Voir aussi ce commentaire (avril 2019) Discussion catégorie:Lumière sur

Accueil

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.

Autres commandes avancées

R2 scenario admin.png
Une question sur les wikis?
Besoin d'aide ? merci d'utiliser la bonne discussion FAQ (voir plus bas)

Une remarque ?

Merci de contacter
#pj-ryzom_wiki est le canal RC pour parler du wiki
  • Consulter les catégories catégorie:Aide et (plus technique) catégorie:Wikipatys.
  • Merci d'utiliser le canal public dédié au wikis (et non des MP perso, car souvent, vous posez les même questions - de plus, vous aurez plus rapidement une réponse, car tous peuvent y avoir accès D) https://chat.ryzom.com/channel/pj-ryzom_wiki
  • Sous pj-ryzom_wiki, il y a des thèmes regroupé dans des discussions, avec dans le titre le mot FAQ (voir comment chercher dans RC à Chat/FAQ_RC#Recherche, RC a des fonctionnalités très puissantes et inutilisées D):
    • FAQ - common : pour les questions et réponses sur le wiki Common (qui a toutes les images, pour les 5 wikis) et les images
    • FAQ Templates/Modèles : pour les questions et réponses sur les Modèles
    • FAQ - backgroud colors : pour les questions et réponses relatives à la mise en forme, charte graphique... (et les divers modèles liés)
    • FAQ - category
    • FAQ - bot



Les espaces de nom ou namespaces

Qu'est-ce que les namespaces ? - en abrégé ns

  • Les pages d’un wiki MediaWiki sont regroupées en collections appelées « espaces de noms » qui permettant de les différencier au niveau supérieur selon leur rôle. Les pages de certains espaces de noms peuvent aussi avoir des propriétés spéciales ou se comporter différemment lorsqu'elles interagissent avec d'autres pages.
  • Les espaces de noms se trouvent dans les titres de page en préfixant le nom de la page avec <namespace>:. Une page dont le nom n’est « pas » préfixé par un espace de noms appartient à l’espace de noms principal.
  • Plus sur la documentation officielle https://www.mediawiki.org/wiki/Help:Namespaces/fr
  • Plus concrètement, cela signifie que vous pouvez avoir deux pages différentes (même nom mais avec des contenus différents), avec le même nom, sans conflit. Par exemple :
    • Aide (sera dans l'espace principal)
    • Aide:Aide (le nom de la page est Aide, mais dans le ns Aide:)
    • Discussion:Aide (la page Discussion de la page d'aide) - car chaque espace de nom a son propre ns Discussion  :)
  • Dans la recherche, le ns Utilisateur n'est PAS coché
    Par exemple, nos profils (avec ambre personnel, brouillons et biographie) devraient être, sous l'espace de noms Utilisateur ou Utilisatrice [1].
    • Si dans ces pages de brouillons, il n'y a pas de catégorie, alors vous pouvez travailler tranquillement sur vos écrits et vos brouillons (pas de risque de conflit d'édition), car par défaut, les pages de l'espace de nom Utilisateur n'apparaissent pas dans les résultats de recherche (le ns utilisateur n'est pas par défaut coché).
    • Si votre brouillon a des catégories : un homin peut trouver votre page de brouillon, en surfant sur les catégories.


Voici la valeur et le contenu des divers espaces de noms dans nos principaux wikis (en raison de l'histoire et de la fusion des wikis) :

Pages spéciales

Tableau trilingue pour les Pages Spéciales (avec aussi common) en:Wiki_Technical_Guide/Special_Pages

Demande de validation d'un nouveau compte wiki

Pour l'instant (2020 avril), les bureaucrates voient les demandes, mais ne peux pas les valider. Seuls les administrateurs (role dans les wikis) peuvent valider les demandes de comptes wiki (plus tard, tous les utilisateurs se connecteront au wiki avec leurs identifiants de jeu).

Tu verras ce message [2], sur la page spéciale Modifications récentes
Demande de compte wiki

Plus à SOS/Créer un compte wiki.

effacer du contenu

Au sujet d'une question posée sur la catégorie:To Delete, "pour cette catégorie To Delete : je ne comprends pas pourquoi elle existe"

Réponse 1 : déja, il pourrait y avoir sur un autre wiki un lien vers la page/catégorie effacée, un user pourrait via un lien Trad ou TIP re-créer éternellement la page effacée. Attendre un peu est donc plus prudent (nettoyage sur les autres wikis).


Réponse 2 de Zo:

Très important: les catégories ne sont pas des pages gérées par médiawiki comme des pages.
C'est un "objet à part" dans la base de données.
Lorsqu'on ne commente pas une catégorie, ne fut-ce qu'on lui ajoute une catégorie mère, la catégorie s'efface d’elle-même quand elle est vide au bout d'un certain délai, que mes super pouvoirs 😈 permettent de rendre instantané.
quand on créée un page pour la catégorie, on impose en quelque sorte un double lien dans la base de données et la catégorie devient liée à a page.
Or une page, même détruite reste dans la DB!
Donc, lorsqu’une catégorie a été blanchie et qu'aucun "élément" n'y est inclus, la catégorie s'autodétruit grâce au mécanisme de Médiawiki. Nous n'avons rien à faire. La seule chose que je peux faire, c'est de forcer la purge (donc le ménage des cache) pour que ce mécanisme se déclenche plus vite que prévu. Et encore, le résultat peut ne pas être immédiat, car ça dépend de la charge de travail à ce moment la de la DB.
Si quelqu'un crée un article ou un autre objet se référent à cette catégorie, cette dernière se réveille toute seul grâce au moteur de Médiawiki.
Ce réveil est complètement perturbé si on a volontairement détruit manuellement la catégorie, car médiawiki surveille la "résurrection" des élément détruits.
En fait, détruire une catégorie, revient à créer, pour être tout à fait RP ( 😉 ) un zombie.


rapport entre les catégories et templates

Oui pratiquement toutes les bannières créent la catégorie correspondante. Avantage: - ça évite au rédacteur de se casser la tête avec les catégories ou de les oublier. - ça nous permet de modifier à faible coût TOUTES les pages contenant cette bannières. Si on était sur un Wikipédia avec un millier d'articles ayant cette bannière, il suffit de changer le template, pour changer les catégories de ce millier d'articles.




Last version 2020-06-15•
  1. Dans les Préférences
    Un bon exemple concerne la grammaire Française: les homins et les homines n'ont pas le meme nom dans le ns Utilisateur. Voir: pour une homine c'est Utilisatrice Utilisatrice:Craftjenn, et pour un homin Utilisateur Utilisateur:Zorroargh. Il faut pour cela avoir configuré dans ses préférences wiki son genre
  2. 1 open email confirmed account request is pending. Your attention is needed