Memento d'aide à la publication

Le site est basé sur un programme de type “wiki” (un peu comme Wikipédia). Lorsqu'une page est éditée afin d'être modifiée, le texte n'apparait plus de la même façon que lorsqu'on affiche un document publié. Plus de gras, de couleurs, de titres. Tout cela est remplacé par une syntaxe particulière faite de suites de caractères. Cette page va résumer les principales syntaxes à utiliser pour la mise en page.

A noter : dans les versions précédentes, un "bac est sable" était disponible pour faire des tests. Il n'est plus créé dorénavant, donc à vous de créer une page de test si besoin.

Pour modifier une page existante, vous devez être logué et avoir des droits suffisants sur le site. Il suffit ensuite de cliquer sur le bouton “Modifier” et vous passez en mode édition. Vous pouvez avoir un aperçu du rendu de la page en cliquant sur le bouton “Aperçu” en bas de la fenêtre de rédaction. Lorsque votre modification est terminée, cliquez sur le bouton “Enregistrer”, à gauche du bouton d'aperçu. Des brouillons de la page sont enregistrés régulièrement (vous aurez la possibilité de récupérer vos écrits en cas de plantage). Vous avez également la possibilité de ne modifier qu'un paragraphe de la page, en cliquant sur le bouton “modifier” qui apparaît sous chaque section en mode édition.

Pour créer une nouvelle page, il faut passer par une page existante : éditez la page existante et cliquez sur un lien vers une page non créée (le lien apparaît en rouge au lieu de vert) ou bien créez un lien vous-même vers une nouvelle page (voir plus bas).

Pour supprimer une page, il suffit d'en supprimer tout le contenu, et elle sera automatiquement effacée (mais pas les liens qui mènent vers elle). Rares seront les occasions d'utiliser cette fonction (pour peu que l'arborescence ait été bien pensée).

La barre des tâches regroupe les principales fonctions d'édition. Lorsque vous cliquez sur un des boutons, le texte sélectionné est automatiquement entouré des balises correspondant à la mise en forme que vous avez choisi.

• Le bouton “B” entoure votre texte des balises ** pour le mettre en gras.
• Le bouton “I” entoure votre texte des balises // pour le mettre en italique.
• Le bouton “U” entoure votre texte des balises __ pour le mettre en souligné.
• Le bouton “TT” entoure votre texte des balises '' pour passer la police en mode “machine à écrire”.
• Le bouton “S” entoure votre texte des balises <del> et </del> pour barrer le texte.
• Les boutons “H” entourent le texte d'un certain nombre de “=” afin de définir les différents niveaux de titres (voir plus bas).
• Le bouton “Lien interne” permet de transformer le texte sélectionné en lien pointant sur une autre page du site.
• Le bouton “Lien externe” permet de transformer le texte sélectionné en lien pointant vers un autre site web.
• Le bouton “Liste numérotée” fait précéder votre texte par “ - ” (deux espaces, un tiret, un espace) : chaque retour à la ligne sera précédé d'un numéro croissant.
• Le bouton “Liste à puces” fait précéder votre texte par “ * ” (deux espaces, une astérisque, un espace) : chaque retour à la ligne sera précédé d'une puce carrée.
• Le bouton “Ligne horizontale” remplace le texte sélectionné par **----** (quatres tirets) qui sont transformés en une ligne de séparation
• Le bouton “Ajout des images ou d'autres fichiers” ouvre la fenêtre de sélection et téléchargement de fichiers.
• Le bouton “Emoticones” permet d'insérer des smileys.
• Le bouton “Caractères spéciaux” permet d'insérer des caractères spéciaux.
• Le bouton “Insérer une signature” permet d'ajouter la signature définie dans le profile de la personne éditant la page (à ne pas utiliser ici).
• Les quatres boutons suivants font références aux notes et font partie d'un plugin qui a été ajouté.

La répétition du signe “=” de part et d'autre d'un texte le défini comme titre, à différents niveaux selon qu'il y ait plus (titre principal) ou moins (titre inférieur) de “=”. Les trois premiers niveaux de titres sont utilisés pour former l'index de la page (en haut à droite) dès lors qu'il y en a assez.

Le titre le plus haut (ou gros si vous préférez) est celui que l'on utilise pour le titre en haut des pages. Pour cela on utilise six “=” à la suite, comme ceci :

====== Titre de la page ======

La division de la page en grands chapitres se fait par l'ajout de cinq “=” de part et d'autre du titre du chapitre, comme ceci :

===== Titre de niveau 1 (Chapitres)=====

Les chapitres peuvent eux-mêmes être divisés en sous parties, comme ceci :

==== Titre de niveau 2 (sous-titre)====
=== Titre de niveau 3 ===
== Titre de niveau 4 ==

qui donnent le résultat suivant (le texte est un peu plus indenté vers la droite à chaque niveau inférieur) :

Les liens internes mènent vers une autre page de ce site. Si la page vers laquelle vous voulez faire pointer le lien existe déjà, le plus simple et d'utiliser le bouton “Lien interne” de la barre des tâches. Il ouvre une fenêtre dans laquelle vous pourrez choisir la page vers laquelle votre texte renvoie.

Si votre page n'existe pas encore, alors il va falloir créer le lien. Un lien interne est défini par des doubles crochets : [[ et ]]

Un lien “simple” se présente comme suit : [[nom du fichier généré | Texte qui renvoie vers le lien ]].

Si des espaces sont présents dans le nom du fichier, ils seront remplacés par des “_” et les accents seront enlevés. En revanche, le texte renvoyant vers le lien reste tel que vous l'avez écrit (sauf utilisations de caractères particuliers non supportés).

Exemple : le lien simple suivant :

[[memento|Retour vers l'aide à la publication]]

donne : Retour vers l'aide à la publication Attention, pour qu'un lien simple fonctionne, il faut que la page vers laquelle il mène soit dans le même dossier (la même branche de l'arborescence des répertoires).

Un lien “complet” comprend l'arborescence des dossiers avant le nom du fichier. Il permet d'aller vers n'importe quelle page du site, et pas seulement celles se trouvant dans le même dossier. Bien sûr, pour cela il faut savoir où se situe la page visée (d'où l'utilité du bouton de la barre des tâches) ou bien on l'on veut placer la nouvelle page qui sera créée.

Exemple : le lien suivant :

[[infos:informatique:index_informatique|Informatique]]

donne : Informatique

Un lien avec ancre permet de mener directement à un chapitre particulier, plutôt qu'en haut de la nouvelle page. Pour cela, le nom du fichier cible doit être suivi d'un “#“et du titre du chapitre (là aussi les espaces sont remplacés par des “_”).

Exemple : le lien suivant :

[[#Les titres|Aide à la publication : accès aux titres]]

donne : Aide à la publication : accès aux titres

Rien de plus simple : il suffit de faire commencer le lien par "http://" et le texte est automatiquement reconnu comme un lien externe. Les liens externes sont précédés d'une petite image représentant une planète (symbole d'internet).Idem pour les adresses mail qui sont reconnues automatiquement.

Sinon la syntaxe reste la même que précédemment sauf que le nom de fichier est remplacé par l'URL de la destination : [[URL|Texte qui renvoie vers le lien ]]

Vous pouvez inclure des images internes ou externes en utilisant des double accolades

Voici une image interne:{{images:nom-de-l-image.jpg}}

Voici une image externe:{{http://de3.php.net/images/php.gif}}

L'image affichée sans plus de précision aura sa taille réelle. Mais Les images peuvent être redimensionnées. Pour cela, le nom du fichier doit être suivi d'un ”?”puis de la taille souhaitée en largeur, et éventuellement de la taille souhaitée en hauteur (optionnel).

Par exemple, pour redimensionner une image en 80 de largeur :

{{images:nom-de-l-image.jpg?80}}

Pour redimensionner une image en 80 en largeur et 220 en hauteur :

{{images:nom-de-l-image.jpg?80x220}}

Trois postions sont possibles pour une image dans une page selon que l'on ajoute un espace à gauche, à droite ou de chaque côté du chemin :

• à gauche : un espace avant les accolades fermantes

  {{dossier:nom-de-l-image.jpg }}

• au milieu (centrée) : un espace de chaque côté

  {{ dossier:nom-de-l-image.jpg }}

• à droite : un espace après les accolades ouvrantes

  {{ dossier:nom-de-l-image.jpg}}

Vous pouvez insérer un titre à l'image qui apparaîtra sous la forme d'une “bulle” au passage de la souris sur l'image. Pour cela, il faut ajouter un “|” après le nom de l'image suivi du texte que l'on veut.

Exemple pour une image centrée avec une bulle affichant “” :

{{ dossier:monimage.png |Ceci est le libellé de l'image}}

Une image peut remplacer du texte pour servir de lien vers une autre page. Pour cela il suffit de remplacer le texte par l'image comme vu ci-dessus.

Exemple :

[[http://www.php.net|{{dossier:monimage.png}}]]

Les lignes et cellules commencent et finissent par des “|”. Ces “|” sont remplacés par des “^” pour les entêtes.

^ Entête 1      ^ Entête 2       ^ Entête 3          ^
| Ligne 1 Col 1    | Ligne 1 Col 2     | Ligne 1 Col 3        |
| Ligne 2 Col 1    | Ligne 2 Col 2     | Ligne 2 Col 3        |
| Ligne 3 Col 1    | Ligne 3 Col 2     | Ligne 3 Col 3        |

|              ^ Entête 1            ^ Entête 2             ^
^ Entête 3     | Ligne 1 Col 1       | Ligne 1 Col 2        |
^ Entête 4     | Ligne 2 col 1       | Ligne 2 Col 2        |
^ Entête 5     | Ligne 2 Col 1       | Ligne 3 Col 2        |

Le Rowspan signifie une cellule fait plusieurs lignes de haut.

^ Entête 1         ^ Entête 2                  ^ Entête 3             ^
| Ligne 1 Col 1    | Ceci est du rowspan       | Ligne 1 Col 3        |
| Ligne 2 Col 1    | :::                       | Ligne 2 Col 3        |
| Ligne 3 Col 1    | :::                       | Ligne 2 Col 3        |

Colspan siginifie qu'une cellule fait plusieurs colonnes de large.

^ Entête 1         ^ Entête 2                                       ^ Entête 3          ^
| Ligne 1 Col 1    | Ligne 1 Col 2                                  | Ligne 1 Col 3        |
| Ligne 2 Col 1    | Ceci est du colspan (attention au double "|")                        ||
| Ligne 3 Col 1    | Ligne 3 Col 2                                  | Ligne 3 Col 3        |

Seul l'alignement horizontal est possible. Pour aligner d'un côté ou de l'autre, il faut mettre deux espaces (au moins) du côté opposé. Pour aligner au milieu il faut au moins deux espaces de chaque côté.

^           Tableau avec alignement           ^^^
|          droite|    centré    |gauche          |
|gauche          |         droit|     centré     |
|    blablabla   |   blablabla  |   blablabla    |

Pour formater l'affichage de dialogues on utilise le caractère “>” en début de ligne.

Voici le début d'un dialogue

> Ah bon, t'es sûr ?

>> Un dialogue c'est à deux,non ?

> Et on est trois

>> Un trilogue ?

>>> Ça sonne bien !

Voici le début d'un dialogue

Ah bon, t'es sûr ?

Un dialogue c'est à deux,non ?

Et on est trois

Un trilogue ?

Ça sonne bien !

Plusieurs solutions possibles :

• Faire précéder le texte de deux espaces à gauche
• Entourer le texte des balises <code> et </code>
• Entourer le texte des balises <file> et </file>

Pour la différence entre “code” et “file” :

Utilisation de "code"

Utilisation de "file"

Ce plugin permet de rajouter des notes dans une page. Quatre types de notes différents sont disponibles. Vous pouvez les utiliser via les boutons de la barre des taches ou avec les balises montrées dans les exemples ci-dessous.

<note>Ceci est une note simple.</note>

<note>Ceci est une note simple.</note>

<note important>Ceci est une note d'avertissement</note>

<note important>Ceci est une note importante</note>

<note tip>Ceci est une astuce.</note>

<note tip>Ceci est une astuce.</note>

<note warning>Ceci est une note d'avertissement</note>

<note warning>Ceci est une note d'avertissement</note>

Forcer le retour à la ligne

Vous aurez peut-être remarqué qu'un retour à la ligne en édition n'est pas pris lors de la publication. Pour forcer un saut de ligne à l'affichage, il faut terminer la ligne par la combinaison de caractères “ \\”.

Pas de formatage

Pour que les suites de charactères ne soient pas transformés en formatage de texte, deux solutions :

1. entourer le texte avec les balises <nowiki> et </nowiki>
2. entourer le texte avec les balises %% et %%

Texte en couleur

Cette option n'est pas disponible par défaut. Un plugin sera sans doute ajouté pour remédier à ce problème.

Indice et exposant

Vous pouvez mettre du texte en _indice ou en ^exposant.

Vous pouvez mettre du texte en <sub>indice</sub> ou en <sup>exposant</sup>.

Pas de table des matières

Pour que la table des matères ne s'affiche pas, il faut mettre le texte ~~NOTOC~~ dans la page

Notes de bas de page

Vous pouvez ajouter des notes de bas de page en mettant le texte entre doubles parenthèses (le nombre s'incrémente au fur et à mesure que vous utilisez ces balises).

Ceci est une note de bas de page ¹⁾. Ceci est une deuxième note de bas de page ²⁾.