====== Aide à la prise en main du WIKI ======
Le wiki est un espace de publication ou chacun peut laisser (ou mettre à jour) une documentation sur le sujet voulu. Toutes les pages sont modifiables à souhait par n'importe qui. Il convient donc de respecter une mise en page et une syntaxe précise, afin que chacun s'y retrouve. Ce document reprend les differentes tâches possibles point par point:
====== Se connecter/ se deconnecter ======
On peut lire les pages sans être connecté mais pour avoir le droit de les modifier, il faut s'authentifier grace à son login et son mot de passe. Les logins et mots de passe sont ceux de la messagerie unifiée. Pour se connecter, il suffit de cliquer sur le bouton "Login" en bas à droite.
Pour se déconnecter, il suffit de cliquer sur le bouton "Logout" qui à remplacé le bouton "Login" lors de la connexion.
====== Modifier les pages ======
Une fois authentifié, vous voyez apparaître des boutons "Editer" et "Editer la page", qui vous servirons à accéder au code des pages pour les modifier.
Vous avez la possibilité, avant de modifier une page visible par tous, de vous exercer sur le « [[wiki:playground|bac à sable]] ».
Pour mettre en forme vos pages vous pouvez utilisez les boutons qui sont dans la barre de menu mais il y de nombreuses autre possibilités:
===== Mise en page de texte basique =====
Bien sur vous pouvez mettre votre texte en **gras**,en //italique//,le s__ouligner__,ou ''réduire l'espacement'' avec respectivement les autres premiers boutons de la barre de menu.
Vous pouvez aussi mettre du texte en **indice** avec les balises ou en **exposant** avec les balises :
exemple: indice and exposant
code : indice et sexposant
Vous pouvez aussi le** rayer** avec les balises .
exemple: indice
code : indice
Pour changer de **paragraphe** il suffit de laisser une ligne vide entre les deux.
Pour écrire dans un encadré, il suffit de ne pas commencer le début du paragraphe au bord du cadre mais de se décaler avec un ou deux espaces.
Pour sauter des lignes, il faut commencer la ligne par "\\" (alt Gr et -), mais cela est à utiliser avec prudence.
===== Liens =====
DokuWiki comporte plusieurs facon de faire des liens
==== liens externe ====
Pour faire un lien externe, cliquez sur 6 ème case en partant de la fin du menu, et remplacez "lien externe " par les mots qui supportent le lien et "%%http://www.example.com%%" par l'adresse du lien.
==== Lien interne====
Pour faire un lien interne, vous avez deux possibilités : soit le texte qui supporte le lien est le nom de la page dans le quel cas il suffit de cliquer sur le bouton de lien interne et de remplacer "Lien interne" par le nom de la page. Soit le texte qui supporte le lien est différent du nom de la page et alors il vous faut rajouter un tube '`|' ( Alt GR et - )
exemple : [[playground]] , [[playground|bac à sable]]
==== lien sur une image ====
Pour faire un lien sur une image, il faut procéder de la même manière. Vous placez le curseur à la place convenue et vous insérez l'image voulue.
Attention, un lien ne peut se faire que sur une image au format png. Sinon le nom de l'image s'affichera à la place de celle-ci.
===== note de pied de page =====
Pour mettre une note en pied de page il suffit de mettre le texte de la note entre une double parenthèse. Alors un numéro correspondant à la note apparaîtra dans le texte et la note en fin de page.
Exemple: ((ceci est une note de pied de page)) voir à la fin de la page
===== titre de paragraphe =====
Vous avez la possibilité de faire cinq titres différents, l'indentation se fera toute seule, vous ne pouvez donc pas imbriquer plus de cinq paragraphes. Pour en mettre d'avantage vous pouvez utiliser le tirer -- --
====== titre numéro 1 ======
%%====== titre numéro 1 ======%%
===== titre numéro 2 =====
%%===== titre numéro 2 =====%%
==== titre numéro 3 ====
%%==== titre numéro 3 ====%%
=== titre numéro 4 ===
%%=== titre numéro 4 ===%%
== titre numéro 5 ==
%%== titre numéro 5 ==%%
===== Image =====
Vous avez la possibilité de régler la taille des images. Pour cela, il faut modifier un peu la ligne de commande qui s'affiche lors de l'insertion d'une image:
- taille réelle : {{wiki:nom de l'image?}}
exemple:{{wiki:php-powered.png?}}
- régler avec des pourcentages: {{wiki:nom de l'image?100}}
exemple: {{wiki:php-powered.png?100}}
- régler avec des dimensions : {{wiki:nom de l'image?100}}
exemple: {{wiki:php-powered.png?100}}
- régler une image externe (qui n'est pas dans la base d'image du Dokuwiki) :{{adresse de l'image?100x100}}
exemple: {{http://de3.php.net/images/php.gif?100x100}}
Vous avez également la possibilité de faire afficher un message lorsque la souris reste sur une image, pour cela il faut rajouter « |This is the caption}} » après le nom de l'image.
Exemple : {{ wiki:php-powered.png |C'est la légende}} ou {{ wiki:php-powered.png?100 |C 'est la légende}}
===== Listes =====
Pour créer des listes, il suffit de cliquer sur le bouton voulu selon que la liste est numérotée ou pas; si elle l'est, et que vous voulez imbriquer des listes, il vous suffit de marquer le décalage et la numérotation s'adapte.
Exemple:
Dokuwiki supports ordered and unordered lists. To create a list item intend your text by two spaces and use a ''*'' for unordered lists or a ''-'' for ordered ones.
* C'est une liste
* c'est le second item
* un nouveau niveau
* un autre item
- la même liste
- une autre item
- une indentation
- un autre item
code :
* C'est une liste
* c'est le second item
* un nouveau niveau
* un autre item
- la même liste
- une autre item
- une indentation
- un autre item
===== Les Smileys =====
Vous avez la possibilité d'introduire des smileys dans le texte, il suffit de les taper, quelques exemples:
* 8-) %% 8-) %%
* 8-O %% 8-O %%
* :-( %% :-( %%
* :-) %% :-) %%
* =) %% =) %%
* :-/ %% :-/ %%
* :-\ %% :-\ %%
* :-? %% :-? %%
* :-D %% :-D %%
* :-P %% :-P %%
* :-O %% :-O %%
* :-X %% :-X %%
* :-| %% :-| %%
* ;-) %% ;-) %%
* ^_^ %% ^_^ %%
* :?: %% :?: %%
* :!: %% :!: %%
* LOL %% LOL %%
* FIXME %% FIXME %%
* DELETEME %% DELETEME %%
===== Typographie =====
Vous avez la possibilité d'insérer des symbole comme des flèches, des copyrights, etc:
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
code:
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
===== Tables =====
DokuWiki utilise une syntaxe simple pour les tableaux :
**
Pour faire un tableau à simple entrée:**
Pour avoir une ligne « titre » qui sera sur un fond bleue , il faut séparer les titre par des '^'.
Les colonnes sont elles séparées par des '|' ( caractère qui s'obtient en appuyant simultanément sur les touches « Alt Gr » et « - »
Pour fusionner deux colonnes il faut déplacer la barre de fin de la première colonne juste avant la barre de fin de la deuxième.
exemple:
^ titre 1 ^ titre 2 ^ titre 3 ^
| ligne 1 Col 1 | ligne 1 Col 2 | ligne Col 3 |
| ligne 2 Col 1 | deux cases fusionnées (utilisation d'une double barre) ||
| ligne 3 Col 1 | ligne 2 Col 2 | ligne 2 Col 3 |
code :
^ titre 1 ^ titre 2 ^ titre 3 ^
| ligne 1 Col 1 | ligne 1 Col 2 | ligne Col 3 |
| ligne 2 Col 1 | deux cases fusionnées (utilisation d'une double barre) ||
| ligne 3 Col 1 | ligne 2 Col 2 | ligne 2 Col 3 |
**Pour faire un tableau double entrées:**
Il faut utiliser la même méthode :
- Pour la case vide en haut à gauche la faire démarrer par une barre et finir par un '^' .
- Pour les titres sur les cotés, de la même manière les écrire entre '^'.
exemple:
| ^ titre 1 ^ titre 2 ^
^ titre 3 | ligne 1 Col 2 | ligne 1 Col 3 |
^ titre 4 | lign 2 col 2 | |
^ titre 5 | ligne 3 Col 2 | ligne 3 Col 3 |
code :
| ^ titre 1 ^ titre 2 ^
^ titre 3 | ligne 1 Col 2 | ligne 1 Col 3 |
^ titre 4 | lign 2 col 2 | |
^ titre 5 | ligne 3 Col 2 | ligne 3 Col 3 |
===== blocs non analysés=====
Pour mettre un texte sans qu'il soit analysé (un code par exemple), il suffit de le placer entre deux %%,
ou de mettre au moins deux espaces devant, ou de les placer entre les balises %%
%%, %%%%, %%%%
exemples:
%%http://www.example.com%% => %%http://www.example.com%%
%%http://www.example.com%% => http://www.example.com
%%http://www.example.com
%% => http://www.example.com
%%http://www.example.com%% => http://www.example.com
===== mettre en evidence la syntaxe =====
Pour faire ressortir la syntaxe d'un code, mettre en couleur les mots clefs, il faut placer le code
entre des balises %%
%%.
Les langages reconnus sont : actionscript, ada, apache, asm, asp, bash, caddcl, cadlisp, c, cpp, css, delphi, html4strict, java, javascript, lisp, lua, nsis, oobas, pascal, perl, php-brief, php, python, qbasic, sql, vb, visualfoxpro, xml
exemple avec %%%%...%%
%% :
/**
* The HelloWorldApp class implements an application that
* simply displays "Hello World!" to the standard output.
*/
class HelloWorldApp {
public static void main(String[] args) {
System.out.println("Hello World!"); //Display the string.
}
}
===== Emboiter du HTML et du PHP =====
Vous pouvez mettre du code HTML ou PHP en entourant le code des balises correspondantes soit
%% et %%
exemple:
ceci ecrira le texte qui suit en rouge
code HTML:
ceci ecrira le texte qui suit en rouge
echo 'A logo generated by PHP:';
echo '
';
code PHP:
echo 'A logo generated by PHP:';
echo '
';
====== Historique ======
Vous avez la possibilité de voir toutes les modifications d'une page en cliquant sur " Anciennes révisions ". Vous aurez alors accès à la liste des différentes versions qui ont pu être en ligne.
====== Exporter ======
Vous avez la possibilité d'exporter une page au format PDF, ceci afin de la conserver sur votre disque dur ou de l'imprimer.
====== Derniers changements ======
Vous pouvez aussi visualiser les derniers changements qui ont été effectués sur l'ensemble des documents.
====== Recherche ======
Le DokuWiki possède un moteur de recherche, il vous suffit donc de taper votre requête dans l'emplacement vide prévu à cette effet et de cliquez sur le bouton "Rechercher".
====== Créer une nouvelle page ======
Pour créer une page, il faut d'abord vérifier qu'elle n'existe pas : pour cela ,tapez un mot clé dans le moteur de recherche et si il ne la trouve pas alors vous disposez d'une case en bas a gauche « créer cette page ».