Guía de Redacción

De EnciclopAtys

Saltar a: navegación, buscar
de:Anleitung zum Schreiben
en:Writing Guide
es:Guía de Redacción
fr:Guide de rédaction
ru:Руководство по редактированию
 
UnderConstruction.png
¡Traducción que tiene que ser revisada!
¡No culpes a los contribuyentes, pero ayúdalos! 😎
Texto de referencia (Texto actualizado, utilizado como referencia) :
Notas :

Esta guía de redacción es una mini-guía para novatos con un matiz de rol, es decir, construido para una enciclopedia escrita para y por los personajes (más que por su ánima oculta detrás de su módulo de interfaz Karavan [1] rasgando una coraza de arma). Esta guía se enfoca más en el arte de la composición de las páginas que en el cómo hacer artículos. Sin embargo, rápidamente provee al lector con las bases esenciales para que el tome control de esta fabulosa MediaWiki.

#pj-ryzom_wiki es el canal RC (RyzomChat) para hablar acerca de las wikis

Para empezar

Te gustaría escribir algo, ¡Una gran idea!, pero puede que ya haya sido escrita. Así que, lo más sensato es averiguar sí alguien lo ha hecho antes que tú. Y entonces, ¡hermosamente! la wiki dice que el artículo existe o te muestra:

Resultados de la búsqueda

...

No hay resultados que cumplan los criterios de búsqueda.

Crear la página « Trucobolite » en este wiki.


Sí tu pasas el ratón sobre el texto escrito en rojo oscuro (no en este caso, porque intencionalmente no he añadido ningún enlace) tu verás el nombre de la página iluminado y se mostrará "Trucobolite (la página no existe)". Todo lo que tienes que hacer es clic para añadir una página en blanco y empezar la aventura.

¿Es tan simple? Uf, casi. Sólo que antes de empezar, sigue estos consejos para elegir un título:

  • Evita tantos artículos como sea posible, plurales... parecido a una entrada en el diccionario. Es mejor escribir un artículo como "Corsarios" que "Los Corsarios", aun cuando los corsarios sea la tribu de la que queremos hablar.
  • Sí piensas que el artículo pueda haber sido escrito, pero quizás con una ortografía similar, tu puedes usar el buscador de Google escribiendo la frase: trucobolite site:http://en.wiki.ryzom.com (para búsqueda en inglés) o trucobolite site:http://es.wiki.ryzom.com (para su equivalente en español).

¿Y si la página que querías ya existe? ¡Ah, esa es otra aventura para más tarde! Ahora la pregunta es:

Empezando una página en blanco

Para escribir en una wiki, la vía más fácil es escribir, escribir, escribir...

Y así empiezas...

Después de cientos de caracteres ingresados rasgando en tu teclado tu deberás hacer una revisión de tu trabajo, y como todo el mundo ha aconsejado elegir el botón Vista previa en lugar de Guardar. Y, ¡Oh, sorpresa! tu texto es un montón de palabras sin terminar y carentes de elegancia.

Si no estás acostumbrado a MediaWiki (https://es.wikipedia.org/wiki/MediaWiki), quizás no obtengas resultados sorprendentes a la primera. Pero con muy pocas reglas, es posible escribir rápidamente un texto bueno y bonito.

De hecho, MediaWiki fue diseñado en el tiempo en que WYZIWYG (en español, "lo que ves es lo que obtienes") no era un sitio común; sin embargo, deseaba ser fácilmente accesible para no informáticos, aquellos que trabajaban sin un ratón, visualmente deteriorado... Fue entonces necesario trabajar tan eficientemente como fuera posible (es decir, cansar lo menos posible, especialidad tanto de Tryker como de los informáticos entre otros) y así, fue necesario ejecutar simples gestos como repetir la misma tecla para alcanzar un cierto resultado. Pero primero, intentemos verlo claramente.

Formato Básico

Párrafo

En MediaWiki, un retorno de carro no es un salto de línea solo es un salto de párrafo. En espíritu, esta wiki esta muy cerca de HTML. Y en definitiva, el salto de línea solo significa que aquellas líneas serán más legibles en la fuente. Así, para hacer un nuevo párrafo, usted necesita dos retornos de carro (o una línea en blanco). Aquí hay un ejemplo para ilustrar estos retornos de carro:

Este es un ejemplo de
un texto escrito en
3 líneas.

Y este un nuevo párrafo.
 En el caso que una línea comience con un "espacio"
da un efecto especial, muy útil, pero quizás inesperado en el contexto.

Esto se mostrará como sigue

Este es un ejemplo de un texto escrito en 3 líneas.

Y este es un nuevo párrafo.

En caso que una línea comience con un espacio

da un efecto especial, muy útil, pero quizás inesperado en el contexto.

Títulos

Su texto ya es más legible, pero probablemente carece de organización. Para ello, usted deberá añadir títulos. Aquí la técnica es muy simple, sólo enmarcar el texto dentro de "=" como se muestra en el siguiente ejemplo, tomado de este pasaje:


==Empezando una página en blanco==
===Formato Básico===
====Títulos====

Y, Ud. me dirá, ¿por qué no =Title level 1=? No, este está reservado para quienes usan MediaWiki para hacer el título de la página.

Comentarios y pestañas wiki

Un comentario es un texto, insertado en el código wiki de una página, que solo podemos ver si modificamos la página wiki = permanece invisible a la pantalla (o en otras palabras: sólo aquellos con derechos de edición pueden verlo).

<!-- Este es un ejemplo de un comentario invisible -->

La wiki interpreta el código wiki que usted ingresa en una página; está diseñado para de modo automático realizar varias tareas dependiendo del contexto. Por ejemplo:

  • antes de grabar una página, interpreta el código (aquí una vista previa, la cual da una idea del trabajo silencioso hecho por la wiki, justo antes de guardar esos códigos). Podemos entender este aspecto con los comentarios y la etiqueta nowiki.
  • antes de mostrarla (el modo lectura vía vista de página: oculta el comentario, procesa la etiqueta nowiki, ... el modo de escritura a través de la vista de Edición: muestra los comentarios...), ...

Esta página de ayuda usa frecuentemente la etiqueta nowiki para mostrar el código wiki.

¿Qué es una etiqueta?
Es una serie de caracteres, usado para estructurar un documento y los mismos serán invisible para los lectores finales. En general (el salto de línea es una de las excepciones bien conocidas) hay una etiqueta de inicio y una etiqueta de cierre - HTML sigue esta lógica, y el código wiki tiene mucho en común con el. Típicamente: '''<a_tag>''' bla bla '''</a_tag>'''

Con la etiqueta nowiki tan pronto como la wiki reconoce la primera etiqueta, en lugar de trabajar como es usual, cambia el modo hasta llegar a la etiqueta de cierre. En la barra de herramientas wiki, abra la barra avanzada para ver su icono (justo antes de la lista numerada).

Sacar a relucir

¡Bien, no, nosotros no enfatizamos, nosotros no destacamos!  :)

Cuando algo es importante, usted tiende a incrementar su voz o cambiar el tono. Uno podría decir lo mismo de la escritura: coloca caracteres en negritas. No hace falta decir que, no es necesario alzar la voz todo el tiempo... es agotador.

Una convención (pero no una obligación) es siempre escribir, antes del primer título, un resumen en el cual el nombre del artículo aparezca tan pronto como sea posible. Este hábito tiene la intención de confirmar al lector que está en la página correcta, lo cual es muy útil cuando algunas páginas son redirigidas.

¿Y las itálicas? Basicamente, podríamos decir que son citas y la expresiones que se hallan fuera del idioma contextual corriente (títulos honoríficos, palabras foráneas, redacción,... ) y aquello que podríamos colocar entre marcas de citas. Por ejemplo, para nosotros Atysianos, podría ser una expresión OOC en el texto.

He aquí cómo producir ambos tipos:

'''En negritas''' y ''en itálicas'' y con '''''ambas'''''.

Mostrará

En negritas y en itálicas y con ambas.

¡Cuándo le dije que estaría tipeando treinta y seis veces la misma tecla!

Listas

Bien, de seguro, ahora que usted sabe cómo escribir en la wiki, usted quiere compartir recetas, materias primas a extraer... y entonces, usted está en una cierta búsqueda, en un cierto orden... es fácil en MediaWiki. Para obtener esto:

  • una lista de ítem está compuesta de una secuencia ordenada
    1. compuesta a su vez de una lista
      • A
      • B
    2. etc.
  • etc. ...

usted necesita escribir esto:

*una lista de ítem está compuesta de una secuencia ordenada
*#compuesta a su vez de una lista
*#*A
*#*B
*#etc.
*etc. ...

Añadir una imagen

Hasta ahora, nosotros tenemos solo texto, y aún nada parecido a una imagen para aclarar una descripción (¡describir la fauna y la flora sin imágenes!) o solo para mejorar la lectura.

Which image?

Before placing an image on a page of EncyclopAtys, it must have been downloaded beforehand. We strongly advise, before going further, to re-read the EncyclopAtys:General warnings and http://atys.wiki.ryzom.com/wiki/Terms_of_Use

Where to find the pictures?

The images are stored in the COMMON wiki (common to all wikis: French, German etc) :

How to put a personal picture

I found or made an image that I want to insert in an EncyclopAtys article. (Warning: the image must be under a free license like the GFDL. )

To import the image, you have to choose from the menu Tools the command Import a file" and follow the instructions.

Click on "Browse" to choose the image that is on your machine, it can be useful to indicate keywords and category in Summary; validate at the bottom in click "Unload file" (wait for the sending of the image on the servers of Atys).

The image has been sent (we no longer see the instructions for help with insertion). However, it must now be inserted into the wiki code (copy the exact name of the file, eg "File: Barreswiki.png" go to the next step).

The images are hosted in the Common (URL address that how in atys: https://atys.wiki.ryzom.com/wiki/Home). More on Tips for categorizing an Image.

Inserting an image, wiki code

To insert an image, just write: [[file:Name of the picture | thumb | where | size | alt=Textual Alternative | Legend]]. For example, to display the 2 images of this paragraph, write:

[[file:Dummy.png|thumb|right|alt=A strange sphere, ex thumb right|The emblem of the ASA, ex thumb right]]
[[file:Dummy.png|64px|alt=A strange sphere, ex 64|The emblem of the ASA, ex 64]]

A strange sphere, ex thumb right
The emblem of the ASA, ex thumb right

A strange sphere, ex 64 where the Name of the picture is preceded by the prefix «file:». The other parameters are optional.

Galleries

If we have several images, we can use the "file gallery" (on the toolbar in edit mode of the wiki, the icon just to the right of "Insert").

This makes it easier to read/edit the wiki code because it adds gallery tags; thus, each image will be on a line (in the wiki code), with a simple syntax: filename.jpg the "vertical bar" (AltGr + 6) and a description:


Images and links

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

Links

There are several kinds of possible links in a MediaWiki document. Here is the list:

Note that the letters attached to this type of link unite to form a single word: flyners. We can of course rename to adapt to the context: planiant plant ...

Here is the wiki code:


* internal link as [[User Manual]]
Note that the letters attached to this type of link unite to form a single word: [[flyner]]s.
We can of course rename to adapt to the context: [[flyner|planiant plant]] ...
* link to a title [[User Manual#Web Applications]] or on title (same page) [[#Galleries|Gallery's title on this page]]
* external link is very simple, as in https://ryzom.silenda.de but if you want a more elegant presentation you can use [https://ballisticmystix.net the website ballistic mystix] .
* And the reference which is a link to a note <ref>example of note</ref> at the bottom of the page, as can be seen on this line.
* Links to other wikis (interwiki links): add the language before, such for common [[:atys:Category:User work|User work images]], or to the French version of this guide: [[:fr:Guide de rédaction]].

And if you see the following message at the bottom of your page, do not worry, we'll see that right away...

Reference error : some <ref> exists, but no <references/> found.

A trick is to create a template to have a navigation bar in the page (an example here, with this template). For the anchor at the top of the page, use the code <div id="Top"></div>

To link to a wiki page on an other wiki, see Help:Interwiki.

Other tips

About History (just after the Edit tab), a basic functionality of wikis: https://en.wikipedia.org/wiki/Help:Page_history

citation, poems...

  • "quote tags" <q> blblbl </q>. The enclosed text will appear with an italic serif font withi appropriate quote (language dependant) characters. An example: blblbl
  • "poem tags" is a wiki extension. <poem> Looooooooooooooooooooooooooooooong text or not so long </poem> will display:

 Looooooooooooooooooooooooooooooong text or not so long

The Poem extension allows easy formatting of poems and similar material within Wikitext. Once the extension is enabled, you can put any block of text within <poem></poem> tags, which has the following effects:
  • All newlines are preserved by converting them into <br /> tags
  • The block of text is enclosed in <p>...</p> tags (as well as a div of class "poem")
  • Colons at the beginning of a line are converted into 1 em indentation
  • Spaces at the beginning of a line are preserved and no longer invoke the <pre> tag (a must to have paragraph indentation)
  • The extension preserves wikilinks, bolding, etc. if they are present in the poem.
  • "center tags" anything between these tags will be centered to the page <center> blblbl </center>.
    • Note that floating images or tables reduce page size, thus the {{clear}} template is often useful to force text to appear under an image.
    • Note also that you may need to add a couple of cente tags if a new line breaks it. It isn't necessary if you use only
      to separate different lines.
  • emdash space (ALTGR then -, or U+2212 U+0020) is useful, often combined with quote tags to separate the sentences of in dialogs. Ex: blakjhd -


Examples: The_Kitin_Song, Tears_of_Serenity, A_Flyner_Escape

Useful links (Special pages)

Pages too long can be an issue IG

Note: long/heavy page is an issue, if user read wiki from the game, as the game browser is limited in memory (for ex, User Manual :( Therefore, for some pages, it would be better to check IG if they are fully displayed.


for EN it's, in Feb 2020:
(hist) ‎User Manual‎ [87,963 bytes]
(hist) ‎Paul C. R. Monk – Bloomtree ‎[75,959 bytes]
Story of a Young Fyros ‎[61,565 bytes]
(hist) ‎Categorization ‎[60,455 bytes] -> not an issue as it's NOT for helping homins but for wiki contributors
(hist) ‎Chapter II - Vigils in the Marauder Camp ‎[58,750 bytes]

IG, the Lore don't comes from here (but from an other tool, and through a service who cut some html/css code). The game's internal browser has a very limited memory (css issues too). User Manual v3 can't be read IG because it's too long and too big. The User Manual, faq and help should be quite light. The wikis are quite bad on a cell phone too...

A solution: use titles, and below the title, create a sub page.

  • More on Help:Transclusion (about partial transclusion tags noinclude, includeonly and onlyincude, and template for the wiki In Game too).

Sorted array

An ex: fr: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 |- |}

And to finish

You want to save your page. Wait a sec! Sure it's finish? Don't forget the final touch.

Notes

At the end of an article you will often find the following information, including the famous <references/> which indicates where to display the notes you created with the <ref>...</ref> seen above.


==References==
===See as well===
*[Somewhere on the web...]
*[[Or in this encyclopedia...]]
===Remarks===
*Specialists in : [[PC]], [[NPC]]
*... : ...
===Sources===
*{{Source
 |Langue=[[:Category:Ja|]]
 |Auteur=[[user:Rajaaar|]] and [[user:Zorroargh|Zo'ro Argh]]
 |Perso=PC
 |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
 }}

===Notes===
<references/>

Courtesy

An encyclopedia aims above all to synthesize all fields of knowledge (Atys). To achieve this, the articles are inspired from various sources. Beyond the encyclopedic aspect and the weaving of the Web, which recommends citing the sources, there is also the elegance of the recognition of the work of an author.

Preview and save

Previewing is also a form of courtesy. It not only makes it possible to verify that everything is correct before validating, but also to avoid that the modification histories fill up unnecessarily. Of course, Jena will not throw you into the hands of Kamis, or they will plunge you into the Goo if after validating your backup you find that you have missed some errors.

Note: if you get the message (which appears often, because wikis don't like people changing the same page too often - it's not related to the capacity of your PCs or the quality of your connection to the web), save the page again - and you're done!

Sorry! We could not process your edit due to a loss of session data. You might have been logged out. Please verify that you're still logged in and try again. If it still does not work, try logging out and logging back in, and check that your browser allows cookies from this site.

Importance

If this is the case, you then have to check the Minor modification button. This allows you to correct an article, make intermediate changes, etc. Because of this, you can hide minor changes when you make a search for changes. Think of the administrators!

Signature

Lastly, this is not where you will have to do it, but since this is the last word in this paragraph and it's very important when writing to someone or in the article-related discussion page, type always as an end point: ~~~~.

This serves as a dated signature, which is additionally a link to your personal page.

To add a link on this wiki to your RC adress, the wiki code is [https://chat.ryzom.com/direct/YourName YourName on RC] or using an image Private message on RC [[File:RClogo211905.png|Private message on RC|link=https://chat.ryzom.com/direct/YourName]]

as here Contact Craftjenn on RC


Very useful for wiki translators:

  1. explanation of the inter-wiki signing issue, for example... Let's say my profile is on the English wiki (User:MyName).
    • If, on a page of the French wiki (or other language, such DE, ES, RU), I use my signature (with the code 16:10, 3 March 2020 (CET))...
    • it will put a link on the discussion page of the profile User:MyName, which is on the English wiki
    • Then there are two cases:
      • either I don't have a profile created on the French wiki, and the talk link will be red (the page doesn't exist)
      • either I created a profile on the French wiki (talk link in blue) - but I wouldn't be notified on the English wiki, if I usually don't go much on the French wiki. So, I'll have to think about checking the 2 (or more) talk pages regularly :(
  2. There are several solutions: Zo's one and Craftjenn's one. The simplest is to use RC and that's what is presented here.
    • On the top right of the screen: Preferences, (1st tab where we arrive), part Signature :
    • "New signature": CraftJenn, Ranger of the Circle of the Wood of Almati ( [https://chat.ryzom.com/direct/Craftjenn on RC] )
    • check "Treat the signature as wikittext (no automatic link)".

The art of writing an article

A wiki is a collaborative work with many hands and everyone knows that there are as many ideas as homins. Also, it is advisable to write as much as possible according to the "Principle of least surprise", that is to say that the reader finds the same schemas from one page to the other despite the fact that it was written by different homins.

MediaWiki offers several tools and default behavior. For example, as soon as you have 4 titles, a summary is automatically generated above the second title of the page (the title of the page itself, level 1, being the first).

Schemas and templates : about navigation toolbars, templates... To update and translate from French.

OOC: Out of character

You know the minimum to get by. Of course you will have to search stuffs. This will look like the work of Surveys of Mission Raw Materials which will be more and more valuable. There is one last point you will not find elsewhere: "How to elegantly introduce OOC in roleplay (RP) articles?"

Dates and time

Please use the Atysian dates. More on Time and there's a tool to convert dates on https://ryzom.kervala.net/time.php?shard=atys

⇒ in notes

In the roleplay text, the Atysian date Holeth, Winderly 24, 1st AC 2603 [3]

The code is
'''Holeth, Winderly 24, 1st AC 2603''' <ref>OOC: 2019-04-15</ref> and will be displayed down page as

OOC: 2019-04-15

⇒ in the text

For a longer explanatory note, you can create an OOC paragraph at the end of the article that looks like this paragraph.

{{OOC|short comment|Some quite long text}}

will NOT give the colored section: it seems this Template don't exists



⇒ in a tabbed page

As in APageRPandOOC


Categorise your OOC pages

This category doesn't exists in the English wiki. Thanks to use for spoilers Category:Mysteries

Portals

Portals contain topics and often tabs. In general, the portal and the sub-pages and headings are locked at prime access to avoid accidental (even malicious) changes. The source of the portal then often has two parts, quite small since everything is outside the portal. Thus, if we take the matis portal, we see at the top, the tabs code and at the bottom the code of the rubrics.

Of course, we could have changed the order of the tabs. When correcting (or creating) tabs, care must be taken to copy the complete tab structure in each of them to remain visually consistent. And to correct the different pages designated by the tabs, it will go directly to the page indicated by the URL. The simplest is to click on the title indicated on the tab.

topics

More for reasons of elegance than of protection (for that it is enough to change the rights of writing), the headings are not editable from the edit link which accompanies each title.

This is a title whose content is editable by clicking on the associated link... [edit]

If you don't want to see the "[edit]" link, just add in the page "__NOEDITSECTION__".

Often, for the same reasons, we do not want to see tables of matter to embed themselves in the page: add "__NOTOC__".

But if you want to change the content of these pages, how can you do so since there is no link?

Here's my tip:

The pages that appear in the structures of a portal are of this type:

 <!-- ==============LIGHT ON ================ -->
 !{{ContentBox
  |title= {{3DText|group=tryker|3D=inset|text=General presentation}}<!-- default=Spotlight on}}-->
  |palette=tryker
  |image= Tryker emblem.png<!-- default=Zor emblem.png-->
  |content= {{:Tryker}}
<!--{{:Featured article/Tryker}}

To work on Featured article/Tryker, I copy somewhere in my personal page "{{Featured article/Tryker}}" then I change the braces in hooks and, as braces are for templates in mediaWiki, prefix with template, it should gives "[[Template:Featured article/Tryker]]" - this is the link I will use to change the Tryker page (and then the Tryker portal).

And after...

Above all, what to do then if you come across the case or a page exists with another title. For example, you wanted to write Corsair but The Corsairs already exists. Well, this has been planned in the MediaWiki: you can redirect a page to an other one: write in the page Corsaire (that you wanted to create)

#REDIRECT [[The Corsairs]]

You are now ready not only to write, but also to modify the existing one. And that's not always easy either. You can usually add the flourishes that have been taught above especially at least one category (the good), links, references ... They are often forgotten by the editors of passage. Making small corrections is always welcome but sometimes if the content seems to you wrong it is better to start discussing when possible with the author or in the article's discussion page. Otherwise, it may happen that the writing of the article is transformed in PvP.

For translation codes, and translating on wiki, see WikiTrad-EN.

Templates

Template is for repetitive stuff. For example, a navigation bar on several pages: create Template:My_Nav (with the links) and use with {{My_nav}} on pages (each time you change Template:My_Nav, all page who have code {{My_nav}} will use the last updated Template:My_Nav).

See for ex Category:Navigation_templates

If you create your own Templates, thanks to add the category [[Category:User Templates]]. To get an idea of some examples: Category:User Templates

Links

#pj-ryzom_wiki is the RC channel to talk about wikis

Help/Some official help links



Última versión 2023-08-30•
  1. Un Módulo de Interfaz Karavan es denominado computadora IRL (In Real Live o en la vida real)
  2. example of note
  3. OOC: 2019-04-15