<WRAP round info 60%>
Pourquoi [[https://www.dokuwiki.org|DokuWiki]] ? Pour plusieurs raisons:
<WRAP column 30%>
  * opensource
  * sans base de données
  * modulaire
  * portable
  * gestion des ACL
  * mise à jour au clic
</WRAP>
<WRAP column 30%>
  * facile à déployer
  * facile à utiliser
  * complet pour mon usage
  * facilement bidouillable
  * une communauté active
</WRAP>
</WRAP>

====== Installation DokuWiki ======
Commencer par pointer un navigateur sur la [[https://download.dokuwiki.org/|page]] de téléchargement.\\
Customiser l'archive d'installation:
  * version stable
  * langue français en plus seulement
  * plugins: <color #ff7f27>Upgrade Plugin</color>

Cliquer sur //start download// en bas de page.\\
Nous avons une archive tar.gz du style <color #ff7f27>dokuwiki-*.tgz</color> dont l'extraction créée dossier <color #ff7f27>dokuwiki</color> que vous pouvez renommer à votre convenance, ou pas.\\
\\
Pointer navigateur sur <color #ff7f27>adresse/dokuwiki/install.php</color>\\
Choix de lalangue en haut à droite.\\
Nommez votre wiki.\\
Utiliser l'ACL pour la gestion des droits utilisateurs\\
Création d'un compte admin (champs email obligatoire, un mail bidon fera l'affaire)\\
Choisir la politique de contrôle d'accès initial.\\
Et choisir la licence de vos futurs contenus\\

Via FTP, supprimer <color #ff7f27>~/dokuwiki/install.php</color>\\

C'est tout. Se connecter en admin et commencer la configuration\\

====== Configuration ======
Utilisateurs:\\
Dans <color #ff7f27>Administrer/Gestion des utilisateurs</color>\\
Créer un user pour éditer le wiki (groupe user)\\

Extensions:\\
<color #ff7f27>Administrer /Gestionnaire d'extensions/Greffons installés</color>\\
Désactiver extensions, à votre convenance:
  * <color #ff7f27>authpdo plugin</color>
  * <color #ff7f27>Revert Manager</color>

<color #ff7f27>Administrer/Paramètres de configuration/Paramètres de base</color>\\
?
====== Personnalisation ======
===== Plugins =====
<color #ff7f27>Administrer /Gestionnaire d'extensions/Rechercher et installer</color>\\
==== Nécessaires ====
  * ACL Manager
  * Plain Auth Plugin
  * Configuration Manager
  * Extension Manager
  * User Manager
==== Système ====
  * DokuWiki Upgrade Plugin
  * Info Plugin
  * [[https://www.dokuwiki.org/plugin:loglog|Login/Logoff Logging]]: Journalisation des connexions;
  * safefnrecode plugin
  * discussion plugin
  * Popularity Feedback Plugin
==== Paramétrages ====
  * [[https://www.dokuwiki.org/plugin:indexmenu|IndexMenu]]: Menus de pages dynamiques (utile pour accueil) ;
  * [[https://www.dokuwiki.org/plugin:edittable|EditTable]]: Editer tableaux en WYSIWYG ;
  * [[https://www.dokuwiki.org/plugin:dw2pdf|DW2PDF]]: génération du PDF de la page courante ;
  * styling plugin
==== Mise en forme ====
  * [[https://www.dokuwiki.org/plugin:wrap|WRAP]]: enrichissement mise en forme (blocs, bulles, colonnes, div, CSS, positionnement… ;
  * [[https://www.dokuwiki.org/plugin:syntaxhighlighter4|SyntaxHighlighter4]]: boites de code colorées syntaxiquement;
  * [[https://www.dokuwiki.org/plugin:color|color]]: ajout balises couleur (texte et/ou fond) ;
  * [[https://www.dokuwiki.org/plugin:cellbg|Cell Background]]: la même chose pour les tableaux.
  * [[https://www.dokuwiki.org/devel:css#user_styles|Jouer avec les CSS]] via le fichier <color #ff7f27>conf/userstyle.css</color>
<WRAP left round help 60%>
discussion dans un tab ?
</WRAP>


===== Couleurs =====
Un thème sombre basé sur 4 couleurs: noir, blanc, gris et vert.\\
Cela se change dans <color #ff7f27>Paramètres/Paramètres de style du thème (template)</color>
| Couleur de texte principale | #eeeeee |
| Couleur de fond principale | #222222 |
| Couleur de texte alternative | #dddddd |
| Couleur de fond alternative | #444444 |
| Couleur de texte neutre | #cccccc |
| Couleur de fond neutre | #333333 |
| Couleur des contours | #008000 |
| Couleur de surbrillance (utilisée pincipalement pour les résultats de recherche) | #aaaa66 |
| Couleur du fond (derrière la boîte de contenu) | #000000 |
| Couleur générale des liens | #008000 |
| Couleur des liens pour les pages existantes | #008000 |
| Couleur des liens pour les pages inexistantes | #ff4433 |
| Largeur du site complet (dans une unité de longueur valide: %, px, em,...) |100% |
| Largeur de la barre latérale, si existante (dans une unité de longueur valide: %, px, em,...) | 15% |
| En dessous de cette largeur, le site passe en mode tablette. | 800px |
| En dessous de cette largeur, le site passe en mode smartphone | 480px |
ou via FTP:
<sxh text;title:/conf/tpl/dokuwiki/style.ini>
[replacements]
;These overwrites have been generated from the Template styling Admin interface
;Any values in this section will be overwritten by that tool again
__text__ = "#eeeeee"
__background__ = "#222222"
__text_alt__ = "#dddddd"
__background_alt__ = "#444444"
__text_neu__ = "#cccccc"
__background_neu__ = "#333333"
__border__ = "#008000"
__highlight__ = "#aaaa66"
__background_site__ = "#000000"
__link__ = "#008000"
__existing__ = "#008000"
__missing__ = "#ff4433"
__site_width__ = "100%"
__sidebar_width__ = "15%"
__tablet_width__ = "800px"
__phone_width__ = "480px"
</sxh>
On peut pousser le vice plus loin, en attribuant le même thème aux inputs, via userstyle.
<sxh CSS; title:conf/userstyle.css>
/* zone d'edition fond noir */
/* lib/tpl/dokuwiki/css/basic.less */
/* autour de la ligne 350 */
input,
textarea {
    color: #eeeeee;
    background-color: #444444;
}
/* scroll sur les wrap_scroll */
.dokuwiki div.wrap_scroll{
height: 400px;
overflow-y: scroll;
}
/* edittable fond noir */
.handsontable th, .handsontable td {
    color: #eeeeee;
    background-color: #444444;
}
</sxh>
==== WRAP ====
L'auteur du plugin permet de créer [[https://www.dokuwiki.org/plugin:wrap#extend_with_custom_styles|ses propres règles CSS]], excellent !\\
J'ai besoin d'une boite pour beaucoup de contenu, ou l'on pourrait scroller dedans:
Rajouter dans  <color #ff7f27>conf/userstyle.css</color> (à la racine de Dokuwiki)
<sxh css>
.dokuwiki div.wrap_scroll{
height: 400px;
overflow-y: scroll;
}
</sxh>
Et pour l'utiliser:
<sxh>
<WRAP scroll>
</WRAP>
<WRAP scroll 50%>
</WRAP>
<WRAP round scroll>
</WRAP>
</sxh>


====== Utilisation ======
===== Astuces =====
  * Pour toute nouvelle installation un dossier wiki est créé avec notamment la page <color #ff7f27>syntax</color>
  * LE dossier FTP des pages se trouve dans <color #ff7f27>adresse/data/pages/</color>
  * pour créer une hiérarchie de pages, créer des dossiers et y mettre les pages
  * FIXME : un plugin pour ça ?
  * XLS vers tableau dokuwiki, voir [[https://www.dokuwiki.org/tips:xls2wiki|xls2wiki]] (facilement hébergeable sur FTP) et/ou [[https://www.dokuwiki.org/tips:excel_macro|macro excel]]
===== Syntaxe =====
|caractères d’échappement|<nowiki>%%balise(s)%%</nowiki>|
|retour à la ligne|%%\\%%|
|en-tête tableau|%%^ colonne A ^ colonne B ^%%|
|ligne tableau|%%|ligne C|ligne D|%%|
|centrer cellule tableau|%%|  deux espaces de chaque côté  |%%|
|sxh poussé|%%<sxh CSS; highlight: 14,15; title:lib/tpl/dokuwiki/css/basic.less>%%|


====== Mise à jour de DokuWiki ======
Via l'excellent plugin DokuWiki Upgrade Plugin:
  - sauvegarde (complète ou dossier data + userstyle.css) ;
  - mettre à jour les extensions ;
  - lancer l'utilitaire dans <color #ff7f27>/Administrer/Extensions/Mise à jour du wiki</color>
  - suivre la procédure
Cela a modifié les fichiers suivants:
<sxh>
/VERSION sera mis à jour.
/doku.php sera mis à jour.
/inc/parser/code.php sera mis à jour.
/inc/parser/renderer.php sera mis à jour.
/inc/parser/xhtml.php sera mis à jour.
/install.php sera mis à jour.
/lib/tpl/dokuwiki/css/basic.less sera mis à jour.
</sxh>
Du coup remodifier le CSS comme expliqué ci-dessus.\\
Pour une upgrade de 3 versions, aucun problème, données, personnalisation et modules OK.