Skip to content

MD.Scribe 3.4.4 — Keystone

Choose a tag to compare

@paulmann paulmann released this 13 Nov 21:08
· 50 commits to main since this release

3.4.4 “Keystone” — patch

Two defects found by looking at the rendered page rather than at HTTP status codes.

Fixed

  • Wide tables were clipped at the column edge. Document tables were drawn at their unwrapped content width (width: max-content) with white-space: nowrap in the header row, so a table wider than the reading column ran past it and the text was cut off mid-word — with no visible hint that it scrolls. Measured on a real document at 1512px: a 736px column held an 896px table. Tables now take the column width and wrap their cells; the scroll container stays as a fallback for genuinely wide tables. After the fix the same table measures 734px in a 736px column with zero clipped cells.
  • The documented MIME fix could break a whole vhost. docs/installation.md advised types { application/manifest+json webmanifest; }, but a types block replaces the inherited MIME table (and Debian's mime.types is itself wrapped in one). Applied on nginx 1.24, that served every .css, .js and .svg as application/octet-stream: the site rendered unstyled and the client’s whole virtual host was affected. Both guides now say plainly not to use a types block, map only the extension, and check the whole table afterwards.

Changed

  • The web app manifest is served by the application (?api=manifest) with Content-Type: application/manifest+json, and the layout links to that instead of the static public/manifest.webmanifest. The media type no longer depends on the host, and sub-directory installs get a correct scope/start_url (e.g. /docs/). The static file still ships as a fallback.

Tests

214 tests, 664 → 679 assertions. New guards: TypographyAssetsTest keeps the built typography.css byte-identical to its source and forbids the clipping rules; ManifestEndpointTest pins the media type, the document shape, the sub-directory scope and the route/layout wiring.

Install

unzip MD.Scribe-3.4.4.zip -d /var/www/docs
chown -R www-data:www-data /var/www/docs/storage

Full changelog: CHANGELOG.md