Commit afeaa3e
Simplify docs config with theme mixins (#56)
## Summary
- Delete `docs/hooks.py` — all preprocessing logic (matplotlib rcParams,
MyST admonition conversion, cross-ref auto-linking) is now handled by
shadcn theme mixins
- Remove all `markdown_extensions` and `mkdocstrings` options
boilerplate from `mkdocs.yml` — theme provides sensible defaults
- Add `crossref_modules` and `crossref_aliases` to theme config for
project-specific cross-ref resolution
Net result: `mkdocs.yml` goes from 90 to 56 lines, `hooks.py` (112
lines) is deleted entirely.
Depends on gdsfactory/mkdocs-shadcn@13d85fc.
## Test plan
- [ ] `just docs` builds without errors
- [ ] Syntax highlighting works on notebook pages
- [ ] Cross-refs resolve on API page
- [ ] KaTeX math renders on algorithm page
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>1 parent 340575a commit afeaa3e
2 files changed
Lines changed: 7 additions & 153 deletions
This file was deleted.
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
11 | 11 | | |
12 | 12 | | |
13 | 13 | | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
14 | 21 | | |
15 | 22 | | |
16 | 23 | | |
| |||
25 | 32 | | |
26 | 33 | | |
27 | 34 | | |
28 | | - | |
29 | | - | |
30 | | - | |
31 | 35 | | |
32 | 36 | | |
33 | 37 | | |
| |||
49 | 53 | | |
50 | 54 | | |
51 | 55 | | |
52 | | - | |
53 | | - | |
54 | | - | |
55 | | - | |
56 | | - | |
57 | | - | |
58 | | - | |
59 | | - | |
60 | | - | |
61 | | - | |
62 | | - | |
63 | | - | |
64 | | - | |
65 | | - | |
66 | | - | |
67 | | - | |
68 | | - | |
69 | | - | |
70 | | - | |
71 | | - | |
72 | | - | |
73 | | - | |
74 | | - | |
75 | | - | |
76 | | - | |
77 | | - | |
78 | | - | |
79 | | - | |
80 | | - | |
81 | | - | |
82 | | - | |
83 | | - | |
84 | | - | |
85 | | - | |
86 | | - | |
87 | | - | |
88 | | - | |
89 | | - | |
0 commit comments