Aide à l'écriture MediaWiki : Différence entre versions
De OviWiki
(→Gérer la navigation entre les pages) |
|||
| (10 révisions intermédiaires par 3 utilisateurs non affichées) | |||
| Ligne 1 : | Ligne 1 : | ||
| − | + | Les informations sur le développement d'Ovidentia sont saisies dans un outil Mediawiki [http://www.mediawiki.org http://www.mediawiki.org]. Cet outil simplifie l'édition des documentations et met en forme les textes par une syntaxe spécifique. Vous trouverez ci-dessous une aide à l'écriture Mediawiki. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | Les informations sur le | + | |
| − | Pour ceux qui redoutent la syntaxe de Mediawiki, il existe un script | + | Pour ceux qui redoutent la syntaxe de Mediawiki, il existe un script à installer avec le navigateur Firefox. Ce script facilite l'utilisation des tags : |
Navigateur Firefox : [http://www.mozilla.com http://www.mozilla.com] | Navigateur Firefox : [http://www.mozilla.com http://www.mozilla.com] | ||
| Ligne 23 : | Ligne 11 : | ||
| − | Vous trouverez d'autres tutoriaux sur l' | + | Vous trouverez d'autres tutoriaux sur l'écriture Mediawiki sur Internet : |
[http://www.mediawiki.org/wiki/Help:Contents/fr http://www.mediawiki.org/wiki/Help:Contents/fr] | [http://www.mediawiki.org/wiki/Help:Contents/fr http://www.mediawiki.org/wiki/Help:Contents/fr] | ||
| Ligne 30 : | Ligne 18 : | ||
| − | ==Les bases de l' | + | ==Les bases de l'écriture== |
'''Mettre en gras :'''<br /> | '''Mettre en gras :'''<br /> | ||
| Ligne 50 : | Ligne 38 : | ||
<pre>==== votre texte ====</pre> | <pre>==== votre texte ====</pre> | ||
| − | ''' | + | '''Séparer par une ligne horizontale :'''<br /> |
<pre>----</pre> | <pre>----</pre> | ||
'''Ajouter une url externe (lien vers un site Web) :'''<br /> | '''Ajouter une url externe (lien vers un site Web) :'''<br /> | ||
| − | <pre>[http://www.cantico.fr Site officiel de la | + | <pre>[http://www.cantico.fr Site officiel de la société Cantico]</pre> |
| − | '''Faire une liste | + | '''Faire une liste à puces :'''<br /> |
<pre>* votre texte | <pre>* votre texte | ||
* votre texte suite</pre> | * votre texte suite</pre> | ||
| − | '''Faire une liste | + | '''Faire une liste numérotée :'''<br /> |
<pre># votre texte | <pre># votre texte | ||
# votre texte suite</pre> | # votre texte suite</pre> | ||
| − | ''' | + | '''Insérer une image :'''<br /> |
<pre>[[Image:Example.jpg|Texte alternatif]]</pre><br /> | <pre>[[Image:Example.jpg|Texte alternatif]]</pre><br /> | ||
| − | + | Insérer un aperçu d'une image de 100 pixels de largeur :<br /> | |
<pre>[[Image:Example.jpg|center|thumb|100px|Texte alternatif]]</pre> | <pre>[[Image:Example.jpg|center|thumb|100px|Texte alternatif]]</pre> | ||
| − | ''' | + | '''Insérer un tableau :'''<br /> |
<pre> | <pre> | ||
| − | {| | + | {| début de table |
| − | |+ descriptif du contenu, optionnel; un seul par table | + | |+ descriptif du contenu, optionnel; un seul par table positionné entre le début de la table et la première ligne |
| − | |- | + | |- début de ligne, optionnel sur la première ligne -- le moteur de wiki prend en charge la première ligne |
| − | ! cellule | + | ! cellule entête, optionnel. Les entêtes peuvent être mises soit sur la même ligne séparées par des doubles points d'exclamations (!!), soit sur des lignes séparées, chacune ayant son unique point d'exclamation (!). |
| − | | cellule de | + | | cellule de donnée , requis! Les cellules de données consécutives d'une table peuvent être soit mises sur la même ligne séparées par une double barre verticale (||), soit sur des lignes séparées, chacune ayant son unique barre verticale (|). |
|} fin de table | |} fin de table | ||
</pre> | </pre> | ||
| − | '''Faire un retour | + | '''Faire un retour à la ligne :'''<br /> |
<pre> | <pre> | ||
texte<br /> | texte<br /> | ||
| Ligne 85 : | Ligne 73 : | ||
</pre> | </pre> | ||
| − | ''' | + | '''Séparer 2 textes par un paragraphe :''' ajoutez 2 retours chariots entre les textes<br /> |
<pre>texte | <pre>texte | ||
| Ligne 91 : | Ligne 79 : | ||
</pre> | </pre> | ||
| − | '''Texte | + | '''Texte préformatté (équivalant à la balise PRE en HTML :''' le texte gardera sa mise en forme (retours chariots, espaces...)) :<br /> |
| − | un espace en | + | un espace en début de ligne crée un texte préformatté |
| − | '''Pour ignorer l' | + | '''Pour ignorer l'interprétation d'un texte par le moteur de MediaWiki :'''<br /> |
<nowiki>texte</nowiki> | <nowiki>texte</nowiki> | ||
| − | '''Pour ignorer l' | + | '''Pour ignorer l'interprétation d'un texte par le moteur de MediaWiki et passer un code d'un language de programmation :'''<br /> |
<pre><source lang="php"></source></pre> | <pre><source lang="php"></source></pre> | ||
| − | == | + | ==Gérer la navigation entre les pages== |
'''Ajouter un lien vers une page existante du wiki :'''<br /> | '''Ajouter un lien vers une page existante du wiki :'''<br /> | ||
<pre>[[titre de la nouvelle page|texte du lien]]</pre> | <pre>[[titre de la nouvelle page|texte du lien]]</pre> | ||
| − | Remarque : vous pouvez | + | Remarque : vous pouvez créer une nouvelle page en ajoutant cette syntaxe à votre page courante. Après enregistrement, vous pourrez cliquer sur le lien pour éditer la nouvelle page ! |
| − | '''Ajouter une page | + | '''Ajouter un lien vers une page catégorie (une catégorie est une page d'entrée listant des articles de la même catégorie) :'''<br /> |
| − | <pre>[[: | + | <pre>[[:Catégorie:Ma catégorie]]</pre> |
| − | '''Pour associer une | + | '''Pour associer une catégorie à un article, ajoutez ce qui suit à la fin du contenu de l'article :'''<br /> |
| − | <pre>[[ | + | <pre>[[Catégorie:Ma catégorie]]</pre> |
Version actuelle en date du 13 mai 2010 à 12:56
Les informations sur le développement d'Ovidentia sont saisies dans un outil Mediawiki http://www.mediawiki.org. Cet outil simplifie l'édition des documentations et met en forme les textes par une syntaxe spécifique. Vous trouverez ci-dessous une aide à l'écriture Mediawiki.
Pour ceux qui redoutent la syntaxe de Mediawiki, il existe un script à installer avec le navigateur Firefox. Ce script facilite l'utilisation des tags :
Navigateur Firefox : http://www.mozilla.com
Module Greasemonkey de Firefox : https://addons.mozilla.org/fr/firefox/search?q=greasemonkey&cat=all
Script wikEd de pour Greasemonkey : http://userscripts.org/scripts/show/12529
Vous trouverez d'autres tutoriaux sur l'écriture Mediawiki sur Internet :
http://www.mediawiki.org/wiki/Help:Contents/fr
https://developer.mozilla.org/Project:fr/R%C3%A9f%C3%A9rence_des_balises_wiki
Les bases de l'écriture
Mettre en gras :
'''votre texte'''
Mettre en italique :
''votre texte''
Souligner :
<u>votre texte</u>
Sous-Titre de niveau 2 :
== votre texte ==
Sous-Titre de niveau 3 :
=== votre texte ===
Sous-Titre de niveau 4 :
==== votre texte ====
Séparer par une ligne horizontale :
----
Ajouter une url externe (lien vers un site Web) :
[http://www.cantico.fr Site officiel de la société Cantico]
Faire une liste à puces :
* votre texte * votre texte suite
Faire une liste numérotée :
# votre texte # votre texte suite
Insérer une image :
[[Image:Example.jpg|Texte alternatif]]
Insérer un aperçu d'une image de 100 pixels de largeur :
[[Image:Example.jpg|center|thumb|100px|Texte alternatif]]
Insérer un tableau :
{| début de table
|+ descriptif du contenu, optionnel; un seul par table positionné entre le début de la table et la première ligne
|- début de ligne, optionnel sur la première ligne -- le moteur de wiki prend en charge la première ligne
! cellule entête, optionnel. Les entêtes peuvent être mises soit sur la même ligne séparées par des doubles points d'exclamations (!!), soit sur des lignes séparées, chacune ayant son unique point d'exclamation (!).
| cellule de donnée , requis! Les cellules de données consécutives d'une table peuvent être soit mises sur la même ligne séparées par une double barre verticale (||), soit sur des lignes séparées, chacune ayant son unique barre verticale (|).
|} fin de table
Faire un retour à la ligne :
texte<br /> texte suivant
Séparer 2 textes par un paragraphe : ajoutez 2 retours chariots entre les textes
texte texte suite
Texte préformatté (équivalant à la balise PRE en HTML : le texte gardera sa mise en forme (retours chariots, espaces...)) :
un espace en début de ligne crée un texte préformatté
Pour ignorer l'interprétation d'un texte par le moteur de MediaWiki :
texte
Pour ignorer l'interprétation d'un texte par le moteur de MediaWiki et passer un code d'un language de programmation :
<source lang="php"></source>
Ajouter un lien vers une page existante du wiki :
[[titre de la nouvelle page|texte du lien]]
Remarque : vous pouvez créer une nouvelle page en ajoutant cette syntaxe à votre page courante. Après enregistrement, vous pourrez cliquer sur le lien pour éditer la nouvelle page !
Ajouter un lien vers une page catégorie (une catégorie est une page d'entrée listant des articles de la même catégorie) :
[[:Catégorie:Ma catégorie]]
Pour associer une catégorie à un article, ajoutez ce qui suit à la fin du contenu de l'article :
[[Catégorie:Ma catégorie]]
