Aller au contenu

Outils du site

Vous n'êtes pas identifié(e).


guide:guide_de_mise_en_page

Ceci est une ancienne révision du document !


Syntaxe

<box round|Objectif>Cette page recense l'ensemble des raccourcis typographiques que vous pouvez utiliser pour l'édition des pages du wiki.</box> Vous pouvez facilement voir la forme brute de cette page en cliquant sur Editer cette page qui se trouve en haut et en bas de page. Si vous voulez expérimenter et vous perfectionner, utilisez la page_test. Ci dessous vous trouverez des exemples du texte une fois publié, suivi de celui-ci tel qu'il a été saisi (dans un encadré pointillé).

<note warning>Merci de ne contribuer qu'en apportant vos propres oeuvres ou celles issues d'une source libre de droits. N'UTILISEZ PAS DE TRAVAUX SOUMIS AUX DROITS D'AUTEUR SANS AUTORISATION EXPRESSE!</note>

1. Edition simple de texte

DokuWiki accepte les mises en forme suivantes : gras, italique, souligné et chasse fixe. Bien sûr, vous pouvez combiner ces mises en formes.

DokuWiki accepte les mises en forme suivantes : **gras**, //italique//, __souligné__ et ''chasse fixe''. 
Bien sûr, vous pouvez     **__//''combiner''//__** ces mises en formes.

Vous pouvez aussi utiliser indice et exposant.

Vous pouvez aussi utiliser <sub>indice</sub> et <sup>exposant</sup>.

Pour créer un paragraphe, il vous suffit d'insérer une ligne vide.

Si vous voulez simplement insérer un retour à la ligne, utilisez deux backslash (altgr + 8) suivi d'un espace ou d'un retour à la ligne.

Ceci est un texte avec un retour à la ligne.
Noter que le double backslash n'est reconnu qu'à la fin d'une ligne
ou s'il est suivi par un espace .

Ceci est un texte avec un **retour à la ligne**.\\
Noter que le double backslash n'est reconnu qu'à la fin d'une ligne\\ ou s'il est suivi par un espace .

D'une manière générale, utilisez cette option avec parcimonie.

Retour à la ligne après un élément flottant

Le plugin clearfloat a été installé, il permet de forcer un retour à la ligne après un élément flottant: image, boite colorée (voir paragraphe 12), etc. Utilisez l'instruction ci-dessous

~~CL~~

2. Liens

DokuWiki permet plusieurs options pour créer un lien.

Liens externes

Les liens externes sont reconnus automatiquement : http://www.google.com ou simplement www.google.com - Vous pouvez nommer vos liens : Ce lien pointe vers Google. Pour les adresses email: oli_v_ier@yahoo.fr est reconnu.

Les liens externe sont reconnus automatiquement : http://www.google.com ou 
simplement www.google.com - Vous pouvez nommer vos liens : 
[[http://www.google.com|Ce lien pointe vers Google]]. Pour les adresses email:
<oli_v_ier@yahoo.fr> est reconnu.

Liens internes

Les liens internes sont ceux renvoyant à d'autres pages de ce site.

Les liens internes simples

Ils sont créés simplement rajoutant des doubles crochets autour du nom de la page. Exemple: un lien vers la page nommée “creer une page”: creer une page. Voici le code utilisé pour créer ce lien:

[[creer une page]]

Changer les mots du lien

Si l'on veut que les mots du lien soient différents du nom de la page, il suffit de rajouter le symbole “|” et les mots voulus pour le lien. Exemple: Ce lien mène vers la page “creer une page”. Code utilisé :

Ce [[creer une page|lien]] mène vers la page "creer une page".

Notes:

Les liens vers le paragraphe d'une page

Les liens vers le paragraphe d'une page sont également possibles. Ajouter le nom du paragraphe au lien à l'aide d'un dièse “#”. Exemple pour créer un lien vers le paragraphe “bizarre ce systeme” de la page “creer une page”: bizarre ce systeme. Code utilisé :

[[creer une page#bizarre ce systeme|bizarre ce systeme]].

Notes:

  • Quand le titre d'un paragraphe est modifié, les liens relatifs à cet paragraphe ne fonctionneront plus, il est donc préférable d'éviter d'y recourir.

Interwiki

DokuWiki permet de créer les liens wiki:interwiki. Ils s'agit de liens rapides vers d'autres wikis. Ce lien vers la page de Wikipedia sur les wikis: Wiki.

DokuWiki permet de créer les liens [[doku>wiki:interwiki]]. Ils s'agit de
liens rapides vers d'autres wikis. Ce lien vers la page de Wikipedia sur les 
wikis: [[wp>Wiki]].

Partage Windows

Les partages réseau sous Windows fichier sont reconnus. Ces liens sont donc réservés à une application wiki sur un intranet ou un réseau local.

Les partages réseau sous Windows [[serveurpartage|fichier]] sont reconnus.

Liens illustrés

Vous pouvez également illustrer vos liens par une image de la manière suivante :

[[http://www.php.net|{{wiki:php-powered.png}}]]

3. Notes

Le plugin notes a été ajouté, vous pouvez ajouter des notes telles que celles-ci:

<note>Une note toute simple pour attirer l'attention.</note> donne:

<note>Une note toute simple pour attirer l'attention: on utilise

<note> texte </note>

</note>

<note important>Une note importante</note> donne:

<note important>Une note importante: on utilise

<note important> texte </note>

</note>

<note warning>Note pour attirer l'attention sur quelque chose de très important</note> donne:

<note warning>Note pour attirer l'attention sur quelque chose de très important: on utilise

<note warning> texte </note>

</note>

<note tuyau>Une note pour donner une idée, un tuyau.</note> donne:

<note tuyau>Une note pour donner une idée, un tuyau: on utilise

<note tuyau> texte </note>

</note>

4. Note de bas de page

Vous pouvez ajouter des notes de bas de page 1) en utilisant la double parenthèse.

Vous pouvez ajouter des notes de bas de page ((Ceci est une note de bas de page))

5. Sections

Vous pouvez utiliser jusqu'à 5 niveaux de hiérarchisation pour le contenu du wiki. Si vous avez plus de 3 chapitres, une table des matière est générée automatiquement – Cette fonction peut être désactivée en utilisant la commande suivante ~~NOTOC~~ dans le document.

Titre de niveau 3

Titre de niveau 4

Titre de niveau 5
==== Titre de niveau 3 ====
=== Titre de niveau 4 ===
== Titre de niveau 5 ==

en utilisant 4 tirets (touche 6) vous pouvez insérer une ligne horizontale:


6. Images et autres fichiers

<note warning>Attention à n'utiliser que vos images ou des images libres de droit. Une certaine tolérance est appliquée aux images de matériel récupérées sur les sites des fabricants, mais à tout moment il peut être demandé de les retirer.</note>

<note important>Attention au poids de vos images, surtout si elles sont téléchargées sur le wiki:

  • Réduisez la taille de l'image en la recadrant: 300 pixels de large/haut suffisent généralement, faire un lien vers une image plus grande si nécessaire,
  • Réduisez le poids de l'image en la compressant (en format jpeg par exemple): 20ko c'est bien, 50ko ça commence à faire, 100ko c'est beaucoup…

</note>

Vous pouvez insérer des images de la manière suivante :

Pour des images hébergées sur le serveur du site :

Pleine taille:

Redimensionnée en largeur (pixels) :

Redimensionnée en L par H :

Pleine taille:             {{wiki:php-powered.png}}
Redimensionnée en largeur (pixels) : {{wiki:php-powered.png?100}}
Redimensionnée en L par H :  {{wiki:php-powered.png?100x100}}

Pour des images avec lien sur un autre site :

Pleine taille :

Redimensionnée :

Pleine taille :      {{http://de3.php.net/images/php.gif}}
Redimensionnée : {{http://de3.php.net/images/php.gif?100x100}}

En utilisant un espace avant ou après vous pouvez aligner à droite, à gauche, pour centrer simplement insérer un espace avant et après :

{{ wiki:php-powered.png}}
{{wiki:php-powered.png }}
{{ wiki:php-powered.png }}

Et bien sûr vous pouvez ajouter une légende, toujours selon la même logique (qui sera affichée comme infobulle par la plupart des navigateurs):

Légende

{{ wiki:php-powered.png |Légende}}

Si vous spécifiez un lien (externe ou interne) qui n'est pas une image (gif,jpeg,png) celui-ci sera affiché comme un lien de téléchargement.

7. Listes

Dokuwiki permet de créer facilement des listes ordonnées ou non. Pour créer un e liste, insérez deux espaces et ajouter * pour les listes non-ordonnées (points) ou un - pour les lites ordonnées (1,2,3…).

  • Ceci est une liste
  • Deuxième item
    • Vous pouvez insérer des sous niveau avec deux espaces
  • Autre item
  1. Même liste mais ordonnée
  2. Autre item
    1. Indentez de deux espace pour descendre d'un niveau
  3. Et voilà
  * Ceci est une liste
  * Deuxième item
    * Vous pouvez insérer des sous niveau avec deux espaces
  * Autre item

  - Même liste mais ordonnée
  - Autre item
    - Indentez de deux espace pour descendre d'un niveau
  - Et voilà

8. Emoticones

DokuWiki remplace les emoticones les plus utilisées par leur équivalent graphique. Voici un aperçu de ceux disponibles :

  • 8-) 8-)
  • 8-O 8-O
  • :-( :-(
  • :-) :-)
  • =) =)
  • :-/ :-/
  • :- :-
  • :-? :-?
  • :-D :-D
  • :-P :-P
  • :-O :-O
  • :-X :-X
  • :-| :-|
  • ;-) ;-)
  • ^_^ ^_^
  • :?: :?:
  • :!: :!:
  • LOL LOL
  • FIXME FIXME
  • DELETEME DELETEME

9. Typographie

DokuWiki Peut convertir des caractères simple en leur équivalent typographique. Voici un exemple des caractères reconnus.

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “He thought 'It's a man's world'…”

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."

10. Tableaux

DokuWiki offre une syntaxe très simple pour créer des tableaux grâce au caractère “pipe” (altgr+6).

Titre 1 Titre 2 Titre 3
Ligne 1 Colonne 1 Ligne 1 Colonne 2 Ligne 1 Colonne 3
Ligne 2 Colonne 1 Une fusion de ligne (notez le double pipe)
Ligne 3 Colonne 1 Ligne 2 Colonne 2 Ligne 2 Colonne 3

Les lignes d'un tableau doivent commencer et finir par un pipe | et par un ^ pour les titres.

^ Titre 1      ^ Titre 2       ^ Titre 3          ^
| Ligne 1 Colonne 1    | Ligne 1 Colonne 2     | Ligne 1 Colonne 3        |
| Ligne 2 Colonne 1    | Une fusion de ligne (notez le double pipe) || 
| Ligne 3 Colonne 1    | Ligne 2 Colonne 2     | Ligne 2 Colonne 3        |

To connect cells horizontally just make the next cell completely empty as shown above. Be sure to have always the same amount of cell separators!

Les tableaux a double entrée sont aussi bien sûr possibles.

Titre 1 Titre 2
Titre 3 Ligne 1 Colonne 2 Ligne 1 Colonne 3
Titre 4 no colspan this time
Titre 5 Ligne 2 Colonne 2 Ligne 2 Colonne 3

Comme vous pouvez le remarquer, c'est le séparateur de la cellule qui conditionne le formatage du tableau :

|              ^ Titre 1            ^ Titre 2          ^
^ Titre 3    | Ligne 1 Colonne 2          | Ligne 1 Colonne 3        |
^ Titre 4    | no colspan this time |                    |
^ Titre 5    | Ligne 2 Colonne 2          | Ligne 2 Colonne 3        |

Note : la fusion de colonnes n'est pas possible.

11. Eléments bruts

Vous pouvez inclure des éléments qui ne seront pas traité par le processeur syntaxique du Wiki en incluant deux espaces en début de ligne ou en utilisant la balise code ou file.

Ceci est un exemple de code <a href="http://www.km-fr.com">km-fr.com</a>
<file>
Vous pouvez utiliser cette balise pour faire réference à un fichier externe.  
</file>

Pour forcer le processeur syntaxique à ignorer complètement un passage, utiliser soit la balise nowiki, %%.

Ceci est un passage qui n'est pas pris en compte par le processeur syntaxique http://www.splitbrain.org et **gras** auquel aucun formatage n'est appliqué.

Cliquer sur éditer pour voir la syntaxe originale.

13. Boites colorées

Le plugin boxes a été installé, il permet d'insérer des boites colorées dont on peut choisir:

  • la couleur : bleue, rouge, vert ou orange (blue , red , green , orange)
  • la forme (coins carrés ou arrondis): carrés par défaut, round pour les bords arrondis
  • la taille (en pourcentage de la largeur): 20%, 57%, etc
  • l'alignement (gauche, droite, centré): left, right, centré par défaut
  • le titre: chaque boite peut avoir son propre titre, voir exemple ci-dessous.

Exemple: <box 60% round orange left |Mettre ici le titre de la boite>Une boite orange alignée à gauche, à coins arrondis qui fait 60% de la largeur de la page, avec un titre</box> ~~CL~~

<box 60% round orange left |Mettre ici le titre de la boite>Une boite orange alignée à gauche, à coins arrondis qui fait 60% de la largeur de la page, avec un titre</box>

Autres exemples sur ce lien: http://wiki.jalakai.co.uk/dokuwiki/doku.php/test/boxes

1)
Ceci est une note de bas de page
guide/guide_de_mise_en_page.1317861188.txt.gz · Dernière modification: 2015/10/06 03:34 (modification externe)