Properties
category: trend
tags: [otterwiki-fork, upstream]
confidence: medium
last_updated: 2026-03-13

Underscore Filenames

Status: Future work

Problem

Otterwiki stores page names with spaces in filenames (My Page.md) and URLs (/My%20Page). This looks awkward in git repos and URLs.

Current state

Two config flags set for wikibot.io:

  • RETAIN_PAGE_NAME_CASE=True — preserves original casing (instead of title-casing from lowercase files)
  • TREAT_UNDERSCORE_AS_SPACE_FOR_TITLES=True — displays underscores as spaces in titles/breadcrumbs

Future feature

Add option to store underscores instead of spaces in filenames and URLs:

  • New page "My Page" → stored as My_Page.md, URL /My_Page
  • Display still shows "My Page" (existing TREAT_UNDERSCORE_AS_SPACE_FOR_TITLES handles this)
  • WikiLink resolution: [[My Page]] must match My_Page.md — needs work
  • Admin-configurable setting, exposed in Content and Editing

Scope

  • Feature branch in otterwiki fork
  • Candidate for upstream contribution
  • WikiLink resolution is the main complexity
  • Should not block P1-9 (self-hosting migration)
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9