Note: pour le code source de cette page, allez sur http://www.wikini.net/wakka.php?wiki=DocUtilisateurWikiNi04ReglesDeFormatage/raw
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)
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)
Note : à cause d'un bogue dans son moteur de rendu, les listes, utilisant la touche TAB, ne fonctionnent pas (encore) sous Mozilla.
;,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;,;;,;,,;La suite de cette page concernant les notes et discussions est séparée du reste pour ne pas altérer la documentation telle que fournie avec WikiNi (présentée ci-dessus).
Notes complémentaires
- Il est à noter que pour InclureUneImage on peut utiliser la même syntaxe que pour faire un lien forcé avec texte custom essay writing, WikiNi reconnaît alors l'extension .jpg, .png ou .gif et affichera alors une image à la place:
- Exemple: [[www.snakpak.info/unit/wiki.jpg logo de wikipedia]] donnera:
- L'utilisation du HTML dans les pages d'un WiKi est vivement déconseillée, voir PourquoiEviterLeHTMLDansLesWikis.
Discussions
La note concernant les tabulations est elle toujours d'actualité ?Remarque: Est-ce vraiment un bogue ? La touche TAB, en tout cas sous Mozzila/Firefox/Iceweasel permet de parcourir les champs de la page, et donc en aucun cas de marquer un espace dans la zone de saisie de texte (puisqu'on sort de cette zone en appuyant sur cette touche).
Proposition: Un champ spécial TAB ? Comme {{TAB}} ?
- Oui car on voudrait pouvoir utiliser des tabulations pour l'indentation (pour ceux qui n'aimeraient pas les espaces) et normalement un javascript s'occupe d'inhiber le comportement que tu décris (qui est d'ailleurs valable pour presque tous les navigateurs). En principe ce problème est corrigé dans la version en cours de développement (voir WikiNiBug:6438 (interwiki)) -- DidierLoiseau
Aussi: est-ce gênant que j'écrive à cet endroit ? Vaut-il mieux faire des commentaires ? Merci pour votre disponibilité. Jdf
- sans attendre la nouvelle version il est possible d'utiliser pour Firefox l'extension Tabinta (qui a un comportement multiple de temps à autre) --Xf75013
- c'est vrai qu'à la limite ça pourrait être une option, mais quoi qu'il en soit c'est toujours gênant pour les utilisateurs si une liste a été rédigée en utilisant l'indentation par des tabulations et qu'il n'est pas en mesure d'en faire... -- DidierLoiseau
Ajout du 01/05/08 : la note concernant les tabulations sous Mozilla n'est vraiment plus d'actualité, la touche tabulation me fait une intentation (Wikini 0.5, Firefox 3). Je ne sais pas à qui c'est dû, mais le problème semble résolu ;-)
- — Le problème semble effectivemet résolu dans Firefox 3. Je ne pense pas que c'était le cas dans Firefox 2 par contre… — DidierLoiseau
--