Site Tools


wiki:logo

This is an old revision of the document!


Customizing DokuWiki Logo

There are two places that affect the DokuWiki logo – the DokuWiki root directory, and the template directory. When switching site templates the logo will need to be updated.

For the default DokuWiki template, and most templates using that as the foundation, here are the locations checked by the template code:

  • The site's logo
    • :wiki:logo.svg
    • :logo.svg
    • :wiki:logo.png
    • :logo.png
    • lib/tpl/dokuwiki/images/logo.png
  • The favicon
    • :wiki:favicon.ico
    • :favicon.ico
    • lib/tpl/dokuwiki/images/favicon.ico
  • The bookmark icon used by Apple and Android devices
    • :wiki:apple-touch-icon.png
    • :apple-touch-icon.png
    • lib/tpl/dokuwiki/images/apple-touch-icon.png

Please make sure that those namespaces (either root or wiki:) are readable to all users. Otherwise the image will be broken to users who are not logged in.

https://www.dokuwiki.org/template:dokuwiki#changing_the_logo

Logo files may need to be updated when a DokuWiki update (or template update) are installed.

Execute the following script from the site root, assuming custom logo images are already in the site root:

  cd /var/www/vhosts/metatek.org/httpdocs/
dw-logo.sh
#!/bin/bash
 
LOGO_IMAGE=(apple-touch-icon.png favicon.ico logo.png)
 
for image in ${LOGO_IMAGE[@]}; do
cp -af $image data/media/wiki/$image
cp -af $image lib/tpl/dokuwiki/images/$image
cp -af $image lib/tpl/mindthedark/images/$image
done

SITE /ROOT

/favicon.ico /apple-touch-icon.png /logo.png

MEDIA :ROOT:

:favicon.ico :logo.png

MEDIA :WIKI:

:wiki:favicon.ico :wiki:logo.png

SITE /TEMPLATE

/lib/tpl/dokuwiki/images/favicon.ico /lib/tpl/dokuwiki/images/apple-touch-icon.png /lib/tpl/dokuwiki/images/logo.png
/lib/tpl/mindthedark/favicon.ico /lib/tpl/mindthedark/apple-touch-icon.png /lib/tpl/mindthedark/logo.png
wiki/logo.1761253160.txt.gz · Last modified: by Alan Shea

Copyright © Alan Shea, 2011-2025