Aide:Rudiments de la syntaxe wiki
Poképédia étant un wiki, il permet l'utilisation d'une syntaxe particulière afin de générer aisément des liens, des tableaux, ou autres.
Cette page présente les rudiments de la syntaxe wiki. Pour une présentation plus en détails, il est conseillé de se reporter à la page de Wikipédia.
Sommaire |
[modifier] Mise en forme
Il est possible de mettre en forme le texte en le mettant, par exemple, en gras ou en italique.
Cette mise en forme se fait à l'aide des apostrophes « ' ».
Trois apostrophes avant et après du texte permettent d'obtenir du texte en gras. Par exemple,
'''texte en gras'''
donne : « texte en gras ».
Deux apostrophes avant et après du texte permettent d'obtenir du texte en italique. Par exemple,
''texte en italique''
donne : « texte en italique ».
Il est possible de combiner les deux syntaxes :
texte en '''gras''' et en ''italique'' ou '''''les deux''''' ou ''partie '''l'un, partie'' l'autre'''.
donne : « texte en gras et en italique ou les deux ou partie l'un, partie l'autre. ».
[modifier] Création de liens
La syntaxe wiki permet de distinguer deux types de liens :
- Les liens internes, qui pointent sur une page présente dans le wiki ;
- Les liens externes, qui pointent vers une page qui n'appartient pas au wiki.
[modifier] Liens internes
Un lien interne permet de pointer vers une page qui appartient au wiki et apparaît sous cette forme.
Ils se codent de la façon suivante :
[[Bulbizarre]]
On obtient alors le lien suivant : « Bulbizarre ».
Il est également possible de leur attribuer un libellé, pour les inclure dans une phrase, par exemple.
Ils se codent ainsi :
Bulbizarre est [[Bulbizarre|un Pokémon]].
Ce qui donne : « Bulbizarre est un Pokémon. »
[modifier] Liens internes spéciaux
La syntaxe
[[<du texte ici>]]
est, à la base, utilisée pour les liens internes, comme expliqué plus haut. Mais elle permet aussi d'insérer des images, de faire des liens inter-wiki (se rapporter aux parties concernées). Donc comment faire lorsque l'on souhaite insérer un lien vers une image ou vers une page précise d'un autre wiki, sans que cela ait le comportement d'insertion d'image, etc. ?
La syntaxe à utilise alors est :
[[:<du texte ici>]]
Ce sont les : qui permettent de faire un lien interne spécial.
Par exemple :
[[Image:Sprite 4 d 025 m.png]]
va donner :
Pour avoir un lien, il faut faire :
[[:Image:Sprite 4 d 025 m.png]]
Ce qui donne : « Image:Sprite 4 d 025 m.png ».
[modifier] Couleurs de liens internes
Les liens internes peuvent avoir deux couleurs : bleue ou rouge.
Les liens bleus indiquent que la cible existe. Un lien rouge indique que la cible n'existe pas encore, ou que le lien est incorrect.
Attention : un lien vers « Bulbizarre » n'est pas le même lien qu'un lien vers « BulBizarre ».
[modifier] Liens externes
Un lien externe est un lien qui pointe vers une page qui n'appartient pas au wiki.
On les code de la manière suivante :
[http://www.google.fr]
On obtient alors: « [1] ». Le numéro entre crochet correspond au numéro de lien externe sans libellé dans la page.
Afin de leur attribuer un libellé, il faut faire ainsi :
J'utilise [http://www.google.fr Google].
Le résultat obtenu alors est : « J'utilise Google. »
[modifier] Création de tableau
Pour plus d'informations sur le sujet, référez-vous à Aide:Insérer un tableau.[modifier] Insertion d'image
Pour plus d'informations sur le sujet, référez-vous à Aide:Ajouter une image.[modifier] Catégorisation
La catégorisation est un élément essentiel dans un wiki, car elle permet de regrouper les informations de tous types (images, articles,...) qui ont des liens entre eux. Cela permet également de chercher les éléments liés entre eux plus facilement, et ainsi de prévenir des doublons.
Ainsi, les sprites d'un même Pokémon ont une catégorie qui leur est associée. À noter qu'un élément peut appartenir à plusieurs catégories. Ainsi, l'image Image:Sprite 4 d 025 m.png appartient aux catégories Sprites Pokémon (Diamant et Perle) et Images Pokémon représentant Pikachu.
La catégorisation se fait à l'aide de Liens internes particuliers :
[[Catégorie:<nom de la catégorie>]]
Cela se traduit au final par un lien vers la catégorie en bas de page. La page est elle-même considérée comme appartenant à cette catégorie.
Par exemple, la présente page appartient à la catégorie Aide de Poképédia. Dans la page se trouve donc quelque part le morceau de code ci-dessous :
[[Catégorie:Aide de Poképédia]]
C'est le morceau [[Catégorie:<...>]] qui en fait un lien spécial.
Les images peuvent aussi être catégorisées. Il faut mettre le code dans leur description. Les catégories elles-mêmes peuvent être catégorisées, donnant ainsi un arbre de catégories.
Attention : pour changer la catégorie d'une image, il ne faut pas la réuploader, mais changer le corps de sa description via le bouton « modifier » en haut de la page de l'image.
À noter : un lien interne vers une catégorie se fait avec la syntaxe :
[[:Catégorie:<nom de la catégorie>]]
[modifier] Utilisation des modèles
Les modèles représentent des morceaux des codes qui peuvent être réutilisables, et parfois paramétrables.
Dans une page spéciale dont les nom est du type « Modèle:<nom du modèle> », tout le contenu appartient au modèle. Ce contenu peut être réutilisé dans une page avec le code :
{{Modèle:nom du modèle}}
ou, plus simplement :
{{nom du modèle}}
Ainsi, pour le modèle « Modèle:Équipe Flora », le code
{{Équipe Flora}}
affiche :
Pokémon de Flora  / 
| |
|---|---|
| Actuels |  Charmillon ·  Skitty ·  Florizarre ·  Goinfrex ·  Carabaffe ·  Givrali
|
| Statut inconnu |  Braségali
|
| Ami |  Manaphy
|
| Temporaire |  Tygnon
|
À noter : le code d'un modèle peut faire appel à d'autres modèles.
[modifier] Paramètres des modèles
Un modèle peut avoir des paramètres, à l'image du modèle « Modèle:Utilisateur Code ami ». Dans les explications du modèle, il est dit qu'il comporte un paramètre sans nom, avec un exemple d'utilisation. Si un argument n'a pas de nom, il suffit de mettre les valeurs des paramètres à la suite, de la façon suivante :
{{<nom du modèle>|<valeur du premier paramètre>|<valeur du deuxième paramètre>|...|<valeur du n-ième paramètre>}}
Ainsi, pour le modèle « Modèle:Utilisateur Code ami », qui prend un argument sans nom, l'utilisation est la suivante :
{{Utilisateur Code ami|0123456789}}
Ce qui donne :
|
Code ami : 0123456789. |
|---|
S'il prenait deux arguments, cela se ferait ainsi :
{{Utilisateur Code ami|0123456789|9876543210}}
L'ordre des paramètres est important. « Modèle:Utilisateur Code ami » ne prend qu'un seul argument, il ne prend donc en compte que le premier argument.
Si les paramètres ont des noms, il faut alors fournir le nom du paramètre. Cela permet de fournir les paramètres dans le désordre, si l'on le souhaite. Ainsi, le modèle « Modèle:Infobox Pokémon » prend plusieurs argument dont nom, nomen et nomde. On peut alors utiliser le modèle ainsi :
{{Infobox Pokémon|nom=Pikachu|nomen=Pikachu|nomde=Pikachu}}
ou encore :
{{Infobox Pokémon|nomen=Pikachu|nom=Pikachu|nomde=Pikachu}}
Si plusieurs valeurs sont précisées pour un paramètre, c'est la dernière valeur qui est prise en compte. Par exemple, pour
{{Infobox Pokémon|nom=Pikachu|nomen=Roucarnage|nom=Bulbizarre}}
le paramètre nom aurait la valeur « Bulbizarre ».
À noter : pour certains modèles, tous les paramètres doivent être remplis. Certains sont facultatifs. Il faut se reporter aux explications du modèle.
[modifier] noinclude et includeonly
Dans un modèle, tout ce qui est inclus dans son corps est inclus dans la page dans laquelle il est déposé. Cela peut poser des problèmes lorsqu'une partie concerne seulement le modèle, et non la page où il est utilisé, ou inversement.
Un bon exemple est la documentation du modèle. Si celle-ci est dans la page « corps » du modèle, il faut qu'elle s'affiche lorsque l'on regarde la page du modèle, mais pas dans la page où le modèle est utilisé.
Pour ce faire, il est possible d'utiliser la balise <noinclude>du texte</noinclude>. Cela indique que ce qui est écrit entre la balise ouvrante et la balise fermante ne sera pas inclus (not included) dans la page d'utilisation du modèle.
À l'inverse, on peut vouloir que du texte soit pris en compte uniquement pour la page de dépôt, et non pour la page du modèle. Un exemple est la catégorisation de la page cible grâce au modèle :
« Le modèle Infobox Pokémon permet d'ajouter la catégorie Pokémon à la page dans laquelle il est utilisé. Hors, le modèle Infobox Pokémon, lui, ne doit pas appartenir à cette catégorie. »
Ce genre de traitement est possible par la balise <includeonly>du texte</includeonly>. Elle permet d'indiquer que ce qui se trouve entre les balises ouvrante et fermante sera uniquement inclus (only included) dans la page cible.
La page d'un modèle permet donc de jouer avec includeonly et noinclude afin que certaines informations soient affichées ou utilisées uniquement pour le modèle, ou uniquement pour les pages dans lesquelles il est utilisé.
[modifier] Références
Un bon article est un article sourcé, notamment pour tout ce qui n'est pas vérifiable dans les jeux vidéos.
