Guide de rédaction 2018

De EncyclopAtys

Révision datée du 3 novembre 2020 à 16:55 par Craftjenn (discussion | contributions) (→‎citations, poèmes...)

en:Writing Guide
fr:Guide de rédaction

Honteusement copié des notes de Utilisateur:Zorroargh, pour que tous se sentent libres de le modifier.

Ce guide de rédaction est un « mini-guide pour les nuls » avec une teinte rôliste, c'est-à-dire construit pour une encyclopédie rédigée pour et par les « avatars » (plus que par leur « anima » qui se cache derrière leur module d'interface Karavan en pianotant sur une carapace d'arma). Ce guide se concentre plus sur l'art que sur la manière de faire un article tout en donnant rapidement les bases élémentaires pour prendre en main ces fabuleux MediaWiki.

  • BarreOutilsW présente et nomme les diverses barres d'outils du wiki (tentative d'améliorer la communication, lorsque l'on demande de l'aide, qu'on ait un vocabulaire commun).
  • Un autre guide, plus technique est à Guide Technique du wiki. La catégorie Aide est réservée à l'aide sur le wiki. Notes sur l'affichage du Wiki en jeu disponibles ici.
  • #pj-ryzom_wiki est le canal Rocket Chat où l'on parle du wiki

Au début

J'aimerais écrire quelque chose. Quelle bonne idée! Mais cela a peut-être déjà été écrit. Alors, le plus sage est de chercher si quelqu'un vous a devancé. Et là, oh merveille ! Soit le wiki vous indique que l'article existe, soit il vous affiche :

Résultat de la recherche

...

Il n’y a aucun résultat correspondant à la requête.

Créer la page « Trucobolite » sur ce wiki !

Si vous passez la souris sur la page écrite en rouge foncé (pas ici, car je n'ai volontairement pas activé ce lien) vous verrez le nom de la page se souligner et afficher « Trucobolite (page inexistante) ». Il ne vous reste plus qu'à cliquer pour ouvrir une page vierge et commencer l'aventure.

C'est si simple que ça ?! Hum, presque. Juste avant de vous lancer suivez ces quelques petits conseils pour choisir un titre :

  • Évitez autant que possible les articles, le pluriel… Restez proche, dans votre formulation, d'une entrée de dictionnaire. Il vaut mieux titrer un article Corsaire que Les Corsaires même si au final c'est bien de la tribu nommée « Les Corsaires » que l'article traitera.
  • Si vous soupçonnez l'article d'exister déjà, avec peut-être une orthographe voisine, vous pouvez utiliser le moteur de recherche Google en y tapant l'instruction :
trucobolite site:http://fr.ryzomnomnom.com

Et si la page que je voulais existe déjà ? Ah ça, c'est une autre aventure ! Plus tard ! Pour l'instant, la question est :

Rompre la page blanche

Pour écrire dans un wiki, le plus simple, c'est d'écrire, d'écrire, d'écrire...

Et vous commencez donc...

Au bout de plusieurs centaines de caractères entrés allègrement sur votre clavier vous allez jeter un coup d’œil sur votre œuvre, et comme tout le monde vous l'a conseillé vous choisissez bien le bouton Prévisualisation au lieu de Sauvegarder. Et, oh, surprise! votre texte n'est qu'un amoncellement inélégant de mots qui se suivent sans fin.

Pour peu que vous ne soyez pas habitués aux MediaWiki, vous risquez d'obtenir des résultats quelque peu étonnants au départ. Mais avec très peu de règles, il est possible de rapidement rédiger un bon et beau texte.

En effet, MediaWiki a été conçu à une époque où le wyziwyg n'était pas monnaie courante. Et pourtant, il se voulait être facilement accessible aux non-informaticiens, à ceux qui travaillent sans souris, aux mal voyants... Il fallait donc travailler le plus efficacement possible (c'est-à-dire en se fatiguant le moins possible, spécialité aussi bien des Tryker que des informaticiens entre autres) et donc, il fallait jouer sur des gestes simples comme répéter la même touche pour obtenir un certain résultat. Mais avant tout, essayons d'y voir clair.

Formatage de base

Barre d'outil d'édition (Avancé déplié): la recherche est à droite

Paragraphe

Dans MediaWiki, un «retour chariot» n'est pas un «retour à la ligne» et encore moins un saut de paragraphe. Dans l'esprit, ce wiki est très proche de l'HTML. Et dans ce dernier, le retour à la ligne n'a pas de signification autre que celle de rendre les lignes plus lisibles dans le source. Alors, pour faire un nouveau paragraphe, il faut deux «retour chariot» (ou une ligne blanche). Voici un exemple pour illustrer ces «retour chariot»:

Ceci est un exemple de
texte écrit sur
trois lignes.

Et ceci est un nouveau paragraphe.
 Mais attention de ne pas laisser trainer un «espace» en début de ligne,
ce qui donnerait un effet particulier, très utile, mais peut-être inattendu dans le contexte.

Ce qui s'affichera:

Ceci est un exemple de texte écrit sur trois lignes.

Et ceci est un nouveau paragraphe. 

Mais attention de ne pas laisser trainer un «espace» en début de ligne,

ce qui donnerait un effet particulier, très utile, mais peut-être inattendu dans le contexte.


Saut de ligne
Pour faire un simple saut de ligne, sur la barre d'outil, ouvrir Avancé: c'est l’icône à droite du W barré en rouge et vous verrez un code <br /> s'afficher. Cela va garder le même interlignage, contrairement à un paragraphe.
Ici, un saut de ligne a été mis, juste après le titre Saut de ligne (et avant le "Ici") : l'espace entre ce "Saut de ligne" et "Pour faire un" est identique aux lignes qui composeraient un long paragraphe.

Titres

Votre texte est déjà plus lisible, mais il lui manque sans doute d'être organisé. Pour cela, vous voudrez ajouter des titres. Là aussi la technique est simple, il suffit d'encadrer le texte par des «=» comme indiqué dans les exemples suivants, tirés de ce propre passage:

==Rompre la page blanche==
===Formatage de base===
====Titres====

Et, me direz-vous, il n'y a pas de =Titre niveau 1=? Non, celui-là est réservé au MediaWiki qui s'en sert pour faire le titre de la page.

Commentaire et balises wiki

Un commentaire est du texte, inséré dans le wiki code d'une page, qu'on ne peux voir que si l'on modifie la page wiki = il reste invisible à l'affichage (ou en d'autres termes : seuls ceux qui ont le droit de modifier cette page peuvent le voir).

<!-- Ceci est un exemple de commentaire invisible à l'affichage. -->

Le wiki interprète le code wiki que tu entres dans une page ; il est fait pour exécuter automatiquement un certain nombre de taches selon le contexte. Citons, par ex :

  • avant d'enregistrer une page, il interprète le code (d'où la prévisualisation, qui donne une idée du travail silencieux fait par le wiki, juste avant d'enregistrer ces codes. On comprend bien cet aspect là, avec les commentaires et la balise nowiki)
  • avant de l'afficher (le mode lecture via la vue Page: il cache les commentaires, traite la balise nowiki,...  ; le mode en écriture via la vue Modifier : il montre les commentaires ...), ...

Cette page d'aide utilise très souvent, pour montrer du code wiki, la balise nowiki.

Qu'est-ce qu'une balise ?
C'est une série de caractères, utilisé pour la structuration d'un document et qui sera invisible par le lecteur final. En général (le saut de ligne est l'une des exceptions bien connue) il y a une balise ouvrante et une balise fermante - le HTML suit cette logique, et le wiki code a bien des points communs avec lui.
Typiquement : '''<'''balise ouvrante'''>''' bla bla '''</'''balise fermante'''>'''

Avec nowiki, dès que le wiki reconnaît la 1ere balise, au lieu de travailler comme d'habitude, il change de mode jusque la balise de fermeture. Dans la barre d'outil du wiki, il faut ouvrir la barre avancée pour voir son icône (juste après les listes numérotées)

<!-- Ceci est un exemple de commentaire invisible à l'affichage. --> et qui est montré grâce aux balises nowiki (icône W barrée sur la barre d'outil).


Plus à https://fr.wikipedia.org/wiki/Aide:Syntaxe#Commentaire_invisible

Mettre en évidence

Eh bien, non, on ne souligne pas, on ne surligne pas! :)

Mais je ne vais pas m’appesantir sur ce sujet dont les règles sont complexes. Beaucoup de texteurs donnent l'illusion au rédacteur qu'il sait jouer au typographe et pourtant[1]... Alors, restons simples à notre niveau de simples atysiens.

Lorsque quelque chose est important, on a tendance à élever la voix ou à en changer le timbre. On pourrait dire qu'il en est de même par écrit: on met en caractère gras. Inutile de préciser que ce n'est pas la peine d'élever la voix en permanence... ça fatigue.


Une convention (mais non une obligation) est de toujours rédiger, avant le premier titre, un résumé dans lequel apparaît le plus tôt possible le nom de l'article. Cette habitude a pour but de confirmer au lecteur qu'il se trouve bien sur la bonne page, ce qui est très utile lorsque certaines pages sont redirigées. Essayez avec ASA et vous verrez.

Utilisez si possible des phrases courtes, des espaces verticaux (rythme la page, plus lisibles sur un écran) et les puces attirent bien l'oeil aussi.


Et l'italique? En gros, on pourrait dire qu'il s'agit de citations et d'expressions qui sortent du langage courant contextuel (titre honorifique, mot étranger, libellé...) et que l'on aurait pu mettre en guillemets. Par exemple, pour nous atysiens, il pourrait s'agir d'une expression HRP dans le texte.


Attention: Nous allons progressivement intégrer les wikis dans le jeu. Or, en jeu: tout texte affiché en italique (via la barre d'outil) affiche une erreur, et pire s'il y a un lien au milieu des italiques alors le lien ne fonctionne pas (en plus de l'erreur affichée). Donc, merci de limiter les italiques (barres wiki), ou encore, écrire les balises em, sachant qu'un lien au milieu de balises em fonctionne bien en jeu (testé en mars 2020). Les mots en gras ne seront pas affichés en gras (mais n'affichent pas d'erreur).


Voici donc comment produire les deux types:

'''En gras''' et <em>en italique</em>.

Ce qui donne:

En gras et en italique.

Quand je vous disais que l'on tapait trente-six fois sur la même touche!

Lister

Bon, c'est sûr, maintenant que vous savez écrire dans le wiki, vous allez vouloir donner des recettes, des matières premières à extraire... Et puis, vous voulez que cela se fasse dans une quête, dans un certain ordre... Rien de plus facile dans MediWiki. Ceci:

  • un élément de liste composé d'une suite ordonnée
    1. elle-même composée d'une liste
      • A
      • B
    2. etc.
  • etc. ...

est simplement obtenu par ça:

*un élément de liste composé d'une suite ordonnée
*#elle-même composée d'une liste non ordonnée
*#*A
*#*B
*#etc.
*etc. ...

Ajouter une image

Pour l'instant, nous n'en étions qu'au texte, et pourtant rien de tel qu'une image pour clarifier une description (décrivez la faune et la flore sans image!) ou tout simplement pour agrémenter la lecture.

Quelle image?

Avant de placer une image sur une page de EncyclopAtys, il faut qu'elle y ait été préalablement téléchargée.

Nous vous conseillons fortement, avant d'aller plus loin, de relire les Avertissements généraux d'EncyclopAtys, ainsi que http://atys.wiki.ryzom.com/wiki/Terms_of_Use.

Où trouver les images?

Je recherche une image pour illustrer un article.

Les images sont stockées dans le wiki commun (aux wiki FR, EN, DE, ES et RU => en anglais) nommé COMMON

Comment mettre une image personnelle

J'ai trouvé ou fait une image que je désire insérer dans un article de EncyclopAtys. (Attention! l'image doit être sous une licence libre comme la GFDL.)

Pour importer l'image, il faut choisir dans le menu Outils (menu déroulant tout en haut) la commande Importer un fichier.

  1. Cliquer sur "Parcourir" pour choisir l'image qui est sur votre machine (si possible bien nommée, et avec une date),
  2. dans Summary, il est utile d'indiquer des mots clefs et au moins une [[Category:Images]] - pour un lucio pour ta page perso (Utilisateur:Machin), préférer [[Category:Homins images]].
  3. Valider en bas en clic "Unload file" (attendre pour l'envoi de l'image sur les serveurs d'Atys).

L'image a été envoyée (on ne voit plus les instructions pour l'aide à l'insertion). Or, il faut maintenant l'insérer dans le code wiki (copier le nom exact du fichier, par ex "File:Barreswiki.png" passer à l'étape suivante).

Les images sont hébergées dans le Common (adresse URL qui comment en atys : https://atys.wiki.ryzom.com/wiki/Accueil), dont la langue par défaut est l'anglais, car commun à tous les wikis (anglais, allemand...).

Vers un petit tutoriel (en mode pas à pas) à SOS/Tuto images et aussi des conseils pour SOS/Catégoriser une image.

Insertion d'une image, code wiki

Pour insérer une image, il suffit d'écrire : [[file:Nom de l'image | vignette | où | taille | alt=Alternative textuelle | Légende]]. Par exemple, pour afficher les 2 images de ce paragraphe, il faut écrire:

[[file:Dummy.png|thumb|right|alt=Une sphère étrange, ex thumb droit|L'emblème de l'ASA, ex thumb droit]]
[[file:Dummy.png|64px|alt=Une sphère étrange, ex 64|L'emblème de l'ASA, ex 64]]

Une sphère étrange, ex thumb droit
L'emblème de l'ASA, ex thumb droit

Une sphère étrange, ex 64 Où le Nom de l'image est précédé du préfixe «file:». Les autres paramètres sont optionnels.

Les options sont:

  • vignette: si on souhaite n'afficher qu'une vignette aux dimensions standard d'EncyclopAtys, il suffit de mettre la valeur thumb.
  • où: les positions sont left(placé à gauche du bloc visuel, valeur par défaut), center(centré dans le bloc visuel) et right(placé à droite du bloc visuel).
  • taille: par défaut, celle de l'image ou de la vignette si cette dernière a été choisie. Si l'on souhaite rapetisser l'image, indiquer la largeur en pixel (ex: 20px).
  • Alternative textuelle: c'est une brève description de l'image qui la remplacera si elle n'est pas restituée. (Ne semble pas opérationnel sur EncyclopAtys.)
  • Légende: c'est le commentaire de l'image qui sera affiché en dessous de celle-ci, ou au survol de la souris.

Pour peaufiner, on peut s'inspirer de Wikipedia.

Lien sur image et vers des catégories

  • Lien sur une image: pour Atysmap.jpg (de plus, l'image a été réduite à 50px), le code est [[File:Atysmap.jpg|50px|link=Carte d'Atys]] où Carte d'Atys est la destination du lien.
  • Si l'image est hébergée sur le wiki common, pour faire Voir en grand, le code est [[:atys:File:Atysmap.jpg|Voir en grand]].
  • Pour mettre un lien vers une catégorie d'images sur le common, ex: La catégorie Wiki de common regroupe des images d'aide wiki, utiliser le code [[:atys:Category:Wiki|La catégorie Wiki de common]]

Source : https://www.mediawiki.org/wiki/Help:Images#Link_behavior

Galeries

En mode d'édition d'une page, voici la barre d'outil d'édition du wiki

Si l'on a plusieurs images, on peux utiliser la "galerie de fichiers" (sur la barre d'outil en mode édition du wiki, l’icône juste à droite de "Insérer", voir image ci dessus).

Cela facilite la lecture/modification du code wiki (pour l'auteur), car ajoute des balises gallery ; ainsi, chaque image sera sur une ligne (dans le code wiki), avec une syntaxe simple : nomdufichier.jpg la "barre verticale" (AltGr+6) et une description.

Pour davantage d'exemples de syntaxe (et de mise en forme): Guide de rédaction/Galerie d'images.

Plus sur l'utilisation de la Barre d'outil (mode édition du wiki).

Tissage de la toile

Le tissage de la toile est la spécificité de la Toile (C'est une vérité de la Ba'Lys)

Il y a plusieurs sortes de liens possibles dans un document MediaWiki. En voici la liste:

  • Le lien interne tel que ASA.

À noter que les lettres accolées à ce type de lien s'unissent pour ne former qu'un seul mot: flyners. On peut évidement renommer pour s'adapter au contexte: plante planante...

Voici les coulisses dévoilant comment tout cela a été fait:


*Le lien interne tel que [[ASA]].
À noter que les lettres accolées à ce type de lien s'unissent pour ne former qu'un seul mot: [[flyner]]s.
On peu évidement renommer pour s'adapter au contexte: [[flyner|plante planante]]...
*Le lien sur une partie d'un document comme ''[[Astronomie#Le luminaire d'Atys|Le luminaire d'Atys]]'' ou [[#Formatage de base|quelque part dans cet article-ci]].
*Le lien externe est très simple comme ceci http://ryzom.silenda.de , mais si l'on souhaite une présentation plus élégante on peut avoir [http://ballisticmystix.net le site ballistic mistix] .
*Et la référence qui est un lien vers une note<ref>exemple de note</ref> mis en bas de page, comme on peut le voir sur cette ligne.
* Pour un lien vers un des autres wiki (liens interwiki): ajouter devant le nom la langue. Par exemple: pour common [[:atys:Category:User work|images sous User work]], ou pour la version en Anglais de cette page [[:en:Writing guide]].

Et si vous voyez le message suivant en bas de votre page, ne vous inquiétez pas, nous verrons cela tout de suite...

Erreur de référence : Des balises <ref> existent, mais aucune balise <references/> n’a été trouvée.

Autres astuces

citations, poèmes...

  • "balises de citation", dont la syntaxe est <q> blblbl </q>. Le texte joint apparaîtra avec une police à empattement italique avec les caractères de citation appropriés (en fonction de la langue). Un exemple:

blblbl

  • Un modèle a été créé. Syntaxe simple: {{Quotation|<source>| <text> }}. Plus à Modèle:Quotation Un exemple
“

Utiliser le modèle Quotation est utile...

Zorroargh

  • Poèmes est une extension wiki installée: <poem>Looooooooooooooooooooooooooooooooooooooong texte ou pas si long </poem> donne

Looooooooooooooooooooooooooooooooooooooong texte ou pas si long

    • Toutes les nouvelles lignes sont préservées en les convertissant en
      tags
    • Le bloc de texte est enfermé dans des balises

      ...

      (ainsi qu'un div de la classe "poème")
    • Les deux points en début de ligne sont convertis en tiret 1 em
    • Les espaces en début de ligne sont conservés et n'invoquent plus la balise 
       (indispensable pour l'indentation des paragraphes)
** L'extension préserve les wikilinks, les caractères gras, etc. s'ils sont présents dans le poème. ==== Avantages des sous pages ==== Un exemple: nommer la page principale '''PageX''' <br /> Les sous-pages sont simples à créer: dans la page PageX, ajouter le code [[PageX/Ch 1]] [[PageX/Ch 2]] etc. Cliquer sur les liens rouges va créer les sous-pages voulues. '''Note''': pour ta biographie, '''idéalement''' dans ce cas, sous ton profil ''Machin'', c'est à dire [[User:Machin/Ma bio]], puis lui créer des sous-pages, en les nommant par exemple User:Machin/Ma bio/Mes débuts, User:Machin/Ma bio/Guilde, User:Machin/Ma bio/Aventure dans les lacs, etc... <br /> Plus à https://fr.wikipedia.org/wiki/Aide:Page_utilisateur Les avantages des sous-pages: * Quand on sera dans, par exemple, PageX/Ch 1 alors en haut sera ajouté '''automatiquement''' un lien vers PageX. * Dans la recherche, en tapant PageX, la recherche affichera automatiquement les sous-pages. [[Fichier:Recherche sous pages.png|vignette|Les sous-pages dans la Recherche]] * Dans la page PageX, on pourra ** si on utilise des titres, la PageX aura dans la table des matières tous les chapitres pour la navigation, '''mais''' sans être trop longue (et lourde, lente à charger, pénible à charger sur un téléphone portable etc), et sera aussi plus facile à lire. ** utiliser des titres, avec dessous des liens vers les sous-pages, avec un bref résumé (du contenu des diverses sous-pages). ** utiliser le code <subpages/> qui va afficher toutes les sous pages, avec des puces (mais alors cela n’apparaît pas dans la table des matières). ** utiliser des titres et récupérer dessous tout le contenu des sous-pages, via le code {{:nom souspage}}. On parle alors ici de [[Aide:Transclusion|transclusion]] - et cela a divers avantages - notons la facilité des mises à jour (mettre à jour la sous page), catégories plus précises... Ici, un exemple du code <subpages/>: <subpages/> '''Plus''' à https://www.mediawiki.org/wiki/Help:Subpages/fr et aussi à [[Aide:Transclusion]] (détaille la transclusion, les balises noinclude, includeonly et onlyinclude, ainsi que le surf IG). ==== Liens utiles - Pages spéciales ==== * Tableau trilingue pour les Pages Spéciales [[:en:Wiki_Technical_Guide/Special_Pages]] * Modifs récentes : ** flux atom et [[RSS]] ** 🇬🇧 [https://en.wiki.ryzom.com/wiki/Special:RecentChanges changes] 🇩🇪 [https://de.wiki.ryzom.com/wiki/Spezial:Letzte_%C3%84nderungen DE changes] 🇫🇷 [https://fr.wiki.ryzom.com/wiki/Sp%C3%A9cial:Modifications_r%C3%A9centes Modifications récentes] et [https://atys.wiki.ryzom.com/wiki/Special:RecentChanges common's changes] ==== Les plages trop lourdes peuvent être un soucis IG ==== '''Note''': les pages trop lourdes sont un soucis car s'affichent partiellement IG, du à la limitation en mémoire du navigateur en jeu. * 🇫🇷 [[:fr:Pages longues]] et 🇬🇧 [[:en:Special:LongPages]] * Voir la page [[Aide:Transclusion|Transclusion]] pour en savoir davantage sur les modèles créés à cet effet. IG, la [[Lore]] ne vient pas d'ici (mais d'un autre outil, et par le biais d'un service qui a coupé du code html/css). Le navigateur interne du jeu a une mémoire limitée (attention aux '''images lourdes''') et ne gère pas du tout les CSS. Les wikis sont aussi pour le moment assez mauvais sur un téléphone portable... En fev 2020, les plus longues sont: ::(hist) ‎Manuel de l'utilisateur ‎[134 523 octets] ::(hist) ‎Emotes ‎[79 590 octets] ::(hist) ‎Le petit guide de Silan ‎[69 927 octets] ::(hist) ‎LPOLTF Dossier ‎[67 858 octets] ::(hist) ‎Histoire d’un jeune Fyros ‎[66 832 octets] ==== Tableaux triés ==== Un ex: [[Emotes]] {|cellspacing="0" cellpadding="5" border="1" style="text-align:left;" class="sortable" |-bgcolor="#eee" style="color:black;" !Titre col 1 !Titre col 2 !Titre col 3 |- |} ===Et pour finir=== Ah! Vous êtes impatient de livrer votre oeuvre au grand public, être enregistre dans la [http://fr.wikipedia.org/wiki/Bibliothèque_François-Mitterrand BFM (Bibliothèque Fyro-Matis)], et être aussi célèbre que l'apprenti magicien tryker Arry. Alors, vous voulez vite sauvegarder. Minute papillon! Vous avez bien tout fini? N'oubliez pas la note finale. ====Notes==== À la fin d'un article vous trouverez souvent les informations suivantes, dont le fameux ''<references/>'' qui indique où afficher les notes que vous avez créées avec les ''<ref>...</ref>'' vus plus haut. <div style="margin:0em; padding:1em 2em;border: thin inset #{{ColorAtys|type=dark|group=HRP}};background:#{{ColorAtys|type=light|group=HRP}};color:#{{ColorAtys|type=fg|group=HRP}};"> <poem> ==Références== ===Voir aussi=== *[Quelque part sur la Toile...] *[[Ou dans cette encyclopédie...]] ===Remarques=== *Spécialistes en : [[PJ]], [[PNJ]] *... : ... ===Sources=== *{{Source |Langue=[[:Category:Ja|]] |Auteur=[[user:Rajaaar|]] et [[user:Zorroargh|Zo'ro Argh]] |Perso=PJ |Guilde=[[Guilde:Hoodo|]] |Site=Registre Des Guildes (Ryzom Community Forum-Aniro) |Date=JY 2557 |Page=Hoodo, les chercheurs de Symbiose |URL=http://atys.ryzom.com/start/app_forum.php?page=topic/view/8293 }} *{{Source |Auteur=Derry O'Darren |Perso=chroniqueur tryker |Site=Les chroniques d'Atys |Date=vers 2486 (JY) |Page=Chronique relatant un épisode de la vie de Rosen Ba'Darins |URL=http://atys.ryzom.com/projects/pubfr/wiki/C_EvasionEnFlyner }} *{{Source |Auteur=[[Tyllidolh]] anonyme ramené dans le filet<ref>HRP: le Web</ref> |Date=2006-11-09 |Page=Botanique Lacustre |URL=http://ryzom.kervala.net/logs/2006-11-09%20Botanique%20Lacustre.txt }} ===Notes=== <references /> </poem> </div> Ce qui s'affichera, mais vous l'aviez déjà deviné: <div style="margin:0em; padding:1em 2em;border: thin inset #{{ColorAtys|type=dark|group=HRP}};background:#{{ColorAtys|type=light|group=HRP}};color:#{{ColorAtys|type=fg|group=HRP}};"> <span style="font-size:150%">Références</span> ----- <span style="font-size:120%">'''Voir aussi'''</span> *[http://www.yoyodesign.org/doc/w3c/css2/cover.html Quelque part sur la Toile...] *[[user:zorroargh/Discussion|Ou dans cette encyclopédie...]] <span style="font-size:120%">'''Remarques'''</span> *Spécialistes en : [[PJ]], [[PNJ]] *... : ... <span style="font-size:120%">'''Sources'''</span> *{{Source |Langue=[[:Category:Ja|Ja]] |Auteur=[[user:Rajaaar|Rajaaar]] et [[user:Zorroargh|Zo'ro Argh]] |Perso=PJ |Guilde=[[Guilde:Hoodo|Hoodo]] |Site=Registre Des Guildes (Ryzom Community Forum-Aniro) |Date=JY 2557 |Page=Hoodo, les chercheurs de Symbiose |URL=http://atys.ryzom.com/start/app_forum.php?page=topic/view/8293 }} *{{Source |Auteur=Derry O'Darren |Perso=chroniqueur tryker |Site=Les chroniques d'Atys |Date=vers 2486 (JY) |Page=Chronique relatant un épisode de la vie de Rosen Ba'Darins |URL=http://atys.ryzom.com/projects/pubfr/wiki/C_EvasionEnFlyner }} *{{Source |Auteur=[[Tyllidolh]] anonyme ramené dans le filet<ref>HRP: le Web</ref> |Date=2006-11-09 |Page=Botanique Lacustre |URL=http://ryzom.kervala.net/logs/2006-11-09%20Botanique%20Lacustre.txt }} <span style="font-size:120%">'''Notes'''</span> <span style="color:blue"> ↑</span> HRP: le Web </div> ====Courtoisie==== Une encyclopédie vise avant tout à synthétiser tous les champs de connaissances (Atys). Pour réaliser cela, les articles sont inspirés de diverses sources. Au delà de l'aspect encyclopédique et du tissage de la Toile qui recommande de citer les sources, il y a aussi l'élégance de la reconnaissance du travail d'un auteur. ====Prévisualiser et sauver==== Prévisualiser est aussi une forme de courtoisie. Elle permet non seulement de vérifier que tout est correct avant de valider, mais aussi d'éviter que les historiques de modifications se remplissent inutilement. Bien sûr, Jena ne va pas vous jeter aux mains de Kamis, ou ceux-ci vous plonger dans la Goo si après avoir valider votre sauvegarde vous constatez que vous avez laissé échapper quelques erreurs. <big><big><big>'''Pas de panique!'''</big> si vous avez le message: :<p style="color:red;">Désolé, nous ne pouvons enregistrer votre modification à cause d’une perte d’informations concernant votre session. :Vous avez peut-être été déconnecté. Veuillez vérifier que vous êtes toujours connecté et réessayer. Si cela échoue de nouveau, essayez en vous déconnectant, puis en vous reconnectant, et vérifiez que votre navigateur accepte les témoins (cookies) de ce site. </p> Ce message apparaît souvent, car les wikis n'aiment pas qu'on modifie trop souvent la même page. Il n'est pas nécessairement lié à la capacité de vos PC ou de la qualité de votre connexion au web.<br/><center>'''Réenregistrez la page - et hop ça passe!'''</center></big></big> <!--ref>'''Voir si on peux modifier ce texte''', car il inquiète les nouveaux - cf Kyriann par ex - qui pensent que c'est parce que leur PC est vieux ou mauvaise connexion - elle a suivi l’instruction... et '''a perdu tout ce qu'elle avait écrit''' :( ).<br /> Par exemple: '''C'est un message qu'on a souvent, commence par réessayer d'enregistrer''' (en gras)</ref--> ====Importance==== Si tel est le cas, il vous reste alors à cocher le bouton ''Modification mineure''. Cela vous permet de corriger un article, de faire des évolutions intermédiaires, etc. Grâce à cela, vous pouvez cacher les modifications mineures lorsque vous faites une recherche de modifications. Pensez aux administrateurs! ====Signature==== Enfin, ce n'est pas ici que vous devrez le faire, mais comme c'est le dernier mot de ce paragraphe et que c'est très important quand vous écrivez à quelqu'un ou dans la page de discussion associée aux article, tapez toujours en guise de point final: ~~~~. Cela vous sert de signature datée, qui est en plus un lien votre votre page personnelle. Pour mettre un lien sur ce wiki vers son adresse RC, le code est [https://chat.ryzom.com/direct/Nom Nom sur RC] ou par image [[Fichier:RClogo211905.png|Discutons sur RC en privé|link=https://chat.ryzom.com/direct/Tamarea]] (le code utilisé est ici: [[Fichier:RClogo211905.png|Discutons sur RC en privé|link=https://chat.ryzom.com/direct/Tamarea]]). Très utile pour les traducteurs du wiki: # explication du soucis de signature inter-wiki, par un exemple... Mettons que mon profil est sur le wiki Francais (Utilisateur:MonNom). #* Si, sur une page du wiki anglais (ou autre langue que FR), j'utilise ma signature (avec le code ~~~~)... #* il va mettre un lien sur la page de discussion du profil User:MonNom, qui, lui est sur le wiki anglais #* Il y a alors 2 cas: #** soit je n'ai pas de profil créé sur le wiki anglais, et le lien talk sera rouge (la page n'existe pas) #** soit j'ai créé un profil sur le wiki anglais (lien talk en bleu) - mais je ne serais pas notifiée sur le wiki français, si habituellement je vais peu sur le wiki anglais. Donc, il faudra que je pense à '''vérifier régulièrement''' les 2 (ou plus) pages de discussions :( # Il y a plusieurs '''solutions''': celle de [[Utilisateur:Zorroargh|Zo]] et celle de [[User:Craftjenn|Craftjenn]]. La plus simple est d'utiliser [[Chat/FAQ RC|RC]] et c'est ce qui est présenté ici. #* En haut à droite de l'écran : Préférences, (1er onglet où on arrive), partie Signature : #* "Nouvelle signature" : CraftJenn, Ranger du Cercle du Bois d'Almati ([https://chat.ryzom.com/direct/Craftjenn sur RC]) #* cocher "Traiter la signature comme du wikitexte (sans lien automatique)" ==L'art de rédiger un article== Un wiki est une oeuvre collaborative à plusieurs mains et tout le monde sait qu'il y a autant d'idées que d'homins. Aussi, il convient d'écrire le plus possible suivant le <em>Principe de moindre surprise</em>, c'est-à-dire que le lecteur retrouve les mêmes schémas d'une page à l'autre malgré le fait que cela fut écrit par différents homins. Le MediaWiki offre plusieurs outils et comportement par défaut. Par exemple, dès que vous avez 4 titres, un sommaire est automatiquement générée au dessus du deuxième titre de la page (le titre de la page-même, de niveau 1, étant le premier). Vers [[Schemas et modèles]] : parle des bandeaux, et des modèles... A lire par la suite. ===Le HRP=== Vous connaissez le minimum pour vous débrouiller. Bien sûr il vous faudra fouiller à gauche et à droite. Cela ressemblera à du travail de prospections de Matières Premières de Missions qui seront de plus plus en plus précieuses. Il reste un dernier point que vous ne trouverez pas ailleurs: '''<em>Comment introduire élégamment le HRP dans les articles RP?</em>''' ==== Dates et temps ==== Merci d'utiliser les dates RP. Plus à [[Temps]] et il y a un convertisseur de date à https://ryzom.kervala.net/time.php?shard=atys ====⇒ dans les notes==== Pour de simples notes, on peut se contenter de faire comme dans l'exemple extrait de l'article: '''''[[Flyner]]''''' <div style="margin:0em; padding:1em 2em;border: thin inset #{{ColorAtys|type=dark|group=HRP}};background:#{{ColorAtys|type=light|group=HRP}};color:#{{ColorAtys|type=fg|group=HRP}};"> ...ramené dans le filet<ref>HRP: le Web</ref> </div> qui s'affichera dans les notes de bas de page comme: <div style="margin:0em; padding:1em 2em;border: thin inset #{{ColorAtys|type=dark|group=HRP}};background:#{{ColorAtys|type=light|group=HRP}};color:#{{ColorAtys|type=fg|group=HRP}};"> [[#⇒ dans les notes|↑]] HRP: le Web </div> ====⇒ dans le texte==== Pour une note explicative plus longue mal venue dans une simple note, on peut créer un paragraphe HRP en fin d'article ayant l'aspect de ce paragraphe-ci. Exemple: '''''[[Annuaire des scientifiques d'Atys]]''''' <pre> {{HRP|Un petit commentaire|Un long blablabla}}

Ce qui se traduira par une section colorée comme celle-ci:

Dummy.png
HRP
Un petit commentaire
Un long blablabla


⇒ dans une page à onglets

Pour créer de plus longs textes, créer une page associée et accessible par onglets. Ce cas peut-être utilisé pour détailler le rôle technique/scénario d'un évent. Exemple de mise en forme avec onglet HRP dans l'article Justice_zoraï

Créer un onglet RP/HRP avec différence associée
{{Début des onglets
|preums-1=1
|degrade=oui
|Onglet-1={{PAGENAME}}
|URL-1={{PAGENAME}}
|fond onglet-1=#99CCFF
|Onglet-2=Notes HRP
|URL-2=={{PAGENAME}}/HRP
|fond onglet-2=#99CCFF
|bordure=2px solid #9999FF
|Image-2=Dummy.png
|fond cadre=#EEEFFF
|arrondi=5em
|alignement onglet=center
}}
Catégoriser les articles HRP

Pour faciliter les recherches thématiques, ne pas oublier d'ajouter: [[Catégorie:HRP]]

Note: Catégorie:HRP est en cours de nettoyage, suite à l’uniformisation des catégories, entre les divers wikis.

Les portails

Les portails contiennent des rubriques et souvent des onglets. En général, le portail et les sous-pages et rubriques sont verrouillés de prime accès pour éviter des modifications accidentelles (voire malveillantes). Le source du portail présente alors souvent deux parties, assez petites puisque tout se trouve à l’extérieur du portail. Ainsi, si on prend le portail matis, on voit en haut, le code des onglets et en bas le code des rubriques.

Les onglets

Il se présente comme ceci. 

{{Début des onglets
|Onglet-1=Portail
|URL-1=Portail:Matis
|fond onglet-1=#A2BB6F
|Onglet-2=Protagonistes
|URL-2=Portail:Matis/Protagonistes
|fond onglet-2=#A2BB6F
|Onglet-3=Roleplay
|URL-3=Portail:Matis/Roleplay
|fond onglet-3=#A2BB6F
|Onglet-4=Histoire
|URL-4=Portail:Matis/Histoire
|fond onglet-4=#A2BB6F
|Onglet-5=Relations
|URL-5=Portail:Matis/Relations
|fond onglet-5=#A2BB6F
|bordure=2px solid #A2BB6F
|fond cadre=#FFFFFF
|arrondi=5em
|alignement onglet=center
}}

si l'on veut ajouter un nouvel onglet, par exemple un onglet linguistique, il suffit d'ajouter par exemple en sixième position : 

|Onglet-6=Mateis
|URL-6=Portail:Matis/Mateis
|fond onglet-6=#A2BB6F

Bien sûr, on aurait pu changer l’ordre des onglets. Lorsqu’on corrige (ou crée) des onglets, il faut bien prendre soin de recopier la structure complète des onglets dans chacun d’entre eux pour rester visuellement cohérent. Et pour corriger les différentes pages désignées par les onglets, il faudra se rendre directement sur la page indiquée par l’URL. Le plus simple étant de cliquer sur le titre indiqué sr l’onglet.

Les rubriques

Plus pour des raisons d'élégance que de protection (pour cela il suffit de changer les droits d'écriture), les rubriques ne sont pas éditables à partir du lien qui accompagne chaque titre.

Ceci est un titre dont le contenu est éditable en cliquant sur le lien associé... [modifier]

Pour que le lien "[modifier]" n'aparaisse pas, on ajoute dans la page le mot magique "__NOEDITSECTION__".

Souvent, pour les mêmes raisons, on ne souhaite pas voir de tables de matière s'incruster dans la page. On ajoute dans ce cas un "__NOTOC__".

Mais si l'on veux changer le contenus de ces pages, comment faire alors puisqu'il n'y a plus de lien?

Voici mon truc:

Les pages qui apparaissent dans les structures d'un portail sont de ce type: 

<!-- ========================= PRESENTATION =============== -->
! {{Accueil/Cadre2
| image   = Matis emblem.png
| titre   = En savoir plus
| contenu = {{Portail_Matis/En savoir plus}}
}}

Pour pouvoir changer Portail_Matis/En savoir plus, je copie quelque part dans ma page personnelle "{{Portail_Matis/En savoir plus}}", où je transforme les accolades en crochets. Et comme les doubles accolades font référence à des modèles dans médiaWiki, il faut préfixer la page pour en tenir compte, ce qui donne: " [[Modèle:Portail_Matis/En savoir plus]]". Ce qui me donne le lien pour accéder à la page à modifier: fr:Modèle:Portail_Matis/En savoir plus. Et le tour est joué!

Et après...

Avant tout, que faire alors si vous tombez sur le cas ou une page existe avec un autre titre. Par exemple, vous vouliez écrire Corsaire mais Les corsaires existe déjà. Et bien cela a été prévu dans le MediaWiki: vous pouvez rediriger une page sur une autre: il vous suffit pour cela d'écrire dans la page Corsaire que vous aviez l'intention de créer: 

#REDIRECTION [[Les corsaires]]

Sinon, vous êtes maintenant prêt non seulement pour rédiger, mais aussi pour éditer ce qui existe. Et ça, ce n'est pas toujours facile non plus. Vous pouvez en général ajouter les fioriture qui vous ont été enseignées plus haut surtout au moins une catégorie (la bonne), les liens, les références... Ils sont souvent oubliés par les rédacteurs de passage. Peut-être aimerez-vous rendre RP ce wiki, qui n'est pas Wikipedia, ni une copie de la Lore, et qui peut être aussi utile qu'amusant.

Mais changer le fond requiert plus. Il est très important d'avoir du tact et de toujours de respecter l'auteur. Faire des petits corrections est toujours bienvenu mais parfois si le contenu vous semble erroné il vaut mieux commencer à discuter quand c’est possible avec l'auteur ou dans la page de discussion de l'article. Sinon, il peut arriver que la rédaction de l'article se transforme en PvP


Un exemple de modèle spoiler est à Test spoiler. Les pages de type spoilers devraient être sous la catégorie OVNI.

Pour les codes utiles aux traducteurs voir l'aide des modèles TIP et Trad


Les modèles ou Templates

A utiliser pour ce qui est répétitif. Par exemple, une barre de navigation, commune à plusieurs pages : créer Template:My_Nav (avec les liens) et utiliser avec {{My_nav}} sur les pages pages (chaque fois que Template:My_Nav est modifié, toues les pages qui utilisent le code {{My_nav}} auront bien la dernière version de Template:My_Nav).

Voir par ex la Category:Navigation_templates.

Si tu crées ton propre Modèle, merci d'y ajouter la catégorie [[Catégorie:User Templates]]. Pour voir des exemples: Catégorie:User Templates.

Sur les tables des matières, ou sommaire ou TOC

  • sur le sommaire (apparaît si 4 sections ou sous-sections, automatiquement et à gauche)
    • Pour empêcher le sommaire de s'afficher, on entre __NOTOC__
    • Pour obliger le sommaire à s'afficher, on entre __FORCETOC__
    • Pour obliger le sommaire à s'afficher à un autre endroit, on rentre __TOC__ à l'endroit désiré
    • Éviter que des sections apparaissent dans le sommaire : utiliser ;TEXTE ou '''TEXTE''' (ce dernier à préférer dans les pages de discussion) à la place de

=====TEXTE=====

Références

Voir aussi

Autres trucs et astuces

Pour rendre invisible une catégorie de comptage et sélections aléatoires

Il faut rajouter quelque chose comme:

La '''catégorie ''Portail:Chroniques/Articles liés''''' est une catégorie technique qui contient les articles qui renvoient au ''Portail:Chroniques'' par l’intermédiaire du bandeau de bas de page ''<nowiki>{{</nowiki>[[Modèle:Portail|Portail]]|Chroniques}}''.

__HIDDENCAT__

Ensuite, l'utiliser comme:

[[Special:RandomInCategory/Portail:Chroniques/Articles liés]]

Remarques

Au sujet de...

Beaucoup de choses ont été écrites, et bien écrites, ici et là sur la manière de rédiger un article. Ma propre expérience des MediaWiki (comme celui-ci ou Wikipedia) m'a montré que le foisonnement d'informations rebute plus d'un rédacteur potentiel. Trop peu de temps pour se perdre dans les méandres d'un outil qui était censé être simple et qui à force requiert de compétences, ou du moins d'une tournure d'esprit informatique.

Mes amis et complices et les nouveaux contributeurs de Ryry peuvent venir commenter ce travail de préférence dans ma page de discussions. Mais ici, n'hésitez pas à corriger les fôtes d'ortho et de type qui s'y glissent.

Utilisateur ou PJ?

Si ce wiki est fait par et pour les atysiens, pourquoi utiliser un second pseudo? Personnellement je trouve plus dans le jeu d'utiliser le profil contributeur pour l'avatar et de le faire parler lui. Personnellement, c'est ce que je préfère utiliser, quitte à ajouter un onglet HRP à ma page. Dans ce cas, la question de savoir s'il est bon ou non de s'étendre sur la description d'un PJ s'en trouve simplifiée.

Espace fine

Les lecteurs méticuleux constateront que j'écris très souvent sans utiliser d'espace entre le dernier mot et les points d'interrogations, points d'exclamation, deux points et point virgule. Ce n'est pas un oubli. C'est un mélange de pragmatisme et d'esthétisme. Normalement ces quatre signes de ponctuation sont précédés d'une espace insécable. Or je n'en ai pratiquement jamais vu d'interprétation correcte dans aucun navigateur, ni autres outils similaire, tout simplement parce que le texte qui y est écrit ne contient qu'une espace normale, c'est à dire sécable. Et cela peut donner des choses horribles comme par exemple<br\>: un point virgule en début de ligne comme ici. Il aurait fallut utiliser pour cela le code html &nbsp;, ce qui n'est donné ni spontanément par mon clavier ni par un copié/collé d'un texte pourtant bien formaté... Et je dois vous avouer que même en étant perfectionniste, je n'ai pas le courage de taper ça en plus pour augmenter la probabilité de fautes de frappe.

J'ai eu l'opportunité de travailler avec des Québécois, et j'ai apprécié emprunter à leur vocabulaire des termes comme courriel, texteur... Je pouvais aussi emprunter leur typographie, d'autant plus que je la trouvais (et trouve encore) plus harmonieuse. Eux utilisent l'espace fine, c'est à dire la moitié d'une espace normale. Mais, l'espace fine insécable n'existe pas en html, et si on peut l'insérer en unicode (&#8239; ce qui serait encore plus fastidieux qu'en html), il n'en est pas pour autant toujours bien interprété par les navigateurs. Les Canadiens avaient donc le choix entre l'espace insécable mais difficile à manipuler et l'espace nulle comme les anglo-saxons. Ils ont choisi la solution la plus simple en copiant leurs voisins... et je fais de même.

http://typofute.com/l_espace_fine_insecable_dans_les_documents_html

Notes

Sur la navigation sur le wiki IG (depuis le jeu), et les limites du client en jeu : Guide de rédaction/Wiki IG

#pj-ryzom_wiki est le canal RC pour parler du wiki

Sources



  1. ↑ Les curieux peuvent regarder ce lien http://fr.wikipedia.org/wiki/Wikipédia:Conventions_typographiques, et suivre le fil très intéressant.
  2. ↑ exemple de note


Date du copier/coller : CraftJenn, Ranger du Cercle du Bois d'Almati 8 septembre 2018 à 14:49 (CEST)

Récupérée de « https://fr.wiki.ryzom.com/w/index.php?title=Guide_de_rédaction_2018&oldid=61666 »