Skip to content

Custom Smiley and Interwiki icons do not work because folders not persisted #40

@MachX428

Description

@MachX428

linuxserver.io

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

# 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.conf file
# 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

Docker logs

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions