Help:Guide de syntaxe de l'éditeur Wiki/fr

From the CreationKit Wiki
Revision as of 13:19, 23 October 2012 by imported>Plplecuyer (Created page with "C'est là que vous apprendrez à modifier un article dans le wiki! La syntaxe wiki n'est pas trop compliqué ou difficile, mais elle '''est''' unique, et c'est pourquoi nous a...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

C'est là que vous apprendrez à modifier un article dans le wiki! La syntaxe wiki n'est pas trop compliqué ou difficile, mais elle est unique, et c'est pourquoi nous avons consacré cet article pour l'enseigner, quoique brièvement. Pour plus d'informations, consultez la liste des liens à la page Aide. N'oubliez pas que la page d'aide est dans votre boîte de navigation en haut à gauche, elle est très utile.

C'est un guide assez long, utilisez la table des matières pour aller à la section qui vous intéresse, ou si vous êtes totalement nouveau et que vous voulez tout apprendre, lisez-le complètement.

Modification d'une page

Donc, vous voulez changer quelque chose dans un article du Wiki, hein? Eh bien, la première question est de savoir si vous devez ou non consulter notre Bienvenue sur le Wiki et Guide de style si vous ne les avez pas encore lu. Vous êtes invités à contribuer, et à bien contribuer. Avec ces deux guides, nous allons vous montrer comment.

Bon, il y a quelque chose dans un article qui a besoin d'une correction. C'est peut-être une faute de frappe, ou peut-être qu'une partie du formatage a foiré. Peut-être que vous aimeriez ajouter votre avis à une discussion. Dans tous ces cas, il y a deux endroits pour chercher à modifier la page.

Tout d'abord, il y a le bouton Modifier en haut de l'article. Il est assez difficile à rater, donc la plupart des gens savent qu'il est là. Il est idéal pour changer le paragraphe d'introduction d'une page, ou pour modifier plusieurs sections.

À côté il y a un bouton +. C'est pour ajouter une nouvelle section, qui formate automatiquement le "sujet" de la section comme rubrique "secondaire" (plus sur les rubriques ci-dessous). Cela peut être utile aussi, mais n'apparaît pas toujours sur une page. Si elle n'est pas là, vous pouvez créer une nouvelle section à l'aide de Modifier et des rubriques.

Enfin, il y a aussi un lien [modifier] à côté de chaque titre d'une section. Ceci est utile car elle vous montre seulement le texte de cet article pour l'édition, donc il y a moins de défilement et de recherche pour le texte que vous souhaitez modifier.

Créer une nouvelle page

Sans aucun doute la question la plus fréquemment posée sur le Wiki : Comment puis-je créer une nouvelle page?

La réponse commence par la recherche de la page. Assurez-vous que la page n'existe pas déjà, les pages redondantes causent de la confusion sur le Wiki ! Si votre recherche ne donne rien, notez que sur le haut de la page, il y a une ligne qui dit ceci :

Créer la page « votre page» sur ce Wiki.

La section rouge est un lien vers la page que vous voulez créer - cliquez sur le lien et commencez à éditer!

Créer une nouvelle catégorie

Les catégories sont des pages spéciales sur le Wiki qui ont des liens vers d'autres pages dans une liste située à la fin. Ces pages sont automatiquement ajoutées à la liste en mettant un code spécial à la fin de chaque page dans la catégorie. Il est ainsi plus facile d'ajouter de nouvelles pages à la catégorie.

Une nouvelle catégorie est créée en ajoutant "Category:" au début du nom de l'article. Tous les articles qui commencent par "Category:" seront des catégories, attention, les catégories sont des tracasseries superflues ici dans le Wiki. Ne faire une nouvelle catégorie que lorsque cela est justifié.

Renommer une page

Au sommet d'un article vous trouverez le bouton Renommer. Cela vous demandera un nouveau nom pour l'article, et donne l'équivalent d'une barre de résumé afin d'en expliquer la raison. Notez que vous ne pouvez pas renommer les catégories, et vous ne pouvez pas renommer un article dans une catégorie. Dans ces cas, vous aurez simplement à modifier la page, la copier entièrement, et la coller dans une catégorie nouvellement créée ou une page nouvellement créée, selon le choix que vous aurez fait. Assurez-vous de mettre en place les redirections appropriées, les liens fixes, et surtout, laissez une note complète sur l'historique des modifications de la page originale.

Redirections

Renommer une page crée automatiquement ce qu'on appelle une redirection, tous les liens qui vont à l'ancienne page seront transmis à la nouvelle. Cependant, le wiki n'enverra pas des gens à la page suivante, une redirection vers une autre redirection ne fonctionnera pas. Par conséquent, il vous est conseillé de corriger les liens que vous pourrez trouver sur la nouvelle page après l'avoir renommée, et mettre à jour les redirections de la page.

Vous pouvez créer votre propre redirection sans renommer une page avec le code suivant:

#REDIRECT [[Nom de l'article correct]]

C'est très bien pour les pages qui ont des noms différents, comme une abréviation, pour s'assurer que les gens vont au bon endroit. Notez que le lien après le #REDIRECT est un lien interne, et il doit être codé de la même façon (spécifiquement, les catégories exigent l'utilisation du deux-point en tête).

Il serait également judicieux d'utiliser "Pages liées" de votre boîte à outils pour trouver quel sont les liens de l'article, et modifier les liens internes pour pointer vers la catégorie.

Effacer des pages

Pour des raisons évidentes, vous ne pouvez pas supprimer complètement un article en tant qu'utilisateur wiki. Toutefois, si vous voulez vous débarrasser d'une page entière (par exemple, celle que vous avez créée accidentellement), vous pouvez la déplacer dans la catégorie des "articles pour suppression" en ajoutant le lien de la catégorie suivante à l'article: {{afd}} où il est rangé en toute sécurité, à l'écart, et peut éventuellement être supprimé par les administrateurs. Également supprimer toutes les autres catégories de la page, puisque l'article ne devrait plus figurer sur ces catégories.

Links

Wikis are all about links. They're what make Wikis great. A good article needs links.

There are two types of links - internal, and external. Internal links point to another article on this Wiki; external links point to another website. Each has its own formatting.

Internal

To write an internal link, use double brackets, like so:

[[Article Name]]

For, example, [[Help: Wiki Editing Style Guide/fr]] creates this: Help: Wiki Editing Style Guide/fr. Notice that even though the URL of the article contains underscores, your link doesn't have to (it will work with underscores, but not look as nice). By the same token, special characters do not need to use their

To make a link use a text other than the article's name, use the vertical bar symbol, |. For example, [[Help: Wiki Editing Style Guide/fr|Wiki Editing Style Guide]] makes this: Wiki Editing Style Guide.

If you want to link to a specific section of an article, use the pound sign, #. [[Help: Wiki Editing Syntax Guide/fr#Internal|Internal Links]] makes this link: Internal Links. Note that the part after the pound sign is identical to the Header of the section you are linking to.

Categories are special pages on the Wiki, and they get a somewhat special formatting - you put a colon, :, before their name, like so:

[[:Category: Category's Name]]

For example, [[:Category: Getting Started/fr|Getting Started]] gives us this link: Getting Started. The vertical bar and the pound symbol both work for categories as well as regular articles.

If your link appears in all caps and red, like this, that means you are pointing to a page that does not exist. This can be a useful way to create a page, since you can click on the link and create the page, and it's also useful for seeing that you've made a typo in a link.

This is also why your username will appear red and in all caps when you first sign up for the Wiki. Write something in your User Page to fix it. Adding yourself to User Lists is a great way to start, and solve the weird names.

External

When possible, it is preferable to link to an article in the Wiki rather than link to another website, but there are certainly numerous situations where an external link is applicable. They use single brackets, like so:

[URL text]

Note that there is no vertical bar or any other symbol between the URL and the text of the link, just a space. For example, linking to the Official Elder Scrolls Site would be done like this: [http://www.elderscrolls.com/ The Elder Scrolls], The Elder Scrolls.

Categorizing

Categories are another integral part of Wikis, and after creating a new page, "how do I add an article to a category" is the most commonly asked question there is. The answer is to add the following code to the article:

[[Category: Getting Started/fr]]

This will add the article to the Getting Started category. Note that while it will work no matter where it is on a page, it is best to put it on the bottom, where the category links actually appear on a page, or else it will be quite difficult for the next person to find. Also, remember, this is the same formatting used for an internal (non-category) link, you need special formatting to actually link to a category rather than add the article to it.

Also, the vertical bar may be used to with the category tag, but it has quite a different effect than the vertical bar does in normal internal links - it does not change the text of the link to the category, or even the name of the article as it appears in the category. What it does is change the alphabetization of the article in the category's list. For example:

[[Category: Getting Started|Aardvark]]

will cause the article to be listed under A in the category's list, as if the title of the article was Aardvark, even though the actual title of the article will appear in the list. Be aware that using capitals can confuse the Wiki - capitalize only the first letter of the first word of the new title, even if the article has more capitals than that.

Headings

Headings are larger, bolder, and often underlined text that denotes the beginning of a section. They use equal signs, =, around the heading text. There is a hierarchy of headings, as follows:

  • = Primary Heading - Big, bold, underlined - often unused =
  • == Secondary Heading - not as big, bold, and underlined - usually the biggest heading used in an article ==
  • === Tertiary Heading - big and bold, but not underlined - sub-sections of a secondary heading ===
  • ==== Minor Heading - bolded, but regular size and no underline - rarely used, a sub-section of a sub-section ====

Headings are strongly encouraged when writing an article. They automatically create a Table of Contents for a page, and they make the layout very easy to follow. They can also be linked to directly by other pages.

Horizontal Rule

Wikis can also create a line across a page using four dashes, ----. In general, it's better to create a new section with its own heading, for the sake of the Table of Contents and links, but sometimes it is preferable to simply use the line to divide sections of the page.

Example:


And some more text afterwards to show what it's like.

Table of Contents

A Table of Contents is automatically created when you use 4 or more headings. If the page doesn't need one, place __NOTOC__ at the top of the page. To force one, use __TOC__ - also note that it appears where you place this tag, so you can change where the Table of Contents appears on the page. You can also use {{TOCright}} to place the table on the right side of the page, which can be desirable if the page has a lot of headings and the table takes up a lot of space.

Paragraphs

A new paragraph is started each time you skip a line. A single Return will not affect the article's text - you need to actually skip a line in between paragraphs.

To force a Return or Line Break without skipping a line, use the HTML code, <br />.

Indentation

Paragraphs are generally indented in Talk pages, for clarity's sake. There may also be cases where indentation would be useful in an article. To do so, start the first line of a paragraph with a colon, :, like so:

:This is an indented paragraph. This is just extra text to show what happens when the paragraph is longer than one line. We have enough text now.

This is an indented paragraph. This is just extra text to show what happens when the paragraph is longer than one line. We have enough text now.

The entire paragraph will be indented, and multiple colons may be used to indent further.

Text Formatting

Text formatting in Wiki uses apostrophes or single quotes, '. These are the possibilities:

  • ''italics'' - italics
  • '''bold''' - bold
  • '''''bold-italics''''' - bold-italics

Other types of formatting can be done using standard HTML tags:

  • <s>strikethrough</s> - strikethrough
  • <u>underlined</u> - underlined

Code Boxes

(this section can be confusing if you don't look at the plaintext version - click the [edit] link to the left of the header to see it)

Script code, and other types of specialized text, require monospace fonts and no margins. There are two ways to format a section of text as code. First, start each line with a space

ScriptName ShowOffMyTextBox

Begin GameMode

  MessageBox, "Look at me!"

End

First, note that even the blank lines start with a space - if you don't, the Wiki will assume your box is done, and then start another box with the next line. See this example, which is the same as the above except that the blank lines don't have spaces:

ScriptName ShowOffMyTextBox
Begin GameMode
  MessageBox, "Look at me!"
End

Second, be aware that words will not wrap inside this box - they will continue off to the right, off the paper color of this Wiki, into the black borders, right off the side of the page. This makes them unreadable and can cause the page to stretch. Avoid this if at all possible.

The other way to create a code box is to use the <pre> tag. This is the same script as above, but there are no spaces starting any of the lines - the code box will not end until you use the </pre> tag:

ScriptName ShowOffMyTextBox

Begin GameMode

  MessageBox, "Look at me!"

End

To be consistent, tabs for the indentation of script lines are typically typed as two spaces. This is in addition to the space you used to create the code box if you use that format.

Lists

There are two types of Lists - bulleted and numbered.

Starting a new paragraph, that is, skipping a line, ends your list. In the case of bulleted lists, you can't tell, but in the case of numbered lists, it restarts your numbering and messes things up.

Lists can also be mixed.

Bulleted

A bulleted list is created using asterisks, *. Each list item starts with an asterisk. Multiple asterisks cause indented bullets (sub-points).

*Point 1
**Sub-Point A
**Sub-Point B
***Sub-Sub-Point Double-Gamma
***Sub-Sub-Point Double-Epsilon
**Sub-Point C
*Point 2

  • Point 1
    • Sub-Point A
    • Sub-Point B
      • Sub-Sub-Point Double-Gamma
      • Sub-Sub-Point Double-Epsilon
    • Sub-Point C
  • Point 2

Numbered

A numbered list is created using pound symbols, #. Each list item starts with a pound symbol. Multiple pound symbols cause indented points (sub-points).

#Point 1
##Sub-Point A
##Sub-Point B
###Sub-Sub-Point Double-Gamma
###Sub-Sub-Point Double-Epsilon
##Sub-Point C
#Point 2

  1. Point 1
    1. Sub-Point A
    2. Sub-Point B
      1. Sub-Sub-Point Double-Gamma
      2. Sub-Sub-Point Double-Epsilon
    3. Sub-Point C
  2. Point 2

Mixed

Using a combination of asterisks and pound signs is also possible.

#Point 1
#*Sub-Point A
#*Sub-Point B
#*#Sub-Sub-Point Double-Gamma
#*#Sub-Sub-Point Double-Epsilon
#*Sub-Point C
#Point 2

  1. Point 1
    • Sub-Point A
    • Sub-Point B
      1. Sub-Sub-Point Double-Gamma
      2. Sub-Sub-Point Double-Epsilon
    • Sub-Point C
  2. Point 2

Interrupted Lists

With the wiki syntax you can only make a list without interruptions; the list items can't be interrupted by anything. For example,

  1. Point 1
code
  1. Point 2


To make a list with interruptions between the list items you need to use HTML.

<ol>
<li>Point 1</li>
<li>Point 2<br />
More about point 2</li>
<li>Point 3</li>
#Sub-Point 1
#Sub-Point 2
<li>Point 4</li>
Point 4.5?
<li>Point 5</li>
</ol>

  1. Point 1
  2. Point 2
    More about point 2
  3. Point 3
    1. Sub-Point 1
    2. Sub-Point 2
  4. Point 4
  5. Point 4.5?
  6. Point 5

Everything between the ordered list tags <ol> and </ol> will act like one list and every list item <li> will have be numbered correctly. As you can see there's no problem starting a list with the wiki syntax inside the HTML list. You can make an unordered list with the <ul> and </ul> tags instead of <ol> and </ol>.

Signing a Page

Signing a page is very simple, and very important to discussions. Simply type four tildes, ~~~~ to insert your name, as a link to your user page, plus the date and time. Three tildes will insert just your name (as a link), but we would prefer you use four so we know when you posted.

Reverting

If you feel a change to a page was unwarranted or malicious (e.g. spamming or vandalism), you can easily revert to an earlier version of the page. Either in the difference view (via recent changes) or in the history panel, click on the date of the revision of the article you want to revert to. Then edit that page. You will get a warning that you are not editing the most current version. Ignore it and save, noting "revert" on the summary line. Again, it is in the spirit of the Wiki to edit other peoples contributions and to have your own edited, so use this option sensibly.

Moving

If a page has been maliciously moved you can return it to its original location with the Move tab (at the very top of the page). Just click on it and follow the (short!) instructions on that page. Please make sure to move the page before editing the original page.

Conclusion

Well, that's the end of this! The Wikipedia help page has many more useful hints on the Wiki syntax. If you have any questions, please feel free to ask in the Talk page! And remember to use indentation and to sign your post!



Langues : English  • français • українська