Guide des règles de formatage
WikiNi utilise un formatage spécial simple pour éditer les pages. Cette page sert à décrire l'ensemble des règles qui peuvent être employées pour présenter une page. Ces règles peuvent autant être employées pour l'édition de pages que pour l'écriture de commentaires, ainsi que pour certaines actions (voir la
documentation des actions)
Vous pouvez effectuer vos propres test dans le
BacASable : c'est un endroit fait pour ça.
Les règles de formatage avec diffèrent légèrement des autres
Wikis. (Voir par exemple
les règles de formatage de WikiWikiWeb, le premier
WiKi connu.)
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%%
- %%(c) code c/c++%%
- %%(java) code java%%
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, ""comme ceci"". Par __exemple__, ce **texte** @@contient@@ des %%balises%% reconnue par Wikini mais qui ne sont pourtant //pas// interprétées car il est encadré par une paire de **guillemets doubles** 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 votre navigateur. (Pour l'instant il n'y a pas encore de syntaxe spéciale qui permette d'insérer des tableaux dans une page)
- 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]). Vous pouvez aussi utiliser les dièses pour cela, comme ceci: ##""vos logs / scripts""##.
Liens forcés :
- Tous les NomWiki sont automatiquement remplacés par des liens (à moins de les mettre entre deux paires de guillemets doubles), mais si vous voulez donner un lien vers une page dont le nom n'est pas un NomWiki, ou un lien vers un autre site, utilisez la synthaxe suivante:
Images :
- Pour placer une image, utilisez la même synthaxe que pour les liens forcés, en donnant l'url de votre image. (il est donc actuellement impossible de mettre un lien vers une image, ou un lien sur une image...) Exemple:
- [[UrlDeLimage]] ou [[UrlDeLImage Texte Alternatif]]
- Le texte alternatif est le texte qui apparait quand l'image est introuvable ou quand l'utilisateur place sa souris au dessus. (Il est important aussi pour les non-voyants qui peuvent tout de même avoir une idée de ce que représentait l'image en lisant ce texte) Exemple:
- [[http://fsa.notredomaine.org/wiki/blocfac.gif Image FSA]]
- donne (passer la souris au dessus pour voir le texte alternatif)
Formules mathématiques
- Il est possible d'insérer des formules mathématiques en utilisant la syntaxe LaTeX. Pour ce faire, il suffit de les placer entre deux dollars:
- $$x^2$$ donne
- $$\frac{a}{b}$$ donne
- $$\psi_{tot}(x,-t_0,r) = \frac{1}{(2\pi)^2} \int\!\!\!\int \tilde\Psi_{tot}\left(k_x,\frac{c}{2}\sqrt{k_x^2 + k_r^2},r=0\right)$$ donne
- Bien entendu il est impossible d'utiliser les fonctions sensibles de LaTeX. Par exemple $$\input fichier.txt$$ donne
- Les images sont actuellements générées par le serveur de Spip et mises en cache, en attendant une meilleure solution. N'en abusez tout de même pas ;-) (vous trouverez plus de détails concernant le fonctionnement ici)
Liens InterWiki:
- Un lien InterWiki est un lien qui pointe vers un autre site (en général un wiki) dont les urls contiennent le nom de la page (ou un critère de recherche etc.), ils s'écrivent comme ceci:
- Par exemple:
- Vous pouvez combiner les liens interWiki avec la synthaxe des liens forcés: Recherche de "Wiki" sur Google (interwiki)
- Pour connaître la liste des racourcis disponibles, consultez la ListeDesSitesInterWiki.
En-têtes :
- Pour mettre des titres dans vos pages utilisez la synthaxe suivante:
- ====== 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 "-" pour tracer une ligne (au dela de 4 tirets c'est le meme effet)
Retour de ligne forcé :
- il suffit de taper 3 "-" pour forcer un retour à la ligne dans un texte (attention: un de plus trace une ligne...)
- ---
L'indentation de textes :
- Placez des espaces ou des tabulations (touche "TAB" ou deux flèches sur votre clavier) en début de ligne. On préfère en général les espaces pour une question de lisibilité à l'édition. 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)
