Table des matières

Dokuwiki : Thème Monobook

Voir la page http://www.dokuwiki.org/Template, rubrique monobook

Pré-requis

Installation

Le lien pour télécharger est : http://cloud.github.com/downloads/tatewake/dokuwiki-template-monobook/monobook-stable.tar.gz

Le décompresser dans www/doc/lib/tpl

Puis se connecter en administrateur, aller dans Admin/paramètres de configuration et régler le modèle sur monobook

Configuration

Beaucoup de détails sur la personnalisation ici

Jetez un oeil à README. Vous trouverez ici de quoi personnaliser :

Pour ceux qui ne lisent jamais les READMEs:

  • toutes les personnalisations définies par l'utilisateur sont placées dans le répertoire monobook/user. En effet, ce dossier ne sera pas touché par les mises à jour.
  • Pour remplacer le logo par défaut qui s'affiche dans le coin supérieur gauche, il suffit de créer un fichier /monobook/user/logo.[png|gif|jpg]. Le modèle reconnaît automatiquement ce fichier et l'utilisera à la place du logo par défaut.
  • Pour ajouter des onglets, jetez un oeil sur /monobook/user/tabs.php (PAS /monobook/conf/tabs.php).
  • Pour ajouter vos propres boutons (en bas), jetez un oeil sur /monobook/user/buttons.php (PAS /monobook/conf/buttons.php).
  • Pour ajouter vos propres boîtes (colonne de gauche), jetez un oeil sur /monobook/user/boxes.php (PAS /monobook/conf/boxes.php).

Si l'un des fichiers dans /monobook/user/ n'existe pas, ne touchez pas au contenu de /monobook/user/, prenez les fichiers manquants dans la nouvelle archive d'installation et copiez-les dans /monobook/user/.

Exemples d'onglets personnalisés

à insérer dans /monobook/user/tabs.php (PAS /monobook/conf/tabs.php) 1)

Modifications récentes

/monobook/user/tabs.php
//Recent Changes (thanks to Stefan Riemer for this)
//To get some space between this and the other tabs, you may add the following
//additional CSS to /monobook/user/screen.css:
//  li#tab-recent {
//    margin-left: 1.6em;
//  }
if (!empty($conf["recent_days"])){     
    $_monobook_tabs["tab-recent"]["text"]     = $lang["btn_recent"]; //language comes from DokuWiki core
    $_monobook_tabs["tab-recent"]["href"]     = wl("", array("do" => "recent"), false, "&");
    $_monobook_tabs["tab-recent"]["nofollow"] = true;
}

Exemples de boîtes personnalisées

… à insérer dans /monobook/user/boxes.php (PAS /monobook/conf/boxes.php) 2)

QR Code de la page courante

/monobook/user/boxes.php
//QR-Code of the current page (thanks to Luigi Micco <http://www.luigimicco.altervista.org> for this)
$_monobook_boxes["qrcode"]["headline"] = "QR-Code";
$_monobook_boxes["qrcode"]["xhtml"] = '<img src="http://api.qrserver.com/v1/create-qr-code/?data='.urlencode(cleanID(getID()), false, true, "&")).'&amp;size=135x135" style="margin:0.5em 0 0.3em -0.2em;" alt="QR-Code: '.wl(cleanID(getID()), false, true).'" title="QR-Code: '.wl(cleanID(getID()), false, true).'" /><p style="font-size:6px !important;margin:0;padding:0;color:#aaa;"><a href="http://goqr.me/" style="color:#aaa;">QR Code</a> by <a href="http://qrserver.com/" style="color:#aaa;">QR-Server</a></p>';

Prise en charge du plugin pdfbook

Pour prendre en charge le plug-in BookCreator, utilisez ce code:

//To add support for bookcreator plugin
$_monobook_boxes["bookcreator"]["headline"] = "Create book";
$_monobook_boxes["bookcreator"]["xhtml"] =  "        <ul>\n"
                                         ."          <li id=\"tb-bookcreator\"><a href=\"".wl(cleanID(getID()), array("do" => "addtobook"))."\" rel=\"nofollow\">".hsc('Add/Remove page')."</a></li>\n"
                                         ."          <li id=\"tb-bookcreator\"><a href=\"".wl('wiki:ebook')."\" rel=\"nofollow\">".hsc('Show selection')."</a></li>\n"
                                         ."        </ul>";

Modifications récentes et plugin "listeabo"

Pour ajouter “modifications récentes” et le plugin listeabo

ajoutez dans lang.php (français :)

$lang['monobook_changes'] = "Modifications récentes";
$lang['monobook_listeabo'] = "Liste des abonnements";

Et ce qui suit dans user/boxes.php :

user/boxes.php
$_monobook_boxes["Addition"]["headline"] = "TITLE";
$_monobook_boxes["Addition"]["xhtml"] =  "<ul>\n"
                                      // added recent changes 
                                      ."          <li><a href=\"".DOKU_BASE."doku.php?do=recent"."\" rel=\"nofollow\">".hsc($lang["monobook_changes"])."</a></li>\n"
                                      // added listabo
                                      ."          <li><a href=\"".DOKU_BASE."doku.php?do=listeabo"."\" rel=\"nofollow\">".hsc($lang["monobook_listeabo"])."</a></li>\n"
                                      ."</ul>";

Hacks pour /user/screen.css

… à insérer dans /monobook/user/screen.css (PAS /monobook/static/css/screen.css) 3).

Numérotation des titres

Voir Numérotation des titres par CSS uniquement (remplace numberedheadings)

Couleurs de liens personnalisées (wiki / liens internes)

Ouvrez /user/screen.css et insérez :

/user/**screen.css
div.dokuwiki a.wikilink1 :link{
  color: #006600 !important;
}
div.dokuwiki a.wikilink1:visited { 
  color: #009933 !important; 
}
div.dokuwiki a.wikilink1:hover { 
  color: #006600 !important; 
}

Remplacez simplement les couleurs par les valeur que vous voulez.

Barre latérale plus large / plus d'espace pour la colonne de gauche

Ouvrez /user/screen.css et insérez :

/user/screen.css
/* Give sidebar more space.
 
   Default widths:
   - 12.2em as left spacer for the content area. This example is using 14.2em
     instead.
   - 11.6em as sidebar width. This example is using 13.6em instead.
   - 10.9em as width for the search input field. This example is using 12.9em
     instead.
   - 150px as left spacer for the Ajax searchbox. This example is using 180px.
*/
/* move content container more to the right */
#content {
  margin: 2.8em 0 0 14.2em;
}
#column-content {
  margin: 0 0 .6em -14.2em;
}
#column-content #content {
  margin-left: 14.2em !important; /* adjustment for  IE (7) */
}
/* redefine sidebar width + tab bar position */
.portlet {
  width: 13.6em;
}
#p-cactions {
  left: 13.6em; /* tab bar */
}
/* search input field */
#qsearch__in {
  width: 12.9em;
}
/* ajax "matching pagename" searchbox */
#qsearch__out {
  left: 180px
}

Image d'arrière-plan personnalisée

Stockez votre image d'arrière-plan en /user/background.jpg, ouvrez /user/screen.css et insérez :

html {
  background-color: #f9f9f9;
}
body {
  background: #f9f9f9 url(user/background.jpg) 0 0 no-repeat;
}

Si nécessaire, remplacez la couleur #f9f9f9 par une valeur correspondant à vos besoins.

Ajax Quicksearch : afficher les résultats dans la barre latérale

Ouvrez /user/screen.css et insérez :

/user/screen.css
#qsearch__out {
  position: static !important;
  font-size: 85% !important;
  background: __background__ !important;
  margin-top: 0 !important;
  margin-bottom: 0.5em;
  width: 12.2em;
  display: none;
  border: 1px solid #aaa;
  padding: 0 .8em .3em .5em;
}

Préserver les espaces (plusieurs espaces, tabulations) dans le texte de code

Ouvrez /user/screen.css et insérez :

/user/screen.css
div#content .dokuwiki code {
  white-space: pre;
}

Utilisation

Désinstallation

Voir aussi


Basé sur « Article » par Auteur.

1) , 2) , 3)
car les fichiers dans monobook/user/ seront conservés lors des mises à jour, ce qui évite de refaire sans cesse vos personnalisations