-
-
Notifications
You must be signed in to change notification settings - Fork 24
Description
Following the official DokuWiki documentation for working with custom smileys (https://www.dokuwiki.org/smileys) and interwiki icons (https://www.dokuwiki.org/interwiki) does not result in the custom icons being displayed. This is because the folders the user is supposed to put the icons into are not properly persisted outside of the docker container.
Expected Behavior
The official DokuWiki documentation for working with smiley's (https://www.dokuwiki.org/smileys) and interwiki icons (https://www.dokuwiki.org/interwiki) describes putting them in the following folders:
<dokuwiki_root>/lib/images/smileys/local<dokuwiki_root>/lib/images/interwiki
It is expected that putting icons in these locations will allow them to be accessed and displayed if one follows the rest of the official documentation and creates the appropriate .conf files and references.
Current Behavior
The current container does not persist these locations outside of the container, so adding icons to these locations as described in the official documentation does not work and the custom icons are not displayed.
Steps to Reproduce
- Install a new container from the remote docker-dokuwiki
- Run install.php and restart the container
- Create a smileys/local folder as described in the official documentation: https://www.dokuwiki.org/smileys
config/dokuwiki/lib/images/smileys/local
- Copy one of the user provided smileys from https://www.dokuwiki.org/_media/wiki:usersmileys:button-danger-yellow.png
- Rename it test.png and put it in the
config/dokuwiki/lib/images/smileys/localfolder - Create a
config/dokuwiki/conf/smileys.local.conffile
# Testing Smileys
:SMILEYTEST: local/test.png
- Create/edit a page in DokuWiki and use the text ":SMILEYTEST:"
====== Test ======
===== Smiley =====
:SMILEYTEST:
- Verify that the text ":SMILEYTEST:" and a generic icon appears
- If it was working correctly, the smiley image you saved would appear instead
- Create an interwiki folder as described in the official documentation: https://www.dokuwiki.org/interwiki
config/dokuwiki/lib/images/interwiki
- Use your favorite paint program to create a 16x16 pixel red square and save it as ubuntu.png
- Move it to the interwiki folder you created
- Create a
config/dokuwiki/conf/interwiki.local.conffile
# Testing Interwiki's
ubuntu https://wiki.ubuntu.com/{NAME}
- Edit your DokuWiki test page and add the text "[[ubuntu>teams|Ubuntu Teams]]"
====== Test ======
===== Smiley =====
:SMILEYTEST:
===== Interwiki =====
[[ubuntu>teams|Ubuntu Teams]]
- Verify that a generic circle icon appears next to the interwiki link you created
- If it was working correctly, the red square icon you created would appear instead
Environment
OS: ubuntu-20.04.2-live-server
CPU architecture: x86_64
How docker service was installed:
Command used to create docker container (run/create/compose/screenshot)
sudo docker-compose up -d
---
version: "2.1"
services:
dokuwiki:
image: ghcr.io/linuxserver/dokuwiki
container_name: dokuwiki-test
environment:
- PUID=1000
- PGID=1000
- TZ=Europe/London
volumes:
- /docker/dokuwiki-test/config:/config
ports:
- 680:80
- 6443:443 #optional
restart: unless-stopped
