¡Traducción que tiene que ser revisada!

¡No culpes a los contribuyentes, pero ayúdalos! 😎

Texto de referencia (Texto actualizado, utilizado como referencia) :
Notas :

 

Página obsoleta

Esta página está archivada bajo Obsoleto.

Primera guía para el uso de los homins de Atys y teams de Ryzom.
Esta guía es mejorada continuamente por varios colaboradores de Encyclopatys y la última versión visible en la Ayuda

Portal de los entresijos Atys (X-files) • Objetos perdidos

Esta guía de escritura es una mini-guía para debutantes con un matiz juego de rol, es decir, hecha para una enciclopedia escrita para y por los «avatares». Fue escrita en el momento en que el wiki francés tenía este estado de ánimo. Desde entonces, el wiki se ha enriquecido con muchos nuevos conceptos y necesidades. Sin embargo, la guía sigue siendo actual en cuanto a la presentación de las reglas gráficas y visuales que marcan la especificidad de la Enciclopedia de Atys, la Enciclopatys. Esta guía se centra más en el arte que en la manera de hacer un artículo, mientras que rápidamente da los elementos básicos para tomar el control de estos fabulosos MediaWiki.

Al principio

Me gustaría escribir algo. Qué buena idea! Pero quizás ya esté escrito, así que lo más sabio es buscar si alguien te ha adelantado. Y ahí, ¡oh! maravilla! el wiki dice que el artículo existe, o se muestra:

Si pasa el cursor sobre la página escrita en rojo oscuro verá (no aquí, porque deliberadamente no activé este enlace) el nombre de la página subrayado y mostrar "Trucobolite (página inexistente). Todo lo que tienes que hacer es hacer clic para abrir una página en blanco y comenzar la aventura.

¿Es tan simple? Um, casi. Justo antes de empezar, sigue estos consejos para elegir un título:

• Evite el plural en el titulo de los artículos tanto como sea posible... Seas cerca de una entrada de diccionario. Es mejor escribir un artículo sobre Corsario que sobre Corsarios, incluso si al final queremos hablar de corsarios como tribu.
• Si tiene la impresión de que el artículo debe escribirse, pero tal vez con una ortografía vecina, puede usar el motor de búsqueda de Google escribiendo la instrucción en él:

trucobolite site:https://es.wiki.ryzom.com

¿Qué pasa si la página que quería ya existe? Ah! esta es otra aventura. ¡Más tarde! ahora la pregunta es:

Empezar con la página en blanco

Para escribir en un wiki, lo más fácil es escribir, escribir, escribir...

Y así empiezas...

Después de varios cientos de caracteres tecleados alegremente, quisieras echar un vistazo a tu trabajo, y como todo el mundo lo ha aconsejado (pero no lo hace muchas a veces aquí) elijas el botón Mostrar previsualización en lugar de Guardar cambios. Y, ¡oh, sorpresa! tu texto es solo un montón de palabras poco elegantes que se siguen una a la otra sin fin.

Mientras no estés acostumbrado a MediaWiki, puedes obtener resultados algo sorprendentes al principio. Pero con muy pocas reglas, es posible escribir rápidamente un texto bueno y hermoso.

De hecho, MediaWiki fue diseñado en un momento en que el WYSIWYG no era un lugar común. Y, sin embargo, estaba destinado a ser fácilmente accesible para los científicos no informáticos, para aquellos que trabajan sin ratones, para los discapacitados visuales... Por lo tanto, era necesario trabajar de la manera más eficiente posible (es decir, agotando lo menos posible, especialidad tanto de Tryker como de informáticos entre otros) y, por lo tanto, era necesario jugar con gestos simples como repetir la misma tecla para obtener un cierto resultado. Pero en primer lugar, tratemos de verlo claramente.

Formateo básico

Párrafo

En MediaWiki, un «retorno de carro» no es una «nueva línea» y mucho menos un salto de párrafo. En espíritu, este wiki está muy cerca de HTML. Y en este último, la nueva línea no tiene otro significado que el de hacer que las líneas sean más legibles en la «fuente». Por lo tanto, para hacer un nuevo párrafo, necesita dos «retorno de carro» (o una línea blanca). Aquí hay un ejemplo para ilustrar estos «retorno de carro»:

Ce qui s'affichera:

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

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:

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:

Ce qui donne:

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:

est simplement obtenu par ça:

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:

• http://fr.wiki.ryzom.com/w/index.php?title=Spécial:Liste_des_fichiers&sort=img_timestamp&limit=50&desc=1
• http://atys.wiki.ryzom.com/w/index.php?limit=500&ilsearch=&user=&title=Special%3AListFiles

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 Outils la commande Importer un fichier" et suivre les instructions.

Cliquer sur "Parcourir" pour choisir l'image qui est sur votre machine, il peux être utile d'indiquer des mots clefs dans Summary ; 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).

Insertion d'une image

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:

L'emblème de l'ASA, ex thumb droit

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.

Barre d'outil (mode édition du wiki)

cadre|centré|En mode d'édition d'une page, voici la barre d'outil d'édition du wiki Juste après l’icône "Liens" se trouve "Fichier inséré", qui ouvre cette fenêtre, bien mal nommée (pour ceux qui préfèrent une interface graphique, bien que comprendre le code wiki est assez facile et indispensable à tout bureaucrate consciencieux) : thumb|centré|La fenêtre qui apparaît après avoir cliqué "Fichier inséré", permet d'ajouter facilement une image déjà hébergée sur le wiki (le bouton Télécharger semble ne pas fonctionner chez moi - dixit CraftJenn)

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 dessous). Cela facilite la lecture/modification du code wiki, 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 :

• 

  Barre d'outil du mode édition de ce wiki

• 

  L'emblème de l'ASA, ex de gallerie

• 

  mal nommée, car ne permet pas d'envoyer une image, mais juste de l'ajouter dans la page

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:

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

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

Et pour finir

Ah! Vous êtes impatient de livrer votre œuvre au grand public, être enregistré 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.

Ce qui s'affichera, mais vous l'aviez déjà deviné:

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évisualisez!

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 validé votre sauvegarde vous constatez que vous avez laissé échapper quelques erreurs.

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

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 Principe de moindre surprise, 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).

Le schéma d'une page

Si l'on prend référence sur Wikipedia, on peut se proposer de suivre ici le même squelette global de présentation de l'article.

Tout en haut de l'article sous le nom de la page, on peut trouver des bandeaux. Ces bandeaux prévienne le lecteur de la qualité de ce qui va être lu: ébauches, incomplet, obsolète, à revoir, etc... Par défaut, l'absence de bandeau indique que l'article est normal. Normal dans tous les sens, c'est-à-dire pas super-extra ou validé et approuvé par les anims. Ça aussi ou pourrait l'avoir...

Ensuite vient le résumé de l'article, indispensable dès qu'il y a au moins deux sous-titres. Le nom de l'article est par convention toujours repris dans ce résumé. Il doit être rapidement vu donc autant que possible dans les premiers mots de la première phrase. De plus il est mis en police grasse, comme on peut le voir dans l'introduction de cet article-ci.

Parfois, il est utile d'adjoindre une infobox dans cette même zone, toujours entre le nom de la page (titre de niveau 1) et votre premier titre (titre normalement de niveau 2). Les infobox sont des petites boîtes de condensé d'informations.

Voici un exemple de début possible:

Tout ce que vous écrivez par la suite est comme vous le sentez, vous... et la communauté sur EncyclopAtys, qui comme tout wiki est auto-modéré.

Il ne vous restera plus qu'à bien terminer votre article en bas de page.

Déjà, nous avions parlé des références. Voici quelque détails en plus à ajouter en dessous. Tous sont servent plus à faciliter la navigation arrière ou thématique, comme:

• les renvois à un article mère telle qu'une liste
• les palettes de navigation
• les portails
• les catégories

Voici ce qui s'affichera, et ne me dites pas que vous avez deviné le résultat, car là, nous avons utilisé un nouvel objet: le modèle. Nous en parlerons juste après.

Si tous ces objets, bandeaux, palettes, etc. sont facultatifs, il est néanmoins fortement conseiller de toujours mettre la catégorie qui permet de ranger les articles par thème.

La règle pour les catégories est de choisir les derniers sous-niveaux. Par exemple, doigt appartient à main et pied, mais il est inutile voire inadéquat de le mettre dans membres si ce dernier contient main et pieds.

Comment trouver la bonne catégorie? Il faut aller fouiller soit dans la liste générale, soit quand on connait un point de départ, dans les arborescences. Le point de départ le plus standard est Encyclopatys, mais on peut trouver d'autres racines non classées, inclassables ou oubliées.

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.

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

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

⇒ 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

{{HRP|Un petit commentaire|Un long blablabla}}

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

Plantilla:RP-HRP.

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