Revision as of 15:38, 18 September 2014

Übersetzung benötigt, bitte

Please, check

Traducción necesitada, por favor

Cette version est améliorée par rapport à la française

Перевод нужно, пожалуйста

The EN How2 is the page of how to do something in the Ryzom Forge Wiki.

Contributing to the wiki

If you're not familiar with wikis and, more specifically with Mediawiki, editing and creating pages may seem complex. Good news: we use a wiki engine that is well documented in every language.

As a user, the most useful information is available here: http://www.mediawiki.org/wiki/User_hub and more precisely here: Mediawiki FAQ.

MediaWiki is used by Wikipedia, which has lots of very good tutorials. Getting the Wikipedia introduction page is a great way to understand what a wiki is and how to begin.

To write the Wiki markup is very complete, and the Cheat Sheet help you to quickly find the most rules used.

Finally, you may also read the [[Introduction to wiki] which is a summary adapted to our Ryzom wiki. In addition, there are several "[category: template | Templates]" to initialize pages, especially including multilingual mode, as you can see in the next paragraphs.

All features available on MediaWiki / Wikipedia is not available on this wiki: some need to be added by an administrator. If you are missing something, contact one and ask him nicely. You can also use the page Wiki_on_Work (reaction time variable depending on the time). Be free to write in it in your language: it is easier for us to have only one page.

Page Not Found (in any language)

Documentation page

1. If there is no page with the title you have chosen, click the title highlighted in red in the message that is at the top of the page «Search results»: "Create the page "Your_title" on this wiki!". This action may open a new empty page with your Your_title as name for it.
2. Copy in your new page this command adapted to your language. For instance, for English:

   {{subst:EN Page}}

3. Save immediately this page with this unique line.
4. Reopen this page you just have saved: it will contain the minimum skeleton to continue your work.

Category

When a category appears in red in the bottom of a page, you can document that category explaining what is in it and with what associated rules if necessary. Remember that the text of the Category is not a documentation page itself.

There are two kinds of documentation of categories, and so two kinds of treatment:

• A short description on just about one line:

1. • Copy this command in your new page:

     {{subst:CategoryShortDesc}}

   • Save this page immediately with that one line.
   • Reopen this saved page: it will contain the minimum skeleton to continue your work.

• The description is long, over 5 lines, may be because you add rules:

1. • Copy this command in your new page:

     {{CategoryTab}}

   • Save this page immediately with that one line.
   • Click on one of the tabs to open your language and create a new page. Follow the instructions to initialize a non-existent translation (see below). Please, do not change the name of pages documenting the categories given by that templates.

Template documentation

The description of template is usually longer and complex than a category .

• Start by adding the following lines at the beginning or end of the template replacing '"foo"' through the appropriate categories:

 <noinclude> {{{{}} FULLPAGENAME / Documentation}}
[[Category: foo]] </ noinclude> </ nowiki>
</ Pre>
* Next:
* # In the blank page of documentation of a "Template" ('Template: <nom_du_template_à_documenter> / documentation'), copy this command: <pre> {{subst: Template documentation}} </ pre>
# * Save this page immediately with that one line.
* # Reopen this page search: it will contain the "Templates" for continuing the work of documentation. Indeed there is a ready template for each language. For the French it was: <pre> {{subst: FR Documentation Template}} </ pre>
# * Save this page again to "insert" the contents of <nowiki> {{</ nowiki> [[Template: Documentation Template EN | FR Template Documentation]]}} instead that matches it. This template preformatted page Documentation Templates in French.

Autant le description d'une catégorie est en général courte, autant un "Template" peut être plus complexe.
*Il faut commencer par ajouter les lignes suivantes en début ou en fin du template en remplaçant '' "foo" '' par les catégories adéquates:
<pre>
<nowiki><noinclude>{{{{FULLPAGENAME}}/Documentation}}
[[Category:foo]]</noinclude>

• Ensuite:
  1. Dans la page vierge de documentation d'un "Template" (Template:<nom_du_template_à_documenter>/documentation), copiez cette commande:

     {{subst:Template Documentation}}

  2. Sauvez immédiatement cette page avec cette unique ligne.
  3. Rouvrez cette page sauvegardée: elle contiendra les "Templates" nécessaires à la poursuite du travail de documentation. En effet il y a un Template prêt par langue. Pour le français on a:

     {{subst:Template FR Documentation}}

  4. Sauvez à nouveau cette page pour "insérer" le contenu de {{Template FR Documentation}} à la place qui lui correspond. Ce Template préformate une page de documentation des Templates en français.

Traduction inexistante

Lorsqu'une page existe déjà dans une des 5 langues de Ryzom Forge, il reste à la traduire dans les autres.

Page documentaire

Les pages documentaire ont en haut de la page 5 onglets linguistiques créé par le {{TabLang}} .

Par défaut, tant que la page n'a pas été traduite, il y a en haut de la page originale quelque chose comme:

{{TabLang|FR|DE|EN|ES|{{FULLPAGENAME}}|RU}} .

Les indications " ...|DE|EN|ES|...|RU " montrent les traductions manquantes, et en cliquant sur l'onglet linguistique, on est conduit vers une page comme FR. Suivez les consignes de cette page pour créer une nouvelle traduction.

Lorsque toute les page sont traduites on devrait trouver quelque chose comme:

{{TabLang|FR|Mein Titel|My title|Mi título|Mon titre|Мое название}}.

La seule règle pour choisir un titre de page documentaire est de ne pas prendre par hasard le même titre qu'une page dans une autre langue. Cette règle est moins souple pour les catégorie et le modèles (templates) à cause des automatismes qui y sont associés. (cf:WikiRF)

Catégorie

Les catégories sont uniques: elles rassemblent tous les document dans toutes les langues à l’exception des catégories de langues proprement dites: category:DE, category:EN, category:ES, category:FR et category:RU.

Leur nom doit donc être le plus neutre possible, c'est-à-dire souvent en basic english.

Les documents descriptifs des catégories sont toujours formatés de la même manière afin d'assurer le fonctionnement des automates: XX_YYY, où XX sont les deux lettres de la langues du texte et YYY le nom exact de la catégorie.

Template documentation

Plus que pour les catégorie il vaut mieux éviter de créer des modèles (templates) différents par langues. Seule la documentation mérite d'être traduite. par contre, la documentation du template est souvent "embarquée" dans le template proprement dit, et surtout cette documentation ne doit pas modifier le comportement du modèle. Il va de soi que l'intérieur des modèles communs au 5 langues est écrit de manière la plus "neutre" possible.

Ouvrez la page documentaire du template:

1. Elle contiend en rouge les documentations manquantes {{Template:Template XX Documentation}} où XX sont les deux lettres de la langues du texte traduit.
   1. Commencez par traduire la documentation dans votre langue de compétence. Vous n'aurez qu'un fois à le faire.
   2. Sauvez à nouveau cette page pour "insérer" le contenu de {{Template:Template XX Documentation}}. Ce Template préformate un chapitre de la page de documentation des Templates en XX. Passez à l'étape suivante:
2. Votre chapitre est préformaté: compléter/éditer les paragraphes associés.

FAQ

Comment empêcher les utilisateur d'intervenir sur une page que je rédige et qui n'est pas prête?

Il faut mettre en haut de la page la bannière le modèle WIP

{{WIP}}

Comment empêcher que les images débordent dans les paragraphes suivants?

Une image très longue

La manière la plus propre consiste à encadrer l'image à l'intérieur d'un paragraphe comme ici. Pour cela il suffit de créer un conteneur avec les balises <div>, mais il faut malgré tout parfois jongler pour obtenir quelque chose d'élégant. Un wiki n'est pas un SPIP par exemple et nous ne sommes pas des experts de PAO ;). En effet, normalement une image de 200px est une bonne mesure moyenne. Parfois on peut agrandir ce chiffre, mais dans ce cas, le mélange texte et image ne se justifie plus, et l'image peut occuper toute a largeur de la page. Ou, ici, l'image est beaucoup trop haute, il faut donc réduire sa taille globale. Il n'est pas recommandable de descendre en dessous de 32px.

<div style="overflow: hidden">
[[File:Votre image|200px|thumb|left|titre de l'image]]
Votre texte ici...
</div>

Je voudrait que mon texte soit traduit

Il faut mettre en haut de la page la bannière le modèle toTrad

{{toTrad| Une langue précise si nécessaire |Un commentaire si nécessaire}}

Par défaut {{toTrad}} indique que l'article est à traduire et est ajouté à la catégorie ToTrad:

• Il est possible de limiter la traduction à une seule langue. Par exemple {{toTrad|RU}}.
• Il est possible de changer le texte par défaut. Par exemple {{toTrad| |Veuillez corriger le paragraphe 3}}.

Mon profil utilisateur

Il peut être utile aux participant de Ryzom de savoir quelles sont vos compétences linguistiques, techniques... Vous pouvez utilier pour cela deux infobox:

• Template:babylon: (déformation de Babel) cette petit boite donne vos compétence linguistique.
• Template:QuiSuisJe: Cette boite donne vos compétences technique et votre activité dans le jeu.

Comment ajouter une info importante?

Vous pouvez utiliser une boite un peu spéciale pour alerter: Template:Banner

Nonexistent translation

When a page already exists in one of five languages ​​Ryzom Forge, it remains to translate it into the other. Page documentary ==== ==== The document pages have top 5 language tabs created by the '<nowiki> {{</ nowiki> TabLang}}' .

By default, until the page has not been translated, there at the top of the original page something like: '<Nowiki> {{</ nowiki> TabLang | FR | DE | EN | ES |​​ <nowiki> {{</ nowiki>}} FULLPAGENAME | UK}}' .

Indications "'... | DE | EN | ES |​​ ... | RU'" show the missing translations, and clicking on the language tab, we are led to a page like ' FR '. Follow the instructions on this page to create a new translation.

When all the pages are translated should find something like: <nowiki> {{</ nowiki> TabLang | FR | Mein Titel | My title | Mi título | My title | Мое название}} </ big>.

The only rule to choose a page title documentary is not to take a chance the same way as a page in another language. This rule is less flexible for the category and models (templates) because of automation associated. (See: 'WikiRF')

Category ==== ==== The categories are unique: they gather 'all' the documents in all languages ​​except for categories of languages ​​themselves: category: DE, category: EN, [ [: category: ES]], category: FR and category: RU.

Their name should be as neutral as possible, that is to say often basic English '.

The documents of the categories are always formatted in the same manner to ensure the operation of PLCs: XX_YYY, where XX is the two-letter language text and YYY the name exact 'category.

 

WIP

in Arbeit -
work in progress -
trabajo en curso -
travaux en cours -
незавершенное

</ pre>

How to prevent images overflow in the following paragraphs?

  
A very long image
The way most 'clean' is to frame the image within a paragraph like this. You just create a container with <nowiki> << / nowiki> div>, but still sometimes juggle it takes to get something elegant. A wiki is not a SPIP by example and we are not experts in desktop publishing;).
Indeed, normally an image of 200px is a good average measure. Sometimes you can expand that number, but in this case, the text and picture mixing is no longer justified, and the image can occupy the entire width of a page. Or, here, the picture is far too high, so you have to reduce its overall size. It is not advisable to go below 32px.
<Pre>


File:Your picture  
image title
Your text here ...
</ Div>
</ Pre>
</ Div>

I would like my text translated
There must be top banner model  toTrad

<Pre> 

Leave a comment if necessary


</ pre>

Default <nowiki>}} {{toTrad </ nowiki> indicates that the article is translated and is added to the category  ToTrad

 It is possible to limit the translation to a single language. Eg <nowiki> 

Translation requested, please.


</ nowiki>.

 You can change the default text. Eg <nowiki> 

Please correct paragraph 3