Aller au contenu

Outils du site

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


guide:notice_du_wiki

Notice du wiki

FAITES VOS TESTS SUR LA PAGE DE TESTS

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

A droite de chaque page, vous trouverez cette petite image :

  • 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 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”.

Pour créer une page

Tout est expliqué en détail là: 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 “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

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 : 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é utilisé sur le wiki. Il est désormais obsolète et remplacé par le plugin Wrap

Les personnalisations possibles sont les suivantes

<WRAP center round important 80%>
  • Left / center / right ⇒ pour aligner le bloc sur la page à gauche, au centre ou à droite
  • Round ou rien ⇒ 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

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 puis , pour obtenir :

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.

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.

Avec le code suivant :

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

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

Une note toute simple pour attirer l'attention

Utilisez les boutons puis , pour obtenir :

bloc simple

Avec le code suivant :

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

Une note présentant une information

Utilisez les boutons puis , pour obtenir :

bloc information

Avec le code suivant :

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

Une note pour donner une idée, un tuyau

Utilisez les boutons puis , pour obtenir :

bloc astuce

Avec le code suivant :

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

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

Utilisez les boutons puis , pour obtenir :

bloc important

Avec le code suivant :

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

Une note pour mettre en avant une aide

Utilisez les boutons puis , pour obtenir :

bloc aide

Avec le code suivant :

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

Une note pour proposer un téléchargement

Utilisez les boutons puis , pour obtenir :

bloc téléchargement

Avec le code suivant :

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

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

Utilisez les boutons puis , pour obtenir :

bloc à faire

Avec le code suivant :

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

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 puis , pour obtenir le code suivant :

<WRAP clear/>

Mise en forme d'un texte

Le plugin WRAP permet enfin de mettre du texte en forme. Pour cela, utilisez les boutons puis , ou pour obtenir les codes suivants :

particulièrement important

important

peu important

avec les code suivants :

<wrap em>particulièrement important</wrap>
<wrap hi>important</wrap>
<wrap lo>peu important</wrap>

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

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.

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…

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

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.

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.

12. Plugin WRAP

Le plugin 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 sur la barre d'outils, lors des modifications de page.

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

1)
Ceci est une note de bas de page
guide/notice_du_wiki.txt · Dernière modification: 2019/09/04 19:53 par Opitux