Règles de mise en forme

Cette page donne une liste plus complète des balises disponibles dans PmWiki. Il est facile de créer des pages sans les balises ci-dessous, mais si vous en avez besoin, elles sont disponibles.

Pour vous entraîner à l'usage des règles, utilisez le Bac à sable.


Paragraphes

Pour créer des paragraphes, entrez simplement du texte. Laissez une ligne vide pour commencer un nouveau paragraphe.

Le remplissage des mots et le passage à la ligne est automatique. Pour désactiver le remplissage automatique, utilisez la directive (:linebreaks:) au dessus du paragraphe.

  • Utilisez \ (backslash, barre oblique inversée) à la fin d'une ligne pour attacher la ligne courante à la suivante.
  • Utilisez \\ (deux backslashes) à la fin d'une ligne pour forcer une coupure de ligne, mais conserver l'environnement courant (par ex. rester à l'intérieur d'une liste d'éléments).
  • Utilisez \\\ (trois backslashes) pour 2 sauts de ligne, \\\\ pour 3 sauts de ligne etc.
  • Utilisez [[<<]] pour forcer un saut de ligne après d'éventuels éléments flottants (p.ex. avec %rfloat%).

Paragraphes en retrait

Une flèche (->) au début d'un paragraphe provoque sa mise en retrait. Plus de tirets au début (--->) augmentent la profondeur du retrait.

->La proposition essentielle de la déclaration universelle des droits
de l'homme est que tous les hommes naissent libres et égaux en droit.
La proposition essentielle de la déclaration universelle des droits de l'homme est que tous les hommes naissent libres et égaux en droit.

Les flèches inversées (-<) en début de paragraphe peuvent être utilisées pour produire un paragraphe avec un alinéa (inversé). Plus de tirets au début, cause la mise en retrait de tout le texte.

-< La proposition essentielle de la déclaration universelle des droits
de l'homme est que tous les hommes naissent libres et égaux en droit.
La proposition essentielle de la déclaration universelle des droits de l'homme est que tous les hommes naissent libres et égaux en droit.
--< La proposition essentielle de la déclaration universelle des droits
de l'homme est que tous les hommes naissent libres et égaux en droit.
La proposition essentielle de la déclaration universelle des droits de l'homme est que tous les hommes naissent libres et égaux en droit.

Les blocs de texte auxquels la directive (:linebreaks:) est appliquée peuvent être mis en retrait avec la balise (->) provoquant l'alignement des lignes suivantes sous la première. Une ligne sans alinéa arrête la mise en retrait du bloc.

(:linebreaks:)

Ceci est du texte normal, sans mise en retrait.

-> Voici un texte mis en retrait
   avec des retours à la ligne
   au milieu du texte.

   Cette mise en retrait se
   poursuit à travers les 
   paragraphes suivants.

Ici, retour à la normale.
(:nolinebreaks:)

Ceci est du texte normal, sans mise en retrait.

Voici un texte mis en retrait
avec des retours à la ligne
au milieu du texte.
Cette mise en retrait se
poursuit à travers les
paragraphes suivants.

Ici, retour à la normale.


Listes à puces et listes numérotées

Les listes à puces sont créées en placant des astérisques (*) en début de ligne. Les listes numérotées sont créées en plaçant des dièses (#) en début de ligne. Plus d'astérisques/dièses accroissent la profondeur du niveau:

* Élément de premier niveau
** Élément de second niveau
### Trouver ça
#### Et ça (optionnel)
### Puis ça
** Un autre élément de second niveau
*Un élément de premier niveau : recette
## Préparer l'expérience
### Déballer la tarte
### Mettre la tarte dans le four
## Commencer la cuisson de la tarte
## Attendre
  • Élément de premier niveau
    • Élément de second niveau
      1. Trouver ça
        1. Et ça (optionnel)
      2. Puis ça
    • Un autre élément de second niveau
  • Un élément de premier niveau : recette
    1. Préparer l'expérience
      1. Déballer la tarte
      2. Mettre la tarte dans le four
    2. Commencer la cuisson de la tarte
    3. Attendre

Voir aussi (en anglais): Cookbook:OutlineLists et Cookbook:NumberedHeaders

# Une liste se termine par la 
première ligne qui n'est pas un élément de liste.
# Une liste continue si la ligne suivante
  commence par des espaces et s'aligne verticalement avec celle-ci.
# Un saut de ligne forcé \\
  fera un retour à la ligne dans l'élément.
  1. Une liste se termine par la

première ligne qui n'est pas un élément de liste.

  1. Une liste continue si la ligne suivante commence par des espaces et s'aligne verticalement avec celle-ci.
  2. Un saut de ligne forcé
    fera un retour à la ligne dans l'élément.

Il est aussi possible de choisir ne nombre de départ de la liste avec item value=3 et le type de numérotation avec les balises %ROMAN%, %roman%, %ALPHA%, et %alpha%. Ce style doit être spécifié dans le premier élément de la liste.

# %item value=6% Démarre à 6
# encore
# encore
----
# %ROMAN% Liste numérotée
# par nombres romains
# en majuscules.
----
# %alpha% Liste numérotée
# par lettres
# en minuscules.
  1. Démarre à 6
  2. encore
  3. encore

  1. Liste numérotée
  2. par nombres romains
  3. en majuscules.

  1. Liste numérotée
  2. par lettres
  3. en minuscules.

Voir WikiStyles pour plus d'information.


Listes de définition

Des listes de définition (:terme:définition) sont créées en plaçant des deux points en début de ligne et entre le terme et sa définition :

:terme:définition du terme
::terme de 2nd niveau: définition du terme de second niveau
terme
définition du terme
terme de 2nd niveau
définition du terme de second niveau

Espaces en début de ligne

Dans les listes, si une ligne qui commence par un espace et s'aligne verticalement avec la précédente, est considérée comme étant dans cet élément. Notamment :

*  Ligne 1
   Ligne 2
*Ligne 3
 Ligne 4
  • Ligne 1 Ligne 2
  • Ligne 3 Ligne 4

Ligne 1 commence par astérisque et 2 espaces avant le texte; Ligne 2, précédée par 3 espaces, s'aligne verticalement avec Ligne 1 et y est incluse. Pareil pour Lignes 3 et 4, mais précédées d'un caractère chacune.

Il est possible d'avoir des listes imbriquées précédées par des espaces et non par de multiples * ou # :

# Premier niveau.\\
  Les espaces permettent de rester dans l'élément.
# Autre élément de premier niveau.
  # Espace et un # unique pour imbriquer cet élément dans le précedant.
  # Nouvel élément de niveau 2.
  1. Premier niveau.
    Les espaces permettent de rester dans l'élément.
  2. Autre élément de premier niveau.
    1. Espace et un # unique pour imbriquer cet élément dans le précedant.
    2. Nouvel élément de niveau 2.

En dehors des listes, les lignes commençant par des espaces sont affichées comme du texte préformaté, avec une police à chasse fixe et sans sauts de ligne automatiques. Cette fonction peut être modifiée par l'administrateur du wiki, avec la variable $EnableWSPre.

On peut également avoir du texte préformaté en l'entourant de [@...@].


Ligne horizontale

Quatre tirets ou plus (----) au début d'une ligne créent une ligne horizontale.


Emphase

  • Doubles apostrophes '', créent une emphase (habituellement des italiques)
  • Triples apostrophes ''', créent une emphase renforcée (habituellement du gras)
  • Quintuples apostrophes ''''', créent une autre emphase (habituellement des italiques en gras)
  • Doubles arobases (@@texte@@) affichent le texte en police à chasse fixe
  • Utiliser [+texte plus gros+] pour du texte plus gros, [++texte encore plus gros++] pour du texte encore plus gros, [-texte plus petit-] pour du texte plus petit et [--texte encore plus petit--] pour du texte encore plus petit.
  • L'emphase peut être utilisée plusieurs fois dans une ligne, mais ne peut aller au delà des limites de ligne (vous ne pouvez pas insérez une coupure de paragraphe au milieu d'un texte en gras).

Autres styles

'+gros+', '-petit-', '^exposant^', '_indice_', 

{+insertion ou souligné+}, 

{-suppression ou barré-}

gros, petit, exposant, indice,

insertion ou souligné,

suppression ou barré

Voir aussi les WikiStyles pour des options de mise en forme évoluées.


Références (liens)

  • Utiliser les mots et phrases entre double-crochets (par ex. [[règles de formatage]]) pour créer des liens vers d'autres pages de ce wiki.
  • Préfixer les adresses URL avec "http:", "ftp:", "gopher:", "mailto:", ou "news:" pour créer des liens automatiquement, comme dans http://www.pmichaud.com/toast.
  • Les URLs finissant par .gif, .jpg, ou .png sont affichés en tant qu'images dans la page.
  • Des liens avec un texte arbitraire peuvent être créés soit comme [[lien | texte]] or [[texte -> lien]]. texte peut être l'URL d'une image, auquel cas l'image s'affiche et renvoie vers une url ou un MotWiki.

Pour plus de détails cf. Liens.


Titres de section

Les titres de sections sont créées en mettant des points d'exclamation (!) en début de ligne. Par exemple,

!! Titre de niveau 2
!!! Titre de niveau 3
!!! Titre de niveau 4

Titre de niveau 2

Titre de niveau 3

Titre de niveau 4

Le titre de niveau 1 devrait être unique et réservé à la page. Il se définit par la balise (:title Titre de la page:).


Séquences d'échappement

Tous ce qui est placé entre [= et =] n'est pas interprété par PmWiki. Ceci rend possible de désactiver les balises de mises en page.

[= et =] peut contenir plusieurs lignes, y compris des lignes vides. Ceci peut être utile pour entourer du code source de programmes, qui seront alors affichées avec une police à chasse fixe et ne sera pas interprété par PmWiki. Pour ce faire, laisser un espace devant la balise entrante [=, et terminer avec la balise =]. Si il y a des paires de [=..=] dans le code, mettez après chaque =], un =][=.

 [=
Code goes here like [[PmWiki.PmWiki]]
$CurrentTime $[by] $AuthorLink:  [=$ChangeSummary=]=][='; #just some code
=]
 
Code goes here like [[PmWiki.PmWiki]]
$CurrentTime $[by] $AuthorLink:  [=$ChangeSummary=]'; #just some code

Un autre jeu de balises : [@...@] affiche son contenu préformaté et non-interprété par le wiki.

[@
Code goes here like [[PmWiki.PmWiki]]
$CurrentTime $[by] $AuthorLink:  [=$ChangeSummary=]=][='; #just some code
@]
Code goes here like [[PmWiki.PmWiki]]
$CurrentTime $[by] $AuthorLink:  [=$ChangeSummary=]=][='; #just some code

Caractères Spéciaux

Pour des caractères tels que © ¼ ½ ® → ⇔ ♠ ♣ ♦ ♥ consultez la page Caractères spéciaux.


Tableaux

Les tableaux sont définis en délimitant les cellules avec '||'.

  • Une cellule dont le contenu a des espaces au début et à la fin, est centrée;
  • une cellule dont le contenu commence par des espaces est alignée à droite;
  • une cellule dont le contenu finit par des espaces est alignée à gauche.
  • Une cellule vide fera que la cellule précédente sera sur plusieurs colonnes. (Il n'y a pas de mécanisme pour faire fusionner plusieurs lignes)
  • Une ligne commençant par || indique les propriétés de tableau pour les tableaux suivants.
  • Un '!' comme premier caractère d'une cellule la met en emphase pour constituer au besoin les en-têtes.
||align=center border=1 width=50%
||! Exemple ||! d'en-têtes ||! de tableau ||
||!Gauche   ||  Centre     ||       Droite||
||A         ||     B       ||            C||
||  colonnes fusionnées  ||||             ||
Exempled'en-têtesde tableau
GaucheCentreDroite
ABC
colonnes fusionnées 

Voir Tableaux et Tableaux évolués pour plus d'information.


Vous n'avez pas trouvé ?

Voir Index des balises, Tableaux, Tableaux évolués, ou Liens.

<< Images | Index de la documentation | Index des balises >>


Traduction de PmWiki.TextFormattingRules Page originale sur PmWikiFr.TextFormattingRules - Référencé par
Dernières modifications:
PmWikiFr.TextFormattingRules: 15 octobre 2011 à 20h16
PmWiki.TextFormattingRules: 10 septembre 2011 à 18h08