I prefer PageList with full namespace: need to modify pagelist/helper.php::printPageCell and replace page title with $id.

Important to distinguish between pages and namespaces.

This is important for ACL - a page with the same name as the namespace is not part of the namespace, and hence requires a separate ACL rule.

TODO: Put this under configuration section of Dokuwiki page here.

Also avoid the page cache plugin where necessary, perhaps perform page caching on client-side instead of server side enforced. Otherwise the whole experience appears to become rather buggy.

Rants

It's easy if the wiki has an exportable directory of wiki contents. Grab that, and use pandoc to convert between wiki markup formats, e.g. see below for an example with Markdown (my oldest wiki was hosted on RTD):

cp -p "$filepath" "$stempath.md"
pandoc -t dokuwiki -o "$stempath.txt" "$stempath.md"

See this bash function for iterating through directories and extracting the extension path. Copied here for posterity:

Conversion script

#!/bin/bash
# Converts from Markdown to Dokuwiki format, in-place
#
# Usage:
#   find ./ -type f | xargs -I{} ./convert.sh {}
 
filepath="$1"
 
# Remove extension
case "$filepath" in
  */* )
    # 'filepath' is a path under some directory
    dirpath="${filepath%/*}"
    filename="${filepath##*/}"
    stem="${filename%.*}"
    test -z "$stem" && stem="$filename"
    stempath="$dirpath/$stem"
    ;;
  *)
    # otherwise, filepath is the filename itself
    stempath="${filepath%.*}"
    test -z "$stempath" && stempath="$filepath"
    ;;
esac
 
cp -p "$filepath" "$stempath.md"
pandoc -t dokuwiki -o "$stempath.txt" "$stempath.md"

From 2024-01-18:

To submit a pull request for fixing inc/Manifest.php to align to the favicons guide.

diff --git a/inc/Manifest.php.bak b/inc/Manifest.php
index 29e7f26..e358109 100644
--- a/inc/Manifest.php.bak
+++ b/inc/Manifest.php
@@ -46,8 +46,8 @@ class Manifest
 
         if (empty($manifest['icons'])) {
             $manifest['icons'] = [];
-            if (file_exists(mediaFN(':wiki:favicon.ico'))) {
-                $url = ml(':wiki:favicon.ico', '', true, '', true);
+            if (file_exists(mediaFN(':favicon.ico'))) {
+                $url = ml(':favicon.ico', '', true, '', true);
                 $manifest['icons'][] = [
                     'src' => $url,
                     'sizes' => '16x16',

A small note on the favicon resolution requirements as well:

# 256 seems to have better compression ratios than 128, probably because the original filesize is 500x500px
user:~$ convert image.png -define icon:auto-resize=256,48,32,16 favicon.ico

A small bug in the autologoff as well:

/var/www/dokuwiki/lib/plugins/autologoff/helper.php

  3     public function usertime() {
  2         global $INFO;
  1         global $auth;
71          if(!($_SERVER['REMOTE_USER'] ?? false)) return 0;
  1         ...
  2     }