Version actuelle en date du 4 février 2007 à 12:36

Cette page est une ébauche. Vous pouvez la continuer si vous le désirez.

     Cette page est sous construction, rassemblant toute l’aide nécessaire en ce qui concerne la syntaxe wiki, des conseils touchant plus proprement ce wiki et tout ce qui est de manière génerale jugé utile à être apporté à la connaissance des utilisateurs de Planète Sistearth…

     Si quelqu’un d’extérieur passait par là, je l’invite fortement à venir squatter et apporter ses lumières ! À propos, puisque cette page est en ébauche et que le tout premier créateur (Caranud) est un vieux fou facétieux, cette page aura pour particularité d’avoir un patronnage évolutif, c’est-à dire qu’elle porte le nom et l’aspect que lui donne la dernière personne qui la modifie (si elle le souhaite).
En attendant, et jusqu’à ce que quelqu’un apporte son grain de sable, je déclenche : ce lieu se nomme «L’atelier du Docteur (fou) ès POGS Caranud».

Note : pour faciliter la compréhension des codes à saisir, ceux-ci seront mis en rouge, les variables en violet, les textes en gris et accompagnés d’exemples.

I Mise en forme des caractères

Codes de mise en forme

• Mettre en italique ou en gras :

''texte'' = texte   |   '''texte''' = texte

• Souligner ou barrer :

<u>texte</u> = texte   |   <strike>texte</strike> = texte

• Mettre en couleur :

<font color="#CC6600">texte</font> = texte

• Mettre en exposant ou en indice :

<sup>texte</sup> = texte   |   <sub>texte</sub> = texte

• Changer la taille :

<small>texte</small> = texte   |   <big>texte</big> = texte   |   <font size="10px">texte</font> = texte

• Centrer :

<center>texte</center>

Cumul de mise en forme

Les codes de couleurs ou de taille sont ceux du code HTML, ils ne sont donc que des exemples parmi d’autres…

Les mises en forme peuvent se cumuler : un terme peut ainsi être à la fois en italique, en gras, souligné, barré et en couleur.

'''''<u><strike><font color="#66FFFF">texte</font></strike></u>''''' = texte

II Mise en page

A/ Uniformisation

Modèles

     Dans un souci de clarté, afin que la mise en page des articles présente une certaine uniformité, des modèles ont été mis en place. Il s'agit de raccourcis préenregistrés sur le wiki qui évitent de rechercher à chaque fois comment doivent être, par exemples, mis en page les renvois vers d'autres articles.

{{correction}} =
==Demande de correction==
L'auteur de cet article demande l'avis des lecteurs sur la mise en page, l'orthographe, la syntaxe et la grammaire de son texte. 
Une fois que vous avez entièrement corrigé le texte, merci de retirer cet avertissement.
Ne commencez pas une correction si vous n'avez pas les connaissances nécéssaires ou si vous n'êtes pas sûr de vous.
----

{{finir}} =
Cette page est une ébauche. Vous pouvez la continuer si vous le désirez. 

{{temp}} =
----
===Attention===
Cette page est encore à l'état d'ébauche, et son auteur original
demande à ce qu'elle ne soit pas modifiée pour le moment. 

Lorsque cette page sera éditable, l'auteur retirera cet avertissement.
----

{{voiraussi}}=
==Voir aussi==

B/ Hiérarchisation des données

Sectionner les articles

     La syntaxe wiki dispose par défaut d’une possibilité de créer des chapitres et sections en tout genre. Le niveau va de 1 (chapitre) à 6 (paragraphe), avec les codes suivants :

=Nouveau chapitre=
==Nouvelle section==
===Nouvelle sous-section===
====Nouveau titre====
=====Nouveau sous-titre=====
======Nouveau paragraphe======

     Il faut cependant remarquer que si, dans un premier temps, ces commandes s’avèrent extrêmement pratique (mise en forme et hiérarchisation dans la table des matières automatiques), la mise en forme des sections s’avère peu modifiable et peu satisfaisante sur une grande page. Elle reste néanmoins d’une aide appréciable sur les pages simples.

Table des matières

     Une table des matières est créée automatiquement si l'article comporte plus de 3 titres ou sous-titres (au moins 4).
Pour supprimer le sommaire automatique, il suffit de mettre quelque part __NOTOC__. Pour modifier l'emplacement de la table des matières, placer __NOTOC__ en haut de la page, puis insérer __TOC__ à l’endroit où vous désirez voir apparaître la table.

Supprimer l’édition des sous-titre

     La balise __NOEDITSECTION__ permet de supprimer les boutons "Éditer" qui apparaissent à chaque sous-titre à partir du niveau 2.

C/ Listes

Listes à puces

     Vous pouvez créer une liste avec la balise * en début de ligne. Vous pouvez créer des sous-listes en rajoutant une balise, chaque balise représentant un niveau de la même manière que pour les chapitres.

* Liste de niveau 1
** Liste de niveau 2
****** Liste de niveau 6
** Liste de niveau 2
* Liste de niveau 1

Listes numérotées

     En remplaçant la balise * en début de ligne par la balise #, les listes observeront un ordre numérique.

D/ Paragraphes

Aller à la ligne

     Un simple retour à la ligne n'a aucun effet, vous devez pour aller à la ligne utiliser la balise <br> en fin de phrase. Une ligne vide entre deux phrases permet en revanche de séparer les paragraphes.

Forcer des espaces

     La syntaxe wiki ne vous permet pas, par défaut, de former des paragraphes : il vous est impossible de mettre des espaces en début de phrase. Vous pouvez cependant ruser et insérer des caractères blancs avec la balise &NBSP; (en minuscules).

Changer le niveau des paragraphes

     Vous pouvez varier la position d’un paragraphe entier en rajoutant la balise : en tout début de phrase, le niveau augmentant suivant le nombre de balises.

Rajouter une ligne séparatrice

     La balise ---- en début de ligne génère une ligne sépatrice.

E/ Mise en forme particulière

Encadrer le texte

     Ajouter un espace en début de phrase permet de placer le texte dans un cadre qui supprimera les sauts de ligne automatiques. C’est très utile pour des exemples, mais n’en abusez pas : la police n’étant plus proportionnelle à la taille de la page, le texte complet peut déborder du cadre…

Autres codes

• Changer la police du texte

<tt>texte</tt> = texte

• Enlever l’interprétation de code :

<nowiki><u>texte</u></nowiki> = <u>texte</u>

• Ajouter un commentaire :

Il est possible d'ajouter des commentaires dans la page, qui n'apparaîtront pas dans le rendu de la page, mais seulement en mode édition.

<!-- Commentaire -->

• Ajouter une signature :

Vous pouvez ajouter une signature composée de votre pseudonyme et/ou de la date avec les codes suivants :

~~~ = le pseudonyme
~~~~ = le pseudonyme et la date
~~~~~ = la date

III Interaction des pages

A/ Adresses internet

Liens internes

Vous avez la possibilité de mettre l’adresse en lien direct ou bien en faire un lien redirigé avec les code suivants :

[[Page_interne]] = Page_interne   |   [[Page_interne|titre]] = titre

Liens externes

Vous pouvez simplement mettre l’adresse ou bien lui donner un titre personnalisé en laissant un espace entre le lien et l’étiquette :

http://www.lien.com = http://www.lien.com   |   [http://www.lien.com titre] = titre

Remarques sur la présentation des adresses.

     S'il y a un double point dans le nom de la page, le texte à gauche du double-point et le double point lui-même sont enlevés.

[[Aide:Aide|]] = Aide.

     Si le titre de l'article est contenu dans les termes du lien, les lettres supplémentaires peuvent être accolées après le lien.

[[Sistearth]]ien = Sistearthien.

B/ Ancrage

     Une ancre est un endroit d'une page auquel il est possible de se référer directement dans un lien : ainsi, le lien pointe directement sur la bonne portion de la page. Les en-têtes de sections sont automatiquement des ancres. Pour créer une ancre, il faut insérer le code suivant :

<span id="ancre">texte</span> = texte

L'ancre possède alors un "nom" qui permet de l'identifier et de faire un lien vers elle. Sur la page elle-même, il suffit de créer un lien comme ceci :

[[#ancre|texte]] = texte

Pour faire un lien vers une ancre sur une autre page, il faut écrire le nom de la page suivi du code de l’ancre.

[http://wiki.sistearth.com/index.php?title=Aide#ancre texte] = texte

L’ancrage ne fonctionne pas sur les pages spéciales ou pour les redirections.

D/ Redirections

     Une redirection sert à utiliser une page (la page de redirection) pour créer un lien renvoyant automatiquement vers une autre page (la page cible). Elle se fait automatiquement en cas de renommage et est utilisable en mettant ce texte dans la première ligne d’une page :

#REDIRECT [[page_interne]]

     Le texte suivant sur la même ligne sera affiché lorsque l'on visualise la page de redirection elle-même, et peut servir à expliquer la raison de la redirection, il peut inclure une catégorie.
Les lignes supplémentaires sont automatiquement enlevées à la sauvegarde (mais pas pendant la prévisualisation). La redirection ne marchera pas en revanche s'il y a quelque chose sur la page avant le code de redirection.

E/ Catégories

IV Fichiers

Il n'est possible d'utiliser que des fichiers qui ont été téléchargées vers un serveur, qu’il s’agisse de celui du wiki ou un lien externe.

Notez que, pour MediaWiki, "image" désigne n'importe quel fichier importé sur le serveur (les images aux formats PNG, GIF, JPG/JPEG ou les sons au format OGG). Seule la procédure d'insertion dans une page est différente entre une image et un autre fichier.

A/ Insérer une image

Utiliser une image externe

     La syntaxe pour inclure une image externe est simplement d'écrire l'URL de l'image. L'image est alors affichée dans sa taille normale.

http://www.sistearth.com/img/logo.jpg = http://www.sistearth.com/img/logo.jpg

Télécharger une image

     Il est possible de télécharger des images sur le serveur grâce à la page Special:Upload, puis de les insérer dans les pages de différentes manières. L'image peut alors être trouvée sur la page [[Image:Nom]] où "Nom" est le nom sélectionné lors du téléchargement.

Insérer une image téléchargée sur le serveur

Ainsi qu’on l’a vu, il suffit de rentrer le nom de l’image entre crochets pour l’insérer sur une page. Seul le nom de l'image est obligatoire, les options, facultatives, servent à contrôler la position, la légende, la taille et le cadre de l'image.

[[Image:image.JPG|option1|option2|…|Légende]]

Ajouter des options

• Ajouter une légende :

     La légende peut contenir du code wiki, des liens, etc. Elle se trouve après la dernière barre verticale dans le lien. L'aspect de la légende peut varier : avec un cadre ou une vignette, la légende si elle existe apparaît sous l'image ; sans cadre, la légende apparaît dans une info-bulle lorsque la souris passe sur l'image.

• Changer la position :

     Par défaut, une image est placée dans la suite du texte, ou à droite s'il s'agit d'une vignette. Il est possible de contrôler la position avec les options left, right, center ou none. Ces options contrôlent aussi l'adaptation du texte autour de l'image.

• L'option left place l'image à gauche. Le texte qui suit est flottant à droite de l'image. Si une seconde image est placée immédiatement après, elle se trouve juste à droite de la première. S'il y a du texte entre les deux images, alors la deuxième image est en bas à droite de la première, sous le texte.
• L'option right place l'image à droite. Le texte qui suit flotte à sa gauche. Par contre, si une autre image suit, elle est placée à droite à nouveau, sous la première.
• Avec l'option center, l'image est centrée et le texte recommence en-dessous de l'image
• Avec l'option none, l'image se trouve à gauche, mais le texte commence en-dessous de l'image

• Changer la taille :

     Sans précision, l'image s'affichera en pleine taille. Il est toutefois possible de préciser la taille affichée en pixels.

[[Image:Sorcier.png|30px]] = 

• Ajouter une vignette :

Pour obtenir une vignette, ajouter l'option thumb. Si aucune taille n'est précisée, la taille sera celle choisie par l'utilisateur dans ses préférences. Il est conseillé de ne pas imposer de taille pour laisser les choix des utilisateurs primer.

• Ajouter un cadre :

L'option frame permet d'ajouter un cadre à l'image. Dans ce cas la légende s'affiche en-dessous de l'image. Le cadre est automatiquement ajouté par l'option "thumb".

• Empêcher le texte de flotter :

Pour que le texte occupe de nouveau toute la largeur après une image, il faut insérer le code <br style="clear:both;" />. Ceci empêche le texte qui suit de flotter.

Superposer du texte et une image

     Il est possible de superposer du texte, des liens et des images à une image. Voir cet article.

B/ Insérer un son

À compléter…

VI Tableaux

Note : pour une meilleure compréhension, les codes déjà expliqués et réutilisés ne sont pas remis en couleur, seuls les codes en cours d’explication sont mis en évidence.

A/ Le cadre général

Syntaxe du tableau

Un tableau commence toujours par l'accolade ouvrante {, suivie d'un trait vertical |. À l’inverse, il se termine par un trait vertical | et il est suivi du deuxième caractère qui est l'accodade fermante }.

{|
tableau
|}

Créer une ligne de cellules

Pour créer une ligne, il faut insérer un trait vertical |. Lorsque la ligne comporte plusieurs cellules, on peut soit aller à la ligne entre chaque cellule, soit doubler le trait.

Méthode 1 :
{|
|cellule1
|cellule2
|cellule3
|}

Méthode 2 :
{|
|cellule1||cellule2||cellule3
|}

Chacune des cellules d'un tableau peut contenir des paramètres. Pour cela, le contenu d'une cellule sera précédé des paramètres.

Méthode 1 :
{|
|paramètres|cellule1
|paramètres|cellule2
|paramètres|cellule3
|}

Méthode 2 :
{|
|paramètres|cellule1||paramètres|cellule2||paramètres|cellule3
|}

Créer une cellule-titre

On l’utilise généralement pour spécifier qu'une cellule représente un titre. Visuellement, cela se voit car le texte de la cellule est en gras.

La syntaxe est différente et là où on utilisait un trait vertical pour les cellules, nous utiliserons un point d'exclamation !. Attention, par défaut la deuxième cellule d’une ligne commençant par une cellule-titre est considérée comme tel, indépendamment de la syntaxe.

Méthode 1 :
{|
!cellule1
!cellule2
|}

Méthode 2 :
{|
!cellule1!!cellule2!!cellule3
|}

Comme pour les autres balises, il est bien sûr possible d'utiliser des paramètres. Par contre, entre les paramètres et le contenu de la cellule, nous utiliserons toujours le trait vertical |.

Méthode 1 :
{|
!paramètres|cellule1
!paramètres|cellule2
!paramètres|cellule3
|}

Méthode 2 :
{|
!paramètres|cellule1!!paramètres|cellule2!!paramètres|cellule3
|}

Changer de ligne

Lorsque vous souhaitez passer à une nouvelle ligne, il suffit de rajouter un tiret - aprés le trait vertical |. Le nombre de tirets n'a pas de limite maximale.

{|
|cellule1
|cellule2
|-
|cellule1
|cellule2
|}

Comme pour les autres balises, il est bien sûr possible d'utiliser des paramètres.

{|
|cellule1
|cellule2
|----- paramètres
|cellule1
|cellule2
|}

Ajouter une légende

Un petit texte est placé au-dessus du tableau pour permettre de préciser ce qui se trouve dans le tableau.

{|
|+ légende
|cellule1
|cellule2
|----- 
|cellule1
|cellule2
|}

B/ Changer les paramètres