Outils pour utilisateurs

Outils du site


Panneau latéral

autohebergement:dokuwiki

Pourquoi DokuWiki ? Pour plusieurs raisons:

  • opensource
  • sans base de données
  • modulaire
  • portable
  • gestion des ACL
  • mise à jour au clic
  • facile à déployer
  • facile à utiliser
  • complet pour mon usage
  • facilement bidouillable
  • une communauté active

Installation DokuWiki

Commencer par pointer un navigateur sur la page de téléchargement.
Customiser l'archive d'installation:

  • version stable
  • langue français en plus seulement
  • plugins: Upgrade Plugin

Cliquer sur start download en bas de page.
Nous avons une archive tar.gz du style dokuwiki-*.tgz dont l'extraction créée dossier dokuwiki que vous pouvez renommer à votre convenance, ou pas.

Pointer navigateur sur adresse/dokuwiki/install.php
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 ~/dokuwiki/install.php

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

Configuration

Utilisateurs:
Dans Administrer/Gestion des utilisateurs
Créer un user pour éditer le wiki (groupe user)

Extensions:
Administrer /Gestionnaire d'extensions/Greffons installés
Désactiver extensions, à votre convenance:

  • authpdo plugin
  • Revert Manager

Administrer/Paramètres de configuration/Paramètres de base
?

Personnalisation

Plugins

Administrer /Gestionnaire d'extensions/Rechercher et installer

Nécessaires

  • ACL Manager
  • Plain Auth Plugin
  • Configuration Manager
  • Extension Manager
  • User Manager

Système

  • DokuWiki Upgrade Plugin
  • Info Plugin
  • Login/Logoff Logging: Journalisation des connexions;
  • safefnrecode plugin
  • discussion plugin
  • Popularity Feedback Plugin

Paramétrages

  • IndexMenu: Menus de pages dynamiques (utile pour accueil) ;
  • EditTable: Editer tableaux en WYSIWYG ;
  • DW2PDF: génération du PDF de la page courante ;
  • styling plugin

Mise en forme

  • WRAP: enrichissement mise en forme (blocs, bulles, colonnes, div, CSS, positionnement… ;
  • SyntaxHighlighter4: boites de code colorées syntaxiquement;
  • color: ajout balises couleur (texte et/ou fond) ;
  • Cell Background: la même chose pour les tableaux.
  • Jouer avec les CSS via le fichier conf/userstyle.css

discussion dans un tab ?

Couleurs

Un thème sombre basé sur 4 couleurs: noir, blanc, gris et vert.
Cela se change dans Paramètres/Paramètres de style du thème (template)

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:

[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"
On peut pousser le vice plus loin, en attribuant le même thème aux inputs, via userstyle.
/* 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;
}

WRAP

L'auteur du plugin permet de créer ses propres règles CSS, excellent !
J'ai besoin d'une boite pour beaucoup de contenu, ou l'on pourrait scroller dedans: Rajouter dans conf/userstyle.css (à la racine de Dokuwiki)

.dokuwiki div.wrap_scroll{
height: 400px;
overflow-y: scroll;
}
Et pour l'utiliser:
<WRAP scroll>
</WRAP>
<WRAP scroll 50%>
</WRAP>
<WRAP round scroll>
</WRAP>

Utilisation

Astuces

  • Pour toute nouvelle installation un dossier wiki est créé avec notamment la page syntax
  • LE dossier FTP des pages se trouve dans adresse/data/pages/
  • 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 xls2wiki (facilement hébergeable sur FTP) et/ou macro excel

Syntaxe

caractères d’échappement%%balise(s)%%
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:

  1. sauvegarde (complète ou dossier data + userstyle.css) ;
  2. mettre à jour les extensions ;
  3. lancer l'utilitaire dans /Administrer/Extensions/Mise à jour du wiki
  4. suivre la procédure

Cela a modifié les fichiers suivants:

/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.
Du coup remodifier le CSS comme expliqué ci-dessus.
Pour une upgrade de 3 versions, aucun problème, données, personnalisation et modules OK.

autohebergement/dokuwiki.txt · Dernière modification: 2019/10/06 11:59 de xanatos