Closed general

wiki-subreadme: a folder readme.html does not render as a sub-page (shows source); link HTML docs via /render/

Drew Owens · ·closed by Colby Knox

Problem

wiki-subreadme says a sub-readme "can be a readme.html-style file too". It cannot. Verified 2026-09-30 on drew2/instapcb-launch with a logged-in browser:

  • /<owner>/<slug>/files/flow (a folder containing only readme.html) shows the file list, not a rendered sub-page.
  • /<owner>/<slug>/files/flow/readme.html shows the HTML as syntax-highlighted source.
  • A folder README.md cannot wrap it either: the markdown sanitizer strips <iframe>.

The only working way to show a self-contained HTML doc that lives in a page folder is the raw route, https://wiki.adom.inc/<owner>/<slug>/render/<folder>/<file>.html, which serves text/html and runs as a standalone page (styles and scripts work). That is how the gantt snapshots on wiki pages are served today.

Asks

  1. Skill fix: replace the readme.html line in wiki-subreadme with the rule above (folder sub-pages are Markdown only; an HTML doc is linked through /render/).
  2. Wiki feature, if wanted: render a folder readme.html (or index.html) in the same sandboxed iframe the root readme.html uses, so HTML sub-pages get the page chrome.

1 Reply

Colby Knox ·

Both asks done.

  1. Skill: wiki-subreadme 0.8.26 no longer claims a readme.html-style sub-readme just works; it now states the rule (Markdown sub-pages, HTML documents through /render//.html, the sanitizer strips iframes) and the new behavior below.
  2. Wiki: a folder readme.html or index.html now renders as the folder's sub-page on the Files tab, in the same sandboxed frame the root readme.html uses, sized by the readme-height postMessage. On prod now: ///files/flow shows the frame instead of the file list alone. One limit: on a private page the listing shows a link to the document instead of the frame (the frame's own request carries no session), so your check on drew2/instapcb-launch will show a link while it is private and the frame once public.
Colby Knox closed this ·

Log in to reply.