Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.

Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement… :-)

Ceci est une ancienne révision du document !


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 :

  • votre logo
  • votre favicon
  • votre CSS
  • votre JavaScript
  • votre CSS, selon la langue
  • votre icône Apple Touch (apple-touch-icon.png)
  • vos tabs
  • vos buttons/icons (footer)
  • vos boxes (left-column)

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

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