Templates should follow the following directory structure (all paths are relative to the template directory).

CSS files are specified in the style.ini file. Use as many files as you like, but you should at least provide one CSS file for the screen presentation and one for printing.

• <dokuwiki>/lib/tpl/<template>/
  • <filename>.css – template's stylesheets (if more than a few are provided, it makes sense to group them in a css/ subdirectory)
  • script.js – optional, if your template needs JavaScript
  • main.php – general layout of DokuWiki
  • detail.php – the image detail page
  • mediamanager.php – the media-selection popup
  • images/ – all images used in the template (if any)
  • conf/ – configuration files (optional, if configuration is used)
    • default.php – default settings for the template settings
    • metadata.php – configuration metadata describe properties of the settings as used by the Configuration Manager
  • lang/ – language files
    • <lang code>/lang.php – localization strings used in the template (optional, use when needed)
    • <lang code>/settings.php – localization strings used in the configuration manager (if configuration is used)
  • style.ini – see style.ini
  • favicon.ico – favicon (can be overwritten by uploading another one into the root or wiki namespace when tpl_favicon() is used)
  • template.info.txt – A text file with template information required!

Handling of configuration settings is analogous to plugins. Use tpl_getConf(<setting>) to retrieve custom template settings. Saved local settings are stored in DokuWiki's global conf/local.php.