Guide des règles de formatage

Les règles de formatage avec Wakka diffèrent légèrement des autres Wikis. (Voir par exemple les règles de formatage de WikiWikiWeb, le premier Wiki connu.)
Tout texte placé entre deux guillemets doubles - " - est présenté tel que.

Vous pouvez effectuer vos propres test dans le BacASable : c'est un endroit fait pour ça.

• Règles de base :
  • **Texte en gras !** ---> Texte en gras !
  • //Texte en italique.// ---> Texte en italique.
  • Texte __souligné__ ! ---> Texte souligné !
  • Texte @@barré@@ ! ---> Texte barré !
  • ##texte à espacement fixe## ---> texte à espacement fixe
  • %%code%%
  • %%(php) PHP code%%
  • %%(delphi) code delphi/pascal%%

• Empêcher le formatage du texte :

Pour empêcher que Wikini n'interprète les balises de formatage de texte qu'il reconnait, encadrer le texte par une paire de guillemets doubles. Par __exemple__, ce **texte** @@contient@@ des %%balises%% reconnue par Wikini qui ne sont //pas// interprétée car il est encadré par une paire de **guillemets double** comme __vous__ pouvez vous en apercevoir :)

• Deux autres utilisations :
  • écrire directement du HTML dans le wikini - par exemple pour les tableaux... ;-) - vu que ce qui est renvoyé est tout de même interprété par le moteur de rendu de Mozilla
  • afficher des logs / des scripts shell en ajoutant les tag <pre> et </pre> qui seront interprétés pour afficher le texte tel quel par le navigateur (sous réserve qu'il n'y ait pas de double guillemet dedans). Cela permet d'avoir le contenu in extenso plutôt que dans une boîte de code qui est de taille fixe (contrairement à la fonctionnalité de phpBB2 avec les tags [code] et [/code])

• Liens forcés :
  • [[http://www.mon-site.org]]
  • [[http://www.mon-site.org Mon-site]]
  • [[P2P]]
  • [[P2P Page sur le P2P]]

• En-têtes :
  • ====== En-tête énorme ======

    En-tête énorme

  • ===== En-tête très gros =====

    En-tête très gros

  • ==== En-tête gros ====

    En-tête gros

  • === En-tête normal ===

    En-tête normal

  • == Petit en-tête ==

    Petit en-tête

• Séparateur horizontal :

Il suffit de taper au moins 4 "-", au dela de 4 tirets c'est le meme effet
Exemple : ----

---

• Retour de ligne forcé :---

• L'indentation de textes se fait avec la touche "TAB". Vous pouvez aussi créer des listes à puces ou numérotées :
  • - liste à puce
  • 1) liste numérotée (chiffres arabes)
  • A) liste numérotée (capitales alphabétiques)
  • a) liste numérotée (minuscules alphabétiques)
  • i) liste numérotée (chiffres romains)

Note : à cause d'un bogue dans son moteur de rendu, les listes, utilisant la touche TAB, ne fonctionnent pas (encore) sous Mozilla.

• Vous pouvez également indenter du texte en utilisant des caractères espace au lieu de la touche "TAB", les exemples ci dessus restent valables mais attention à ne pas mélanger des "TAB" et des espaces dans la même énumération.
  • - liste à puce
  • 1) liste numérotée (chiffres arabes)
  • A) liste numérotée (capitales alphabétiques)
  • a) liste numérotée (minuscules alphabétiques)
  • i) liste numérotée (chiffres romains)

• Tableaux :

La syntaxe à utiliser pour créer un tableau est du type :
[ |
|cellule1|cellule 2|
|celulle3|cellule 4|
| centré | aligné à droite|
| ]

cellule1	cellule 2
celulle3	cellule 4
centré	aligné à droite

• Action Liens de navigation Table Of Content :

En rajoutant {{trail toc="PageSommaireContenantNotammentLeLienDeLaPageEnCours"}}, wikini définit la page courante comme un des liens de la page sommaire fournie en toc="..." (toc = table of content), et propose une navigation plus souple en fournissant le lien suivants et précédents de la page courante par rapports aux liens définis en sommaire, ainsi qu'un lien permettant de revenir à cette page de sommaire.
Important : les liens de la pages du sommaires doivent être des éléments de liste pour être pris en compte, comme ça :

• Lien1
• Lien2

Une bonne pratique peut consister par exemple à utiliser l'action trail en début et en fin de page.

---