Commit 1db32a0
pages: add Jekyll front matter to API ref so just-the-docs renders pages
Without front matter, Jekyll treats every generated .md as a static
file and copies it verbatim to _site/ instead of rendering it through
the just-the-docs layout. The api-reference URLs returned raw markdown
(or 404 when the user expected .html).
- Add docs/_api-frontmatter.tpl with title, default layout, and
nav_exclude:true (the 3,979-page API surface would otherwise drown
the sidebar; users reach pages via search and direct links).
- Pass --front-matter to xmldocmd in the pages workflow.
xmldocmd's $title placeholder is substituted per page; combined with
search_exclude:false the pages still get indexed by just-the-docs'
search.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>1 parent 794c7c0 commit 1db32a0
2 files changed
Lines changed: 7 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
47 | 47 | | |
48 | 48 | | |
49 | 49 | | |
| 50 | + | |
50 | 51 | | |
51 | 52 | | |
52 | 53 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
0 commit comments