3.1.1

Patch release. Three defects found while exercising 3.1.0 in a browser on a real WordPress install. All three affect any site, not a particular setup.

Fixed

Blank documentation page behind a cache or JavaScript optimizer. WP Rocket's "delay JavaScript execution" rewrites every script tag to a type the browser will not run and only restores them on the first user interaction. Docsify has to run at load: it reads window.$docsify, then fetches and renders the Markdown. Measured on a real install: 90 of 111 scripts rewritten, $docsify, Docsify, mermaid and d3 all undefined, #app empty, zero requests for the .md files, and no JavaScript error to point at it. A cached copy of the page made it worse, since it is served before WordPress loads.

The page now declares DONOTCACHEPAGE, DONOTROCKETOPTIMIZE, DONOTMINIFY, DONOTCACHEOBJECT and DONOTASYNCCSS, plus the litespeed_control_set_nocache filter LiteSpeed reads instead of a constant.

Collapsed sidebar sections disappeared from the menu. Docsify hides every non-anchor child of a collapsed item, which assumes the group heading is a link. A heading written as plain text, the usual way to write a _sidebar.md, renders as .group-title and was hidden along with the list, leaving no way to reopen the section.

The admin bar printed unstyled over the documentation. The page drops the theme styles, so the bar had no stylesheet, and no room either, since docsify pins its layout to the top of the viewport. It is now hidden on the documentation page only; other pages and wp-admin are untouched.

Upgrade Notice

Recommended for anyone on 3.1.0, and required if your site runs a page cache or a JavaScript optimizer. After updating, purge your cache once so the stored copy of the documentation page is dropped.

Install

Download docsify-docs-3.1.1.zip and upload it under Plugins > Add New Plugin > Upload Plugin. Do not unzip it first.

Full Changelog: v3.1.0...v3.1.1

🤖 Generated with Claude Code