Mangue.org:Aide
Un article de Mangue.org, l'encyclopéde libre.
| Sommaire |
Mediawiki
Mangue.Org utilise un logiciel de wiki (http://fr.wikipedia.org/wiki/Wiki) : Mediawiki (http://www.mediawiki.org/). Il s'agit du wiki utilisé par et développé pour Wikipedia (http://www.wikipedia.org/). Il dispose d'un fonctionnement et d'une syntaxe qui lui sont propres, alors plutôt que de paraphraser sa documentation, voici un lien vers la page d'aide idoine sur Wikipedia : http://fr.wikipedia.org/wiki/Aide:Aide et un autre vers la partie de l'aide concernant la syntaxe (http://fr.wikipedia.org/wiki/Aide:Aide#Syntaxe).
Précisions sur le choix des titres de pages
Voici quelques précisions pour les titres des pages de wiki :
- Il ne faut pas utiliser de titre trop long. Un titre comme "Configuration rapide du serveur ProFTPd afin de le mettre en oeuvre rapidement" n'est pas bon, il est redondant. " Configuration rapide du serveur ProFTPd" suffit . Le fait de préciser "rapide" indique déjà qu'il ne s'agit pas de configuration avancée...
- il faut que le sujet apparaisse. Je vais encore m'appuyer sur un exemple. Pour des langages de prog un cours pourrrait s'appeler : "types de base" ou "structures de contrôle". Ces titres sont mauvais puisqu'ils peuvent être utilisés pour n'importe quel langage et risquent donc de créer des liens erronés. Il faut plutôt utiliser Les structures de contrôle en Perl" ou "les structures de contrôle en Caml". Comme ça, pas de confusion possible.
Bac à sable
Pour vous familiariser avec la syntaxe de mediawiki, vous pouvez faire vos essais et autres tests en tout genre dans le bac à sable.
Coloration de code source
Afin de rendre la lecture des articles plus agréable, Mangue.Org a ajouté à Mediawiki (http://www.mediawiki.org/) la faculté de coloriser le code source, grâce à une extension Mediawiki reposant sur la librairie GeSHi (http://qbnz.com/highlighter/) (cliquez ici pour le code source de l'extension).
Ceci se fait très simplement en entourant le code à coloriser de balises indiquant le langage utilisé. Par exemple, pour coloriser du code écrit en PHP, il suffira d'utiliser la balise <php>, comme suit :
<php>echo 'Bonjour, monde.'; </php>
Notez que la première ligne de code est collée à la balise <php>, de façon à éviter un saut de ligne disgracieux.
Le résultat sera :
echo 'Bonjour, monde.';
Beaucoup de langages sont supportés...
Liste des langages supportés
|
|
|
|
|
|
Modèles
Avec mediawiki, un modèle est une page ou un bloc de données qui peut être inclu automatiquement dans les pages du wiki. Il y a plusieurs cas, ou cela peut s'avérer utile pour passer des "messages types" pour informer les utilisateurs sur un aspect particulier de cette page ou encore pour standardiser la présentation d'un type de données commun à plusieurs pages. Pour plus de détails, consulter la page d'aide sur les modèles sur wikipédia (http://fr.wikipedia.org/wiki/Aide:Modèle).
Pour résumer, on appelle un modèle nommé mon modèle en incluant simplement {{mon modèle}} dans la page à laquelle on veut appliquer le modèle. Il est également possible de passer des paramètres à l'appel de modèle
Liste des modèles utilisés sur Mangue.Org
- Modèles pour les licences créative commons
- Modèle:dmoz pour insérer un lien vers une catégorie de l'ODP (dmoz) ;
- Modèle:ébauche pour signaler qu'un article n'est encore qu'une ébauche ;
- Modèle:En cours signaler qu'un éditeur travaille actuellement sur un article et qu'il ne faut pas le modifier avant qu'il n'aie enlevé l'avertissement ;
- Modèle:Forum pour insérer un lien vers une catégorie du forum de Mangue.Org (http://forum.mangue.org/).
- Modèle:Remarque pour insérer une remarque dans un article en conservant un style identique à chaque fois.
