Aide:Édition
De Gentoo-Quebec.
aide sur l'édition du contenu
Sommaire |
Introduction
Voici un petit guide vous proposant quelques trucs sur l'ajout et la mise à jour des pages du wiki.
Bac à sable
Le bac à sable est l'endroit idéal pour vous familiariser avec la syntaxe wiki et la syntaxe HTML équivalente à celle du wiki. Utilisez-le à volonté pour expérimenter. Vous avez la possibilité de créer votre propre bac à sable dans votre espace nom personnel. Pour ce faire taper dans la barre d'adresse du navigateur l'adresse de votre espace nom suivi du nom du bac à sable. Séparez l'espace nom du nom du bac à sable par des deux-points. Voici un exemple.
http://gentoo-quebec.org/wiki/index.php/Identifiant:Sandbox
Bien sûr, remplacez Identifiant par votre identifiant de connexion.
Vous insérez une barre de navigation en haut d'une page, au-dessus de l'entête, à l'aide du modèle Retour. La barre de navigation permet de retourner à un point précis dans le wiki, par exemple le retour à la page d'index.
Voici le code utilisé dans cette page d'aide pour retourner à l'index de l'aide en page d'accueil.
{{Retour|cible=[[Aide:Accueil|Index de l'aide]]}}
La destination est une valeur passée via le paramètre cible. Le pipe, | , est utilisé pour suppléer un texte au nom de la page de destination. Il est possible de spécifier plus d'un point de retour comme dans l'exemple ci-dessous.
{{retour|cible=[[400-Logiciels:Index|Index général des logiciels]]
<nowiki>|</nowiki> [[400-Logiciels:Communs:Index|Index des logiciels communs]]}}
Coloration syntaxique
L'extension GeSHI permet de reproduire des exemples de code en respectant la mise en forme appliquée par le langage. Ceci se réalise à l'aide de la balise <source>.
<source lang="html4strict">
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Le site d'AramisQc - Linux, Debian et plus</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="gedit 2.20" />
<meta name="keywords" content="aramisqc, aramis_qc, linux, debian, lvm, aptitude, gnome" />
<link href="css/style1.css" rel="stylesheet" type="text/css" />
</head>
<!-- Début du corps de la page -->
<body>
<div id="header"> <!-- Début de la section entête -->
<div id="sitename">
<h1>Le site d'AramisQc</h1>
</div>
<div id="slogan">
<p>GNU/Linux : l'informatique libre et gratuite !</p>
</div>
</div> <!-- Fin de la section entête -->
<div id="navigation"> <!-- Début de la section de navigation -->
<ul>
<li><a href="index.html">Accueil</a></li>
<li><a href="about.html">À propos du site</a></li>
<li><a href="contact.html">Contactez-moi</a></li>
<li><a href="linux.html">Linux</a></li>
<li><a href="archlinux.html">Archlinux</a></li>
<li><a href="debian.html">Debian</a></li>
<li><a href="aptitude.html">Aptitude</a></li>
<li><a href="gnome.html">GNOME</a></li>
<li><a href="documents.html">Documents</a></li>
<li><a href="links.html">Liens utiles</a></li>
</ul>
</div> <!-- Fin de la section de navigation -->
<div id="bodycontent"> <!-- Début du corps principal de la page -->
<h2>Bienvenue sur le site d'AramisQc</h2>
<p><img src="images/tuxminiopacity25.png" class="tuxpos" width="154" height="181" alt="Tux, la mascotte GNu/linux" /></p>
<p>Vous avez découvert ce site et j'en suis fort heureux. Ce que vous y trouverez sont des informations issues de mes expériences personnelles avec les distributions <span class="highlight">GNU/Linux Debian</span> et <span class="highlight">GNU/Linux Archlinux.</p>
<p>Évidemment, ce site n'a pas la prétention de couvrir tous les aspects de <span class="highlight">GNU/Linux</span> en général et des distributions <span class="highlight">GNU/Linux Debian</span> et <span class="highlight">GNU/Linux Archlinux</span> en particulier. J'ose simplement espérer que son contenu saura vous être d'une quelconque utilité. Peut-être vous incitera-t-il à faire de <span class="highlight">GNU/Linux Debian</span> ou de <span class="highlight">GNU/Linux Archlinux</span> votre distribution préférée ?</p>
<p>Je vous souhaite une bonne navigation et je vous invite à consulter la page à propos du site pour en savoir plus sur celui-ci.</p>
</div> <!-- Fin du corps principal de la page -->
</body>
<!-- Fin du corps de la page -->
</html>
</source>
L'exemple de code ci-haut donnera :
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>Le site d'AramisQc - Linux, Debian et plus</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="generator" content="gedit 2.20" /> <meta name="keywords" content="aramisqc, aramis_qc, linux, debian, lvm, aptitude, gnome" /> <link href="css/style1.css" rel="stylesheet" type="text/css" /> </head> <!-- Début du corps de la page --> <body> <div id="header"> <!-- Début de la section entête --> <div id="sitename"> <h1>Le site d'AramisQc</h1> </div> <div id="slogan"> <p>GNU/Linux : l'informatique libre et gratuite !</p> </div> </div> <!-- Fin de la section entête --> <div id="navigation"> <!-- Début de la section de navigation --> <ul> <li><a href="index.html">Accueil</a></li> <li><a href="about.html">À propos du site</a></li> <li><a href="contact.html">Contactez-moi</a></li> <li><a href="linux.html">Linux</a></li> <li><a href="archlinux.html">Archlinux</a></li> <li><a href="debian.html">Debian</a></li> <li><a href="aptitude.html">Aptitude</a></li> <li><a href="gnome.html">GNOME</a></li> <li><a href="documents.html">Documents</a></li> <li><a href="links.html">Liens utiles</a></li> </ul> </div> <!-- Fin de la section de navigation --> <div id="bodycontent"> <!-- Début du corps principal de la page --> <h2>Bienvenue sur le site d'AramisQc</h2> <p><img src="images/tuxminiopacity25.png" class="tuxpos" width="154" height="181" alt="Tux, la mascotte GNu/linux" /></p> <p>Vous avez découvert ce site et j'en suis fort heureux. Ce que vous y trouverez sont des informations issues de mes expériences personnelles avec les distributions <span class="highlight">GNU/Linux Debian</span> et <span class="highlight">GNU/Linux Archlinux.</p> <p>Évidemment, ce site n'a pas la prétention de couvrir tous les aspects de <span class="highlight">GNU/Linux</span> en général et des distributions <span class="highlight">GNU/Linux Debian</span> et <span class="highlight">GNU/Linux Archlinux</span> en particulier. J'ose simplement espérer que son contenu saura vous être d'une quelconque utilité. Peut-être vous incitera-t-il à faire de <span class="highlight">GNU/Linux Debian</span> ou de <span class="highlight">GNU/Linux Archlinux</span> votre distribution préférée ?</p> <p>Je vous souhaite une bonne navigation et je vous invite à consulter la page à propos du site pour en savoir plus sur celui-ci.</p> </div> <!-- Fin du corps principal de la page --> </body> <!-- Fin du corps de la page --> </html>
Vous obtenez une liste des langages reconnus par GeSHI ici :
Création d'une nouvelle page
Pour créer une nouvelle page, vous vous rendez tout d'abord à la page de l'index du sujet concerné. Vous y insérez alors un nouvel élément et vous sauvegardez l'ajout en cliquant sur le bouton Publier. L'élément nouvellement ajouté s'affiche en rouge.
Prenons à titre d'exemple la création d'une page sur le matériel. Vous cliquez sur le lien Matériel dans la page d'accueil à la rubrique Portails thématiques. Vous ajoutez un élément à la section touchée par le matériel pour lequel vous créez une nouvelle page. Démontrons le tout par un ajout à la section des imprimantes. Vous cliquez sur l'option Modifier. Cela ouvre la section en mode édition. Ajoutez un bloc semblable à celui-ci.
<div style="margin-top:20px;"> *[[200-Matériel:Imprimantes:Brother MFC-240C|Installation de la Brother MFC-240C]] <div style="margin-left:20px;"> Document décrivant les étapes d'installation et de configuration de l'imprimante tout-en-un Brother MFC-240C. </div></div>
Il s'agit de spécifier l'espace nom dans lequel la page sera créée ainsi que le nom de la page. Dans l'exemple ci-haut, cela se traduit par :
*[[200-Matériel:Imprimantes:Brother MFC-240C|Installation de la Brother MFC-240C]]
L'espace nom est 200-Matériel:Imprimantes: et le nom de la page est la valeur suivant le :. Pour afficher dans l'index une valeur autre que celle de l'objet, on lui substitue un texte à l'aide du | suivi du texte à afficher.
Finalement vous complétez le tout avec une brève description du document.
<div style="margin-left:20px;"> Document décrivant les étapes d'installation et de configuration de l'imprimante tout-en-un Brother MFC-240C.
Tous les index sont conçus de la même façon. Cet exemple s'applique donc à n'importe quel index que vous modifiez pour y ajouter une entrée.
Exemple de code
Pour insérer un exemple de code dans votre page wiki, vous utilisez la balise <pre>. En voici un exemple.
Exemple de code : Fichier /etc/fstab
# /etc/fstab: static file system information. # # noatime turns off atimes for increased performance (atimes normally aren't # needed; notail increases performance of ReiserFS (at the expense of storage # efficiency). It's safe to drop the noatime options if you want and to # switch between notail / tail freely. # # The root filesystem should have a pass number of either 0 or 1. # All other filesystems should have a pass number of 0 or greater than 1. # # See the manpage fstab(5) for more information. # # <fs> <mountpoint> <type> <opts> <dump/pass> # NOTE: If your BOOT partition is ReiserFS, add the notail option to opts. /dev/sda1 /boot ext2 noauto,noatime 1 2 /dev/sdb5 / ext3 noatime 0 1 /dev/sda2 none swap sw 0 0 /dev/sdb6 /home ext3 defaults,noatime 0 1 /dev/sda5 /data ext3 defaults,noatime 0 1 #/dev/cdrom/cdrom0 /mnt/cdrom0 auto noauto,user 0 0 #/dev/fd0 /mnt/floppy auto noauto 0 0 # glibc 2.2 and above expects tmpfs to be mounted at /dev/shm for # POSIX shared memory (shm_open, shm_unlink). # (tmpfs is a dynamically expandable/shrinkable ramdisk, and will # use almost no memory if not populated with files) #shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 none /dev/shm tmpfs nodev,nosuid,noexec 0 0
Vous pouvez également produire un exemple de code aux couleurs officielles de Gentoo comme dans le handbook. Regardez les exemples du lien et comparez avec ceci.
cat /etc/fstab # /etc/fstab: static file system information. # # noatime turns off atimes for increased performance (atimes normally aren't # needed; notail increases performance of ReiserFS (at the expense of storage # efficiency). It's safe to drop the noatime options if you want and to # switch between notail / tail freely. # # The root filesystem should have a pass number of either 0 or 1. # All other filesystems should have a pass number of 0 or greater than 1. # # See the manpage fstab(5) for more information. # # <fs> <mountpoint> <type> <opts> <dump/pass> # NOTE: If your BOOT partition is ReiserFS, add the notail option to opts. /dev/sda1 /boot ext2 noauto,noatime 1 2 /dev/sdb5 / ext3 noatime 0 1 /dev/sda2 none swap sw 0 0 /dev/sdb6 /home ext3 defaults,noatime 0 1 /dev/sda5 /data ext3 defaults,noatime 0 1 #/dev/cdrom/cdrom0 /mnt/cdrom0 auto noauto,user 0 0 #/dev/fd0 /mnt/floppy auto noauto 0 0 # glibc 2.2 and above expects tmpfs to be mounted at /dev/shm for # POSIX shared memory (shm_open, shm_unlink). # (tmpfs is a dynamically expandable/shrinkable ramdisk, and will # use almost no memory if not populated with files) #shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 none /dev/shm tmpfs nodev,nosuid,noexec 0 0
df -h Sys. de fich. Tail. Occ. Disp. %Occ. Monté sur rootfs 19G 8,4G 9,5G 48% / /dev/root 19G 8,4G 9,5G 48% / rc-svcdir 1,0M 76K 948K 8% /lib/rc/init.d udev 10M 76K 10M 1% /dev none 1012M 0 1012M 0% /dev/shm /dev/sdb6 9,4G 4,3G 4,8G 48% /home /dev/sda5 228G 13G 204G 6% /data
Vous remarquerez qu'une barre de défilement est automatiquement affichée quand le contenu de l'exemple déborde la hauteur maximale permise selon la règle de style de la balise <pre>. Cette règle se nomme gentoostyle. Le contenu de l'exemple qui est passé via la variable source doit donc être inséré entre <pre class="gentoostyle"> ... </pre>.
Vous utilisez le modèle ExempleCode pour produire cet effet. Le nom de l'exemple est passé via la variable caption.
Si vous n'obtenez pas l'effet de gentoostyle, veuillez rafraîchir la cache de votre navigateur. Sous Firefox vous cliquez sur le bouton de rafraîchissement en tenant la touche MAJ enfoncée.
Insertion d'images
Vous pouvez insérer une image dans une page wiki à l'aide du modèle ImageCentre. Comme son nom l'indique, l'image et sa légende sont centrées dans l'écran.
Exemple d'utilisation :
{{ImageCentre|image=mon_image|taille=640px|caption=Image de voyage}}
Pour en savoir plus sur ce modèle, cliquez ici.
Modification d'un index
Tous les index sauf celui de la page d'accueil (réservé au WikiSysop) sont modifiables. Il s'agit de modifier la page d'index en y ajoutant un bloc comme celui-ci :
<div style="margin-top:20px;"> <ul> <li>[[100-Installation:Gentoo Funtoo stable | Installation d'une Gentoo variante Funtoo stable]]</li> </ul> <div style="margin-left:20px;"> <p>Toutes les étapes d'installation conduisant à la mise en place d'un système d'exploitation de base axé sur Funtoo stable.</p> </div></div>
L'élément de la liste contient le nom du fichier de la page suivi du pipe suivi de la valeur qui s'affiche dans la liste globale de l'index. L'autre élément qui n'est pas dans la liste, constitue une brève description sur l'ojet de la page. On peut substituer la syntaxe HTML de la liste par la syntaxe wiki.
*[[100-Installation:Gentoo Funtoo stable | Installation d'une Gentoo variante Funtoo stable]]
Modèles à insérer dans une page
Plusieurs modèles sont mis à votre disposition pour vous faciliter la vie lors de l'édition d'un page dans le wiki. Pour obtenir la liste des modèles vous vous rendez dans Spécial:Toutes les pages. Sélectionnez Modèle dans la liste déroulante Espace de noms et cliquez sur le bouton Lister.
Cliquez sur un des éléments de la liste pour visualiser le modèle. Certains modèles ont un bloc de texte délimité par les balises <noinclude>...</noinclude>. Ce texte explique comment utiliser le modèle.
Lorsque vous insérez un modèle dans une page, le contenu délimité par les balises <noinclude> et </noinclude> n'est pas inclus.
Tableau aux couleurs Gentoo
Vous pouvez créer un tableau aux couleurs officielles de Gentoo en utilisant la règle de style gentoostyle dans la déclaration de votre tableau. Voici un exemple de code.
{| class="gentoostyle"
|+Une table échantillon
|-
!Entête colonne 1 !!Entête colonne 2 !!Entête colonne3
|-
|Item 1 ||Item 2 ||Item 3
|}
Ceci donnera ce résultat :
| Entête colonne 1 | Entête colonne 2 | Entête colonne3 |
|---|---|---|
| Item 1 | Item 2 | Item 3 |
Si vous n'obtenez pas l'effet de gentoostyle, veuillez rafraîchir la cache de votre navigateur. Sous Firefox vous cliquez sur le bouton de rafraîchissement en tenant la touche MAJ enfoncée.
