Navigator

A Theme for DokuWiki

User Tools

Site Tools


notes:how_the_autolist_works

How the Autolist Works

The Navigator Auto‑Index System

Navigator includes an automatic index generator for namespace start pages.

It creates a clean list of all pages in the same namespace and supports multiple sort orders.

Activation

The autolist activates only when the start page contains the opt‑in marker:

~~AUTOINDEX~~

Navigator hides the marker visually, so the page remains clean while still signaling intent.

How it finds pages

The script uses DokuWiki’s internal page index to discover pages in the same namespace.

To avoid stale entries, it performs a filesystem sanity check and only lists pages that physically exist on disk.

This ensures deleted pages disappear immediately, even if the index has not been rebuilt.

Sorting options

Users can sort the list using the following buttons:

  1. Newest pages first (default)
  2. Oldest pages first
  3. Alphabetical (A-Z) order (accent‑aware, article‑stripped)

These labels can be changed in the admin Setings panel.

Alphabetical sorting removes leading articles in English and other languages (e.g., The, A, O, Uma). This can be customized in the Admin Settings.

The colors of the top bar can also be changed in the admin Template Styles panel.

Visit the following page to view
some of the sorting capabilities of Navigator:
Sort Examples .

notes/how_the_autolist_works.txt · Last modified: by editor