Utilisateur:Zorroargh/Guide de rédaction

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.

J'essaie, donc, de rédiger un «mini-guide pour les nuls» avec une teinte roliste, c'est-à-dire, de faire une encyclopédie rédigée pour et par les «avatars» (plus que par leur «anima»).

Je me concentre ainsi ici plus sur l'art que sur la manière de faire un article.

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.

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... soyez proche d'une entrée de dictionnaire. Il vaut mieux écrire un article sur Corsaire que sur Les Corsaires même si au final c'est bien des corsaires en tant que tribu dont on veut parler.
Si vous avez l'impression que l'article devrait être écrit, mais peut-être avec 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! maintenant, 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 wyziwag 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

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.

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.

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.

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.

Voici donc comment produire les deux types:

'''En gras''' et ''en italique'' et les '''''deux''''' la fois.

Ce qui donne:

En gras et en italique et les deux la fois.

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 deux endroits différents dont voici les URL:

C'est dommage, mais il faut y aller un peu à la pèche... mais heureusement, il n'y a pas trop d'images.

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 Boîte à outils la commande Copier sur le serveur et suivre les instructions.

Et voilà, on peut passer à l'étape suivante.

Insertion d'une image

L'emblème de l'ASA

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

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

Le lien sur une partie d'un document comme Le luminaire d'Atys ou 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 le site ballistic mistix .
Et la référence qui est un lien vers une note^[2] mis en bas de page, comme on peut le voir sur cette ligne.

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.

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.

Et pour finir

Ah! Vous êtes impatient de livrer votre oeuvre au grand public, être enregistre dans la 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.

==Références==
===Voir aussi===
*[Quelque part sur la Toile...]
*[[Ou dans cette encyclopédie...]]
===Experts===
*Spécialistes en : [[PJ]], [[PNJ]]
*... : ...
===Sources===
*PJ, Guilde, Date, Nom du site, ''[URL et nom de la page]''
*PNJ, Titre, Date, Nom du site, ''[URL et nom de la page]''
*[[Tyllidolh]] anonyme ramené dans le filet<ref>HRP: le Web</ref>, ''[URL et nom de la page]''

===Notes===
<references />

{{Portail|...}}
[[category:...]]

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 tissage de toile qui recommande de citer les sources, il y a aussi élégance de la reconnaissance du travail d'un auteur.

Prévisualiser

Importance

Signature

L'art de rédiger un article

Là, c'est un peu plus complexe. Nous allons utiliser un nouvel objet de MediaWiki: le modèle.

Le modèle

Les modèles ont été créés pour permettre de reproduire la même chose sur plusieurs pages. Pour les utiliser, il faut les inclure dans une page en utilisant cette notation : {{Nom du modèle}}

On rencontre fréquemment des modèles s'écrivant de cette manière simple : {{Ebauche}} ;{{Incomplet}} ;{{Clear}}.

Cependant, il existe des modèles utilisant des paramètres qui sont de deux types:

Modèle multi paramètres sans nom de paramètre : {{Nom du modèle | Valeur1 | Valeur2 | ...}}. C'est le cas pour le paramètre unique : {{Nom du modèle | valeur du paramètre}}
Modèle multi paramètres avec noms de paramètre : {{Nom du modèle | Paramètre1 = ... | Paramètre2 = ... | ...}}

Les modèles de ce site sont regroupés sous la catégorie Catégorie:Modèles. Il vaut mieux se reporter à la documentation du modèle pour connaître les paramètres, les valeurs autorisées et leurs expressions finales dans les pages.

Pour ce qui nous concerne ici, seules l'insertion d'une image et l'instruction {{clear}} nous intéressent.

Cette page est inachevée

Ce qui suit est est en construction ou à compléter. Pour aider l'Encyclopatys, Discutez-en ou améliorez-la !

Une bannière d'état (rien quand normal)-Faire une liste de bannières (LCM, et type Lore, RP)
Un résumé. Reprendre en début (le plus possible) le titre du document en caractère gras. Par exemple: Ceci décrit l'art de rédiger un article dans ce wiki...
Un taxobox
premier titre est de niveau 2 ==titre niveau 2==
terminer par les références
outil de navigation
- frise temporelle et autre "curseurs"
- classification thématique
- renvoi
- portail
la catégorie: en général les derniers niveaux: p.ex doigt appartient à main et pied, inutile voire inadéquat de le mettre dans membres

==Références==
===Experts===
*Spécialistes en : [[PJ]], [[PNJ]]
*... : ...
===Sources===
*PJ, Guilde, Date, Nom du site, ''[URL et nom de la page]''
*PNJ, Titre, Date, Nom du site, ''[URL et nom de la page]''
*[[Tyllidolh]] anonyme ramené dans le filet<ref>HRP: le Web</ref>, ''[URL et nom de la page]''

===Notes===
<references />
{{Liste|[[Boisson]]s}}
{{Portail|Tryker}}
[[category:boissons]]

Le HRP

Comment introduire élégamment le HRP dans les articles RP?

⇒ dans les notes

Pour de simples notes, on peut se contenter de faire comme dans l'exemple extrait de l'article: Flyner

...ramené dans le filet<ref>HRP: le Web</ref>

qui s'affichera dans les notes de bas de page comme:

↑ HRP: le Web

⇒ 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

<div style="margin:0;
padding:1em 2em;
border:thin inset #{{ColorAtys|type=dark|group=HRP}};
background:#{{ColorAtys|type=light|group=HRP}};
color:#{{ColorAtys|type=fg|group=HRP}}">
==HRP==
blablabla
</div>

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

Insérer des liens inter-page

On peut relier la page HRP à la page RP par des liens en utilisant le modèle Modèle:RP-HRP. Par exemple:

{{RP-HRP|HRP=Un essai de lien RP-HRP|RP=Un texte à expliciter}}

qui s'affiche

{{{1}}}

.

Catégoriser les articles HRP

Pour faciliter les recherches thématiques, ne pas oublier d'ajouter:

[[Catégorie:HRP]]

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

[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] xemple de note

[1]

[2]

De EncyclopAtys

Sommaire