Chaque template devrait suivre la structure suivante (tous les chemins sont relatifs au répertoire du template). Les fichiers CSS sont spécifiés dans le fichier style.ini. Vous devriez avoir au moins un fichier CSS pour l'affichage standard (écran) et un autre dédié à l'impression.

• <dokuwiki>/lib/tpl/<template>/
  • <nom de fichier>.css
  • main.php – le fichier principal qui sert à afficher les pages
  • detail.php – la page de détail d'une image
  • mediamanager.php – le Gestionnaire de médias
  • images/ – toutes les images utilisées pour le template
  • conf/
    • default.php – default settings (voir tpl_getConf)
    • metadata.php – configuration metadata (voir tpl_getConf())
  • lang/ – fichiers de langue
    • <code de langue>/lang.php – chaînes de caractères utilisées dans le template
    • <code de langue>/settings.php – chaînes de caractères utilisées dans le Gestionnaire de configuration
  • style.ini – voir Style.ini

Une liste des fonctions disponibles est disponible dans la documentation de l'API. Certaines sont listées ci-dessous.

Cette fonction affiche le contenu d'une page du wiki, y compris la table des matières. Il est possible d'empêcher cela en passant le paramètre false quand on appelle la fonction :

tpl_content(false);

C'est utile si on souhaite séparer la table des matières du contenu de la page. On peut alors la placer n'importe où dans le template. Pour l'afficher, on utilisera la fonction tpl_toc() ci-dessous.

Par défaut, c'est la fonction tpl_content() qui s'occupe d'afficher la table des matières, en la plaçant juste avant le contenu d'une page. Mais si vous souhaitez afficher la table des matières à un autre endroit, par exemple dans une barre latérale, il vous faudra utiliser la fonction tpl_toc(). Quand on l'utilise, il ne faut pas oublier de passer le paramètre false à la fonction tpl_content().

Exemple:

<div id="content">
    <?php tpl_content(false)?>
</div>
 
<div id="sidebar">
    <?php tpl_toc()?>
</div>

La fonction tpl_toc() construit la table des matières depuis trois sources différentes :

• une variable d'environnement globale
• les métadonnées de la page
• la méthode getTOC() utilisée par les plugins d'administration

Comme il n'y a pas de métadonnées pour les anciennes révisions ou l'aperçu, la fonction tpl_toc() ne peut utiliser que la variable d'environnement globale dans ces cas précis. Et comme la variable d'environnement globale est remplie par le moteur de rendu de la page, cela ne marche que quand la fonction tpl_toc() est appelée après la fonction tpl_content(). Si votre template ne permet pas cela, vous pouvez utiliser la mémoire tampon pour palier à ce problème.

Exemple:

<?php
    // render the content into buffer for later use
    ob_start();
    tpl_content(false);
    $buffer = ob_get_clean();
?>
 
<div id="sidebar">
    <?php tpl_toc()?>
</div>
 
<div id="content">
    <?php echo $buffer?>
</div>

Cette fonction est utilisée pour accéder aux paramètres de configuration depuis le template.

Pour une liste complète des Variables globales et des constantes, consultez la page environment.

Presque à la fin du fichier main.php du template par défaut, vous verrez un appel à la fonction tpl_indexerWebBug(). Elle génère une balise HTML <IMG> qui fait une requête à lib/exe/indexer.php. C'est une partie vitale de DokuWiki qui fournit une indexation automatique de la page pour l'outil de recherche et d'autres fonctions importantes comme la génération d'une carte du site en XML (utilisée par les moteurs de recherche internet) ou la mise à jour des méta-données. Tous les templates doivent inclure cette fonction, sans quoi le wiki pourrait ne pas fonctionner correctement (par exemple, la recherche ne fonctionnera pas).

Les hooks (hameçons en français) permettent d'inclure du contenu statique dans votre DokuWiki sans avoir besoin de toucher au template. Vous pouvez par exemple les utiliser pour ajouter une bannière, le logo de votre entreprise ou un avertissement en bas de chaque page.

Le template par défaut de DokuWiki cherche des fichiers spécifiques dans le répertoire lib/tpl/default/ et se contente de les inclure au bon endroit quand on affiche une page. Vous pouvez y mettre n'importe quel code HTML ou PHP.

Tous ces fichiers sont recherchés dans le répertoire lib/tpl/default/.

DokuWiki est fourni avec un exemple de fichier footer.html qui contient quelques boutons et la licence.