====== Notice du wiki ======
<WRAP tip>
FAITES VOS TESTS SUR LA [[guide:page_test|PAGE DE TESTS]]
</WRAP>

Sauf [[guide:pages à droit restreint|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 =====

A droite de chaque page, vous trouverez cette petite image :
{{:guide:editer4.png?nolink|}}

  * Le crayon pour permet de **modifier la page**, voir ci-dessous
  * L'horloge permet d'afficher **la liste des modifications** faites dernièrement sur la page en cours

  * **Derniers changements** (en haut à gauche dans la barre de navigation grise): pour avoir la liste des pages modifiées dernièrement

En haut à droite vous trouverez la fonction recherche dédiée au wiki. Par défaut, la recherche se fera avec le moteur de recherche externe. Pàur utiliser le moteur de recherche interne du wiki, vous devez sélectionner '''dans le wiki (moteur interne)''' dans le menu déroulant.


==== Pour modifier une page ====

  * Cliquez sur "Modifer cette page", ou sur un des petits boutons {{:guide:editer2.png?nolink|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.{{ :guide:balises.png?nolink |}}
  * Une fois que le résultat vous convient, remplissez le champ orangé "Résumé" en indiquant les modifications apportées et cliquer sur "Enregistrer".
{{ :guide:enregistrer.png?nolink |}}

==== Pour créer une page ====

Tout est expliqué en détail là: [[guide:creer_une_page|Créer une page]]

==== 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.


==== Images sur le wiki ====

Merci de les héberger sur le site pour assurer leur pérennité. Utilisez le lien "[[http://www.randonner-leger.org/forum/uploadimg.php|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 <sub>indice</sub> et <sup>exposant</sup>.

  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 ====

Utilisez l'instruction ci-dessous

  <WRAP clear></WRAP>

===== 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 : [[http://www.google.com|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:
<code>[[creer une page]]</code>

=== 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 [[creer une page|lien]] mène vers la page "creer une page". Code utilisé :
<code>Ce [[creer une page|lien]] mène vers la page "creer une page".</code>

Notes:

  * Les liens vers [[:guide:notice du wiki|des pages existantes]] apparaissent différemment de ceux pointant vers celles [[wiki:n'existant pas encore]].

=== 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": [[creer une page#bizarre ce systeme|bizarre ce systeme]]. Code utilisé :
<code>[[creer une page#bizarre ce systeme|bizarre ce systeme]].</code>

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 [[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]].

  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 [[serveurpartage|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}}]]

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


===== 3. Notes =====

<WRAP center round important 80%>
Le [[http://wiki.splitbrain.org/plugin:note|plugin notes]] a été utilisé sur le wiki. Il est désormais obsolète et remplacé par le [[https://www.dokuwiki.org/plugin:wrap|plugin Wrap]]
</WRAP>

<WRAP center round info 80%>
Les personnalisations possibles sont les suivantes 
<code>
<WRAP center round important 80%>
</code>
  * **Left** / **center** / **right** => pour aligner le bloc sur la page à gauche, au centre ou à droite
  * **Round** ou <del>rien</del> => pour des coins arrondis ou carrés
  * **group**, **box**, **info**, **top**, **important**, **help**, **download**, **todo** => pour le type de bloc (contextualise la petite icône et la couleur de votre bloc
  * **80%** => pour la largeur de votre bloc par rapport à la page
</WRAP>

==== Les différentes utilisations possibles ====

Avec le plugin Wrap, vous pouvez ajouter des notes telles que celles-ci:

=== Mettre un texte sur 2 colonnes ===

Utilisez les boutons 
{{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/toolbar/picker.png}} puis {{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/toolbar/column.png}}, pour obtenir :

<WRAP group>
<WRAP half column>
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla sit amet mattis ex. Etiam sollicitudin sem sed orci rutrum vulputate. Proin tortor tortor, dignissim commodo eleifend malesuada, euismod sed felis. Nam sit amet mauris sodales, sagittis ex vitae, rhoncus lectus. Nullam quis imperdiet dolor. Duis et condimentum magna, vitae dignissim dui. Phasellus dignissim euismod diam, id tempus justo laoreet ut. Nulla quis nisl elementum, sollicitudin libero vel, tristique tortor. Quisque eget nisi sit amet orci pretium laoreet sagittis vel nunc. 
</WRAP>

<WRAP half column>
Nullam convallis neque a lectus sollicitudin dapibus. Pellentesque ac orci sit amet libero fermentum facilisis. Ut varius quam eget lacus dignissim interdum nec in est. Donec in eros in nibh tempor ornare. Nulla porttitor in purus id malesuada. Mauris sed libero eu massa aliquam faucibus. Praesent lacinia a nisl quis gravida. Fusce tellus ipsum, condimentum porta posuere ut, pharetra vel lectus. Nunc at imperdiet purus, ut semper orci. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. In non feugiat massa, quis pharetra quam. Ut eu lacus ante. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. 
</WRAP>
</WRAP>

Avec le code suivant :

<code>
<WRAP group>
<WRAP half column>
Texte colonne 1
</WRAP>

<WRAP half column>
Texte colonne 2
</WRAP>
</WRAP>
</code>

=== Une note toute simple pour attirer l'attention ====

Utilisez les boutons 
{{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/toolbar/picker.png}} puis {{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/toolbar/box.png}}, pour obtenir :

<WRAP center round box 80%>
bloc simple
</WRAP>

Avec le code suivant :

<code>
<WRAP center round box 80%>
bloc simple
</WRAP>
</code>

=== Une note présentant une information ===

Utilisez les boutons 
{{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/toolbar/picker.png}} puis {{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/note/16/info.png}}, pour obtenir :

<WRAP center round info 80%>
bloc information
</WRAP>

Avec le code suivant :

<code>
<WRAP center round info 80%>
bloc information
</WRAP>
</code>

=== Une note pour donner une idée, un tuyau ===

Utilisez les boutons 
{{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/toolbar/picker.png}} puis {{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/note/16/tip.png}}, pour obtenir :

<WRAP center round tip 80%>
bloc astuce
</WRAP>

Avec le code suivant :

<code>
<WRAP center round tip 80%>
bloc astuce
</WRAP>
</code>

=== Une note pour attirer l'attention sur quelque chose de très important ===

Utilisez les boutons 
{{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/toolbar/picker.png}} puis {{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/note/16/important.png}}, pour obtenir :

<WRAP center round important 80%>
bloc important
</WRAP>

Avec le code suivant :

<code>
<WRAP center round important 80%>
bloc important
</WRAP>
</code>

=== Une note pour mettre en avant une aide  ===

Utilisez les boutons 
{{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/toolbar/picker.png}} puis {{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/note/16/help.png}}, pour obtenir :

<WRAP center round help 80%>
bloc aide
</WRAP>

Avec le code suivant :

<code>
<WRAP center round help 80%>
bloc aide
</WRAP>
</code>

=== Une note pour proposer un téléchargement ===

Utilisez les boutons 
{{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/toolbar/picker.png}} puis {{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/note/16/download.png}}, pour obtenir :

<WRAP center round download 80%>
bloc téléchargement
</WRAP>

Avec le code suivant :

<code>
<WRAP center round download 80%>
bloc téléchargement
</WRAP>
</code>

=== Une note pour attirer l'attention sur une chose à faire ===

Utilisez les boutons 
{{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/toolbar/picker.png}} puis {{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/note/16/todo.png}}, pour obtenir :

<WRAP center round todo 80%>
bloc à faire
</WRAP>

Avec le code suivant :

<code>
<WRAP center round todo 80%>
bloc à faire
</WRAP>
</code>

=== Rétablir le flux après un élément flottant ===

Si vous rencontrez un problème de mise en forme après l'utilisation d'un bloc WRAP, il vous faudra rétablir l'ordre du flux (caler à nouveau votre texte en bas à gauche) avec les boutons {{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/toolbar/picker.png}} puis {{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/toolbar/clear.png}}, pour obtenir le code suivant :
<code>
<WRAP clear/>
</code>

=== Mise en forme d'un texte ===

Le plugin WRAP permet enfin de mettre du texte en forme. Pour cela, utilisez les boutons 
{{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/toolbar/picker.png}} puis {{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/toolbar/em.png}}, {{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/toolbar/hi.png}} ou {{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/toolbar/lo.png}} pour obtenir les codes suivants  :


<wrap em>particulièrement important</wrap>

<wrap hi>important</wrap>

<wrap lo>peu important</wrap>

avec les code suivants :

<code>
<wrap em>particulièrement important</wrap>
<wrap hi>important</wrap>
<wrap lo>peu important</wrap>
</code>
===== 4. Note de bas de page =====

Vous pouvez ajouter des notes de bas de page ((Ceci est une note de bas de page)) 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 ''<nowiki>~~NOTOC~~</nowiki>'' 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 =====

<WRAP center alert 80%>
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.
</WRAP>

<WRAP center important 80%>
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...
</WRAP>

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

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

Pleine taille:         {{:p3rs:p3rs_stream.jpg|}}    {{wiki:php-powered.png}}

Redimensionnée en largeur (pixels) : {{:p3rs:p3rs_stream.jpg?50}}

Redimensionnée en L par H :  {{:p3rs:p3rs_stream.jpg?100x50}}

  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 :      {{http://de3.php.net/images/php.gif}}

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

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

{{:p3rs:p3rs_stream.jpg }}

{{ :p3rs: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):

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

  {{: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 listes ordonnées (1,2,3...).

  * 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à

<code>
  * 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à

</code>

===== 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.

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

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

===== 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        |

Pour fusionner horzontalement les cellules, créer une cellule vide comme ci-dessus. Attention à garder le bon nombre de séparateurs.

Les tableaux à 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''.

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

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

<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é.
</nowiki>

Cliquer sur éditer pour voir la syntaxe originale.



===== 12. Plugin WRAP =====

Le plugin [[https://www.dokuwiki.org/plugin:wrap|wrap]] a été installé, c'est un outil de mise en page très puissant.

Les principales fonctions sont accessibles en cliquant l’icône {{http://www.randonner-leger.org/wiki/lib/plugins/wrap/images/toolbar/picker.png?nolink}} sur la barre d'outils, lors des modifications de page.

Tous les détails (en anglais) ici : https://www.dokuwiki.org/plugin:wrap .