Aller au contenu

Outils du site

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


guide:notice_du_wiki

Ceci est une ancienne révision du document !


Notice du wiki

Sauf exception, toutes les pages du wiki sont modifiables par les membres connectés au site.

Chaque modification est archivée, il est toujours possible de revenir à une version antérieure en cas d'erreur ou de vandalisme.

Utilisation basique

En haut et bas de page, vous trouverez les 2 liens suivants:

  • Modifier cette page: pour modifier la page, voir ci-dessous
  • Anciennes révisions: permet d'afficher la liste des modifications faites dernièrement sur la page en cours
  • Derniers changements (en haut à droite): pour avoir la liste des pages modifiées dernièrement

En haut à droite vous trouverez la fonction recherche dédiée au wiki.

Pour modifier une page

  • Cliquez sur “Modifer cette page”, ou sur un des petits boutons Editer présent en bas à droite des paragraphes.
  • Le code source s'affiche avec des caractères spéciaux comme '=' ou '*' (voir exemples ci-dessous), ils permettent de baliser le texte pour le mettre en forme. Servez vous de la barre d'outil en haut de la zone d'édition pour mettre en forme le texte, ou ajouter des images, puis cliquez sur “Aperçu” pour voir l'effet produit.
  • Une fois que le résultat vous convient, remplissez le champ orangé “Résumé” en indiquant les modifications apportées et cliquer sur “Enregistrer”.

Exemples de mises en forme

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

Le code source correspondant:

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

Insertion des images sur le wiki

Merci de les héberger sur le site pour assurer leur pérennité. Utilisez le lien “Envoyer une image” dans le menu du haut du forum.











Utilisation avancée

Vous trouverez ci-dessous l'ensemble des balises et des paramétrages que vous pouvez utiliser pour l'édition des pages du wiki.

N'hésitez pas à utiliser la page_test pour vous exercer. Ci dessous vous trouverez des exemples du texte une fois publié, suivi de celui-ci tel qu'il a été saisi dans le code source (dans un encadré pointillé).

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) : p3rs_stream.jpg

Redimensionnée en L par H : p3rs_stream.jpg

Pleine taille:             {{:p3rs:p3rs_stream.jpg}}
Redimensionnée en largeur (pixels) : {{:p3rs:p3rs_stream.jpg?100}}
Redimensionnée en L par H :  {{:p3rs:p3rs_stream.jpg?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 :

p3rs_stream.jpg

p3rs_stream.jpg

p3rs_stream.jpg

{{ :p3rs:p3rs_stream.jpg}}
{{:p3rs:p3rs_stream.jpg }}
{{ :p3rs:p3rs_stream.jpg }}

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

{{ :p3rs:p3rs_stream.jpg |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.

Par défaut les images sont cliquables pour afficher les informations liées. En ajoutant ?nolink on supprime ce lien.

p3rs_stream.jpg

{{:p3rs:p3rs_stream.jpg?nolink}}

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/notice_du_wiki.1334153257.txt.gz · Dernière modification: 2012/04/11 16:07 par oli_v_ier