Skip to content

Commit 00dc76e

Browse files
wanshuiyinclaude
andcommitted
docs(render-html): add TOC-clean heading authoring rule (reflow C)
render_toc() renders raw heading text verbatim into the sidebar TOC, so citation marks ([8]), footnote refs, and (a)/(b)/(c) sequence labels in headings show up there literally. Add a Key-rules bullet telling authors to keep those in the body. The existing 46 tutorials already follow the SS-N / N.M heading hygiene; this codifies it for blogs and future content. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent be01043 commit 00dc76e

1 file changed

Lines changed: 1 addition & 0 deletions

File tree

skills/render-html/SKILL.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -285,6 +285,7 @@ For deck / poster / Xiaohongshu card / tweet card / data report style outputs, p
285285

286286
- **Do not auto-render every Markdown file.** Only artifacts on the whitelist above. File proliferation is the main anti-pattern.
287287
- **Do not hand-edit the generated HTML.** Edit the source, then re-render. The embedded SHA256 in the HTML meta tells you if the source has changed since render.
288+
- **Keep headings TOC-clean (authoring rule).** `render_toc()` renders each heading's raw text verbatim into the sidebar TOC, so whatever is in a heading shows up there literally. Do not put citation marks (`[8]`), footnote refs, or `(a)`/`(b)`/`(c)` sequence labels in headings — keep those in the body. (ARIS tutorials use `## §N Title` / `### N.M Title`, which render cleanly.)
288289
- **academic-template HTML is a reviewed artifact**, not raw output. Cross-model Codex review (fresh thread) gates the academic deliverables — the same way `/proof-checker`, `/paper-claim-audit`, `/citation-audit`, `/kill-argument` gate their respective products. `--no-review` exists for fast iteration but should not be the way you ship.
289290
- **The reviewer audits rendering, not research.** Claim truthfulness is owned upstream by `/paper-claim-audit`, `/result-to-claim`, `/research-review`. The HTML reviewer asks: "did the renderer faithfully + safely convert this source?" — nothing more.
290291
- **CDN dependency is opt-out, not opt-in.** Most users have internet; `--offline` is for air-gapped runs / archival.

0 commit comments

Comments
 (0)