dokuwiki-strata icon indicating copy to clipboard operation
dokuwiki-strata copied to clipboard

Effect of the "useheading" configuration setting

Open winakeytoheaven opened this issue 4 years ago • 2 comments

I made a discovery today after several hours of head-scratching. I simply could not get Strata to render page TITLES in its various constructs. On my site, it would only render page names (page addresses or what I would call in another context as a page slug). It turns out that ''useheading'' setting must be set to "Always" or "Wiki Content Only" for strata to render the titles. My setting was "Never" and the moment I changed it, strata rendered page Titles. My pondering would have been hours quicker had there been any mention of this setting in the Strata Reference Guide, so here's my hint for somebody who can edit that to make this documentational improvement. For details, see https://www.dokuwiki.org/config:useheading.

winakeytoheaven avatar Apr 09 '20 20:04 winakeytoheaven

Hi, thanks for sticking with it and for pointing out this issue! I'm sorry that you had to spend that time on discovering the configuration setting by yourself.

I've tagged this issue as informational. I'll add a note to the README's installation steps, and I'll add a note to the plugin's page as well in hopes of saving others time.

If you're interested in why this is how it is: I have attempted to make Strata follow the global DokuWiki configuration where possible, which includes following the useheading setting as configured... I must admit that the very first thing I normally do when setting up a new DokuWiki instance is switching useheading to "Always" -- it makes your a fresh wiki much more human-friendly.

bwanders avatar Apr 11 '20 09:04 bwanders

Wow, what a quick reply--thanks!

You and I are kindred spirits in at least one sense: we love documentation. That’s the whole point of Dokuwiki (ie., Documentation Wiki), right? Thanks for adding these notes!

winakeytoheaven avatar Apr 11 '20 15:04 winakeytoheaven