summaryrefslogtreecommitdiff
path: root/ikiwiki/formatting.mdwn
blob: a851930d1b38fc053c2760eb46c83a619850f520 (plain)

[[!meta title="Formater les pages"]] [[!meta robots="noindex, follow"]]

Sur ce wiki, la mise en forme du texte est semblable à celle utilisée dans les courriels. Ce style de formatage s'appelle [[MarkDown]]. Voici comment il fonctionne :

Lignes vides entre les paragraphes.

Texte en *italique* avec un astérisque ou texte en **gras** avec deux astérisques.

Une liste, chaque ligne commençant par un astérisque :

  • "* ma liste"
  • "* un autre élément"

Une liste numérotée, chaque ligne commençant par un chiffre (n'importe lequel), suivi d'un point :

  1. "1. première ligne"
  2. "2. deuxième ligne"
  3. "2. troisième ligne"

Un titre, une ligne commençant par un ou plusieurs caractères # suivis d'un caractère espace et du texte du titre. Le nombre de # détermine la taille du titre :

# h1

## h2

### h3

#### h4

##### h5
###### h6

Une règle horizontale, au moins trois tirets ou étoiles sur la même ligne :


Pour citer quelqu'un, faire précéder la citation de ">" :

To be or not to be, that is the question.

Un morceau de code, faire précéder chaque ligne par une tabulation ou quatre espaces :

10 PRINT "Hello, world!"
20 GOTO 10

Pour créer un lien avec une URL ou une adresse électronique, mettre l'URL entre crochets, <http://ikiwiki.info>, ou utiliser la forme [texte du lien](url)


En plus du formatage html élémentaire avec [[MarkDown]], ce wiki offre d'autres possibilités :

  • Pour créer un lien vers une autre page du wiki, mettre le nom de la page entre deux paires de crochets. Ainsi, utilisez \[[WikiLink]] pour un lien avec [[WikiLink]].

[[!if test="enabled(smiley) and smileys" then="""

  • Insérer des [[smileys]] et d'autres symboles très utiles :-) """]]

[[!if test="enabled(shortcut) and shortcuts" then="""

  • Utiliser des [[shortcuts]] pour renvoyer à des ressources communes.

    [[!wikipedia War_of_1812]] """]]

[[!if test="enabled(template) and templates" then="""

  • Créer et utiliser des modèles ([[templates]]) pour répéter des morceaux de texte standard. """]]

Insérer diverses [[directives|directive]] sur une page pour modifier cette page. [[!if test="enabled(toc) or enabled(meta) or enabled(inline)" then=""" Par exemple, vous pouvez : """]]

[[!if test="enabled(toc)" then="""

  • ajouter une table des matières sur une page :

    [[!toc]] """]]

[[!if test="enabled(meta)" then="""

  • changer le titre d'une page :

    [[!meta title="titre complet de la page"]] """]]

[[!if test="enabled(inline)" then="""

  • créer un blog en enchaînant un ensemble de pages (directive « inline ») :

    [[!inline pages="blog/*"]] """]]

[[!if test="enabled(listdirectives)" then=""" Voici la liste complète des directives activées sur ce wiki : [[!listdirectives ]] """]]