Dans un premier temps il suffit d'entrer le texte comme dans n'importe quel petit traitement de texte, ce qui compte c'est ce que vous avez à dire, le fond. Par la suite, éventuellement, quelqu'un, une sorte de jardinier, pourra passer par là et nettoyer le texte pour le structurer et l'enrichir pour lui donner une meilleure forme. Si vous voulez structurer vous-même le texte (retours chariot, paragraphes, titres, listes, tables, gras, italique, souligné,...) et incorporer des images, des sons et des videos, vous devrez utiliser les balises primaires du (X)HTML. Et oui il faut connaître une minimum de HTML, et le site HTML TUTORIAL devrait vous être bien utile pour (re)situer l'usage de telle ou telle balise. Voici une introduction rapide aux balises les plus utiles :
pour passer à la ligne il faut insérer la balise : <br /> ; mais autant que possible, il est préférable de structurer le texte en utilisant des titres, des paragraphes et des listes.
mettre en gras, italique et souligné une portion de texte se fait ainsi : <b>gras</b>, <i>italique</i>, <u>souligne</u> ; pour les titres, il est préférable d'utiliser les balises titre.
un titre est encadré par les balises <hn> et </hn>, avec n prenant ses valeurs dans [1,6], du titre de plus haut niveau (1) au titre de plus petit niveau (6). Un titre est toujours précédé et suivi de retours-chariot automatiques, pas besoin de les insérer.
un paragraphe est encadré par les balises <p> et </p>, ce qui devrait permettre de limiter l'utilisation des retours-chariot au minimum. Un paragraphe est toujours précédé et suivi de retours-chariot automatiques.
une liste commence et finit avec les balises <ul> et </ul> ou <ol> et </ol> suivant qu'il s'agisse d'une liste à puces ou d'une liste numérotée ; chaque article de liste doit être encadré par les balises <li> et </li>. Une liste est toujours précédée et suivie de retours-chariot automatiques.
le code suivant :
<table border="1"> <tr><td>article 11</td><td>article 12</td><td>article 13</td></tr> <tr><td>article 21</td><td>article 22</td><td>article 23</td></tr> <tr><td>article 31</td><td>article 32</td><td>article 33</td></tr> </table>produira cette table :
| article 11 | article 12 | article 13 |
| article 21 | article 22 | article 23 |
| article 31 | article 32 | article 33 |
on peut également créer des liens avec les balises classique HTML, par exemple : <a href="http://www.pixar.com">PIXAR</a> produit le lien PIXAR. Le problème est que l'écriture classique d'un lien vers une page interne du wiki ressemble à ceci : <a href="index.php?page=sandbox">sandbox</a> qui produit le lien sandbox, et que c'est moins évident pour une écriture qui revient fréquemment dans un wiki. Il existe heureusement des raccourcis wiki qui faciliteront considérablement leur écriture.
il est possible d'afficher des portions de code HTML dans la page en l'encadrant de doubles caractères %, exemple : <a href="http://www.pixar.com">PIXAR</a> produit le lien PIXAR. Cette possibilité est largement utilisée dans cette page aide, éditez-la pour l'analyser.
pour des raisons de sécurité il n'est pas possible d'insérer dans la page des portions de javascript. Mais on peut écrire ce type de code pour montrer ou cacher une note :
<a href="javascript:montrer('note1')"> note 1</a>
<p class="note" id="note1">ceci est le contenu de la note 1</p>
la plupart du temps on peut oublier les autres balises HTML, ce n'est donc pas trop compliqué... Mais les connaisseurs pourront intégrer des iframes et autres fonctions parfois bien utiles pour enrichir une page.
Passons maintenant aux styles CSS.