====== AIDE à une PREMIERE UTILISATION de DokuWiki ======

----
===== Préambule =====
Cette aide a pour but de permettre la modification d'une page d'un site des Echanges de Savoirs dont l'adresse est du type :
https://xxxxxxxx.echanges-savoirs-tregor.fr
Tous les sites des Echanges de Savoirs ont été créés et initialisés par les administrateurs (Bernard et Olivier) à l'aide d'un outil logiciel qui s'appelle "DokuWiki". 

Pour modifier une page, il n'y a aucun logiciel à installer sur son PC. Il faut seulement avoir le droit de modifier une page. Et pour avoir le droit il faut donc s'identifier, c'est-à-dire se déclarer avec un nom d'utilisateur et un mot de passe. Le nom est : scribe; le mot de passe sera fourni par SMS.

===== Comment se déclarer en tant que scribe (écrivain) ? =====
Aller simplement tout en haut de la page et cliquer sur "<fc #ff0000>S'identifier</fc>". Une petite fenêtre s'ouvre et permet de taper le Nom d'utilisateur et le mot de passe. Et valider (en cliquant sur le bouton "<fc #ff0000>S'identifie</fc>r" juste en dessous). Vérifier alors que tout en haut à droite de la page le mot "<fc #ff0000>s'identifier</fc>" a été remplacé par "<fc #ff0000>Se déconnecter</fc>". Observer bien que dans la marge droite de la page il y 3 icônes grisées, l'une en-dessous de l'autre. La plus importante, utilisée souvent, est la première, celle représentée par une petite page écornée.

===== Comment modifier une page ? =====
Faire glisser la souris sur la première icône : apparaît alors une mini-fenêtre où il est indiqué en première ligne "<fc #ff0000>Modifier cette page</fc>". Cliquer dessus. Le contenu de la page passe alors en mode Edition et - oh surprise ! - le contenu n'est plus ce qu'il était en simple lecture de la page mais ce qu'il était lors de sa création en mode Edition. Dans ce mode, apparaît en haut du contenu une **barre de menu** avec une liste de boutons les uns à coté des autres. Passer (lentement) la souris sur chacun des boutons du menu e : s'ouvre alors pour chacun d'eux une toute petite fenêtre sur fond noire donnant une idée de sa signification.  En fait tous ces boutons servent à la mise en forme du document. Il faut donc tout d'abord taper le texte que l'on veut saisir. **La mise en forme se fera après**.

===== Comment taper du texte que l'on souhaite découper en plusieurs paragraphes ? =====
Il suffit de taper le texte souhaité. Pour commencer un nouveau paragraphe, il faut ajouter une ligne vide avant le nouveau paragraphe. **A tout moment il est possible de voir ce que cela donne en cliquant sur "<fc #ff0000>Enregistrer</fc>" (en bas à gauche). Pour revenir en mode édition, il faut aller cliquer dans la marge droite sur l'icône représentant une petite page écornée et grisée**.

===== Comment copier du texte venant d'ailleurs ou d'Internet ? =====
Le plus simple est d'utiliser la souris de la façon suivante : aller ailleurs (contenu d'un fichier Word ou autre, du texte sur une page sur Internet). Pour Internet, aller sur un autre onglet ou  en ajouter un (+). Une fois sur la page Internet, ou sur la page Word voulu, sélectionner le texte désiré : positionner la souris  au début  du texte à copier et maintenir le clic gauche de la souris enfoncé en déplaçant la souris à la fin du texte à copier puis relâcher. Enfoncer et maintenir la touche au clavier "**Ctrl**" et taper  la lettre "**C**" (**en même temps**). Revenir sur la page en édition et positionner la souris au bon endroit puis enfoncer et maintenir la touche "**Ctrl**"et taper la lettre "**V**"(**en même temps**). Le texte est alors copié et visible à l'endroit voulu. 

Remarque : Ne copier que du texte ! ... cela fonctionne bien ! Nous verrons plus loin comment copier des images.



===== Comment mettre en forme le texte d'une page ? =====
Principe général : sélectionner le texte voulu et cliquer sur le bouton adéquat de la barre de menu : 
  * Bouton B : **Gras** ;
  * Bouton //I//  :  //Italique// ;
  * Bouton U (souligner) :  __Soulignage__ .
  * Bouton A rouge (Font color) :   <fc #ff0000>cliquer sur la couleur désirée</fc>; cela donne une expression de la forme suivante :

    <fc #ff0000>cliquer sur la couleur désirée</fc>

 Nota : on peut cliquer en bas de page sur "Enregistrer" pour voir l'apparence finale.

===== Comment mettre un titre à un texte ou à un paragraphe ? =====
Pour ajouter un titre à un texte ou à un paragraphe il suffit de cliquer l'un des boutons "**H**" (Il y en a 4 !!). Apparaît alors une ligne avec des caractères === en nombre variable selon le niveau; remplacer alors l'expression "Titre de niveau" par  le titre souhaité.
  * Bouton **H** : titre de même niveau que le précédent titre de la page; 
  * Bouton **>H** : titre de niveau inférieur au précédent de la page;
  * Bouton **H<** : titre de niveau supérieur au précédent
  * Bouton **H avec flèche vers le bas** : apparaît alors un menu avec 5 boutons correspondant aux niveaux 1 à 5; cliquer sur le niveau souhaité.

On peut donc organiser l'ensemble d'une page en donnant des titres adéquats et appropriés au contenu souhaité.

===== Comment créer une nouvelle page ? =====
Le plus simple est de suivre le modèle suivant en utilisant les caractères "crochet gauche", "crochet droit" et "|" (ces caractères sont obtenues en appuyant en même temps sur la touche "**Alt Gr**") :

   [[nouvelle page | NOUVELLE PAGE]]
   
Ce qui donne (en cliquant en bas de page sur le bouton "**Enregistrer**") :
[[nouvelle page | NOUVELLE PAGE]]

L'expression NOUVELLE PAGE s'affiche en rouge. Cela veut dire que le lien vers la nouvelle page a été créé mais que cette page n'existe pas. Il suffit alors de cliquer sur cette expression rouge pour qu'une nouvelle page s'ouvre. Dans cette nouvelle page, qui indique  "Cette page n'existe pas encore", repérer dans la marge droite l'icône du crayon. En passant le curseur de la souris sur cette icône apparaît une mini-fenêtre : "Créer cette page". 

===== Comment créer un titre de page après création d'une nouvelle page ?  =====
La nouvelle page venant d'être créée (elle a pour titre : " Cette page n'existe pas encore"), cliquer dans la marge droite sur l'icône du crayon et cliquer sur "Créer cette page". Le contenu de la page s'ouvre alors en mode Edition avec la barre de menu en haut de page.
Cliquer sur le bouton "**H**". Une première ligne apparaît en haut de page avec la mention "Titre". La remplacer par le titre de page souhaité.

=====  Comment créer un lien vers une page déjà existante ? =====
Il suffit de cliquer sur le bouton de la barre de menu s'appelant "Lien interne". S'ouvre alors une mini-fenêtre avec la liste des pages déjà existantes. Cliquer sur la page désirée et le lien vers cette page sera créée. Ce lien est dans un format semblable à celui déjà vu pour créer une nouvelle page, par exemple :
   [[aide|AIDE CONCISE à l'UTILISATION de DokuWiki]]

===== Comment créer un lien vers un autre site internet ? =====
Cliquer sur le bouton de la barre de menu s'appelant "Lien externe". Cela donne :
  [[http://example.com|Lien externe]]

Remplacer l'expression "example.com" par l'adresse URL du site internet désiré et remplacer l'expression "Lien externe" par l'expression souhaité correspondant au site Internet choisi.

===== Comment créer une liste numérotée ?  =====
Etablir d'abord la liste en mettant un élément par ligne. Sélectionner l'ensemble de cette liste et cliquer sur le bouton s'appelant "Liste numérotée". Nota : on peut cliquer en bas de page sur "Enregistrer" pour voir l'apparence finale.

===== Comment créer une liste non numérotée (à puce) ? =====
Etablir d'abord la liste en mettant un élément par ligne. Sélectionner l'ensemble de cette liste et cliquer sur le bouton s'appelant "Liste à puce".  Nota : on peut cliquer en bas de page sur "Enregistrer" pour voir l'apparence finale.

===== Comment créer une ligne horizontale ? =====
Positionner le curseur de la souris à l'endroit voulu, par exemple pour délimiter deux paragraphes. Cliquer alors sur le bouton s'appelant "Ligne horizontale". Nota : on peut cliquer en bas de page sur "Enregistrer" pour voir l'apparence finale.

===== Comment importer une image ? =====
Positionner le curseur de la souris à l'endroit voulu. Cliquer sur la bouton de la barre de menu s'appelant "Ajouter des images ou autres fichiers". Une fenêtre "Sélection de fichiers" s'ouvre. Cliquer dans la colonne de droite sur le bouton "Sélection de fichiers". Rechercher dans  l'explorateur de fichiers le fichier image désiré et sélectionner-le. Eventuellemment le renommer dans la case suivante et valider l'envoi en cliquant sur le bouton "Envoyer". Puis appuyer sur le bouton "Terminer". Le fichier (avec suffixe : .jpg ou .png ...) apparaît alors dans la liste en-dessous. 
Cliquer sur l'image réduite de ce fichier. Apparaît alors une mini-fenêtre "Paramètres de lien" et faire les choix suivants :
  - Cible du lien : choisir "Aucun Lien"
  - Alignement : choisir ce que l'on veut en général "Centrer l'image"
  - Taille de l'image : choisir de préférence S (petite taille) ou M (Taille moyenne)

Puis cliquer sur le bouton "Insérer". Apparaît alors, non pas l'image -car nous sommes en mode Edition-  mais un texte entre double-parenthèses, par exemple de la forme :
  {{:img_plougrescant.jpg?nolink&200|}}
  
  
Nota : Pour voir l'image telle qu'elle sera visible, il faut cliquer en bas de page sur "Enregistrer". 

===== Comment importer un fichier ? =====
Positionner le curseur de la souris à l'endroit voulu. Cliquer sur la bouton de la barre de menu s'appelant "Ajouter des images ou autres fichiers". Une fenêtre "Sélection de fichiers" s'ouvre. Cliquer dans la colonne de droite sur le bouton "Sélection de fichiers". Rechercher dans  l'explorateur de fichiers le fichier désiré et sélectionner-le. Valider l'envoi en cliquant sur le bouton "Envoyer". Puis appuyer sur le bouton "Terminer". Le fichier (avec suffixe : .pdf ou .doc  ou .odt ...) apparaît alors dans la liste en-dessou. Cliquer alors sur le nom de ce fichier. Apparaît alors à l'emplacement où le curseur de la souris avait été placé un texte entre double-parenthèses, par exemple de la forme :
   {{ :aide-memoire_pour_optimiser_duree_de_vie_batterie.odt |}}

Nota : Pour voir le résultat tel qu'il sera visible, il faut cliquer en bas de page sur "Enregistrer".  Le lecteur pourra consulter ce document en cliquant sur le nom du fichier enregistré. 

===== Comment ajouter un caractère spécial ? =====
Après avoir positionné le curseur de la souris à l'endroit voulu, cliquer sur le bouton de la barre de menu "**Ω**" s'appelant "Caractères spéciaux". Cliquer sur le caractère spécial recherché. 


===== Conclusion =====
Ce document n'est pas exhaustif; son but est avant tout de permettre une prise en main de l'Editeur de Dokuwiki permettant ainsi la construction et la mise à jour de page internet aussi simplement que possible. Il existe un guide de mise en page (mentionné en haut de page avant la barre de menu) mais il est en anglais. Toutefois une version française existe à l'adresse suivante :
https://www.dokuwiki.org/fr:wiki:syntax