Skip to content

Commit b2639ec

Browse files
committed
docs(sidebar[captions]): show package tier captions in global sidebar
why: The three package tier captions (Shared Infrastructure, Domain Packages, Theme/Fonts/CLI) were defined in docs/packages/index.md but did not render in the Furo sidebar — Sphinx's toctree function only emits <p class="caption"> separators for top-level captioned toctrees defined in the root document. what: - Move the three captioned :hidden: toctrees from docs/packages/index.md to docs/index.md so they become top-level navigation groups - Remove the now-duplicate captioned toctrees from packages/index.md (the page keeps its narrative tier description and workspace grid) - Sidebar now shows three labelled groups instead of a flat list of 12
1 parent 1c09049 commit b2639ec

2 files changed

Lines changed: 30 additions & 30 deletions

File tree

docs/index.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -97,3 +97,33 @@ api
9797
project/index
9898
history
9999
```
100+
101+
```{toctree}
102+
:caption: Shared Infrastructure
103+
:hidden:
104+
105+
packages/sphinx-ux-badges
106+
packages/sphinx-ux-autodoc-layout
107+
packages/sphinx-autodoc-typehints-gp
108+
```
109+
110+
```{toctree}
111+
:caption: Domain Packages
112+
:hidden:
113+
114+
packages/sphinx-autodoc-api-style
115+
packages/sphinx-autodoc-docutils
116+
packages/sphinx-autodoc-fastmcp
117+
packages/sphinx-autodoc-pytest-fixtures
118+
packages/sphinx-autodoc-sphinx
119+
```
120+
121+
```{toctree}
122+
:caption: Theme, Fonts & CLI
123+
:hidden:
124+
125+
packages/gp-sphinx
126+
packages/sphinx-gp-theme
127+
packages/sphinx-fonts
128+
packages/sphinx-autodoc-argparse
129+
```

docs/packages/index.md

Lines changed: 0 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -28,33 +28,3 @@ and FastMCP tools all look like they belong together.
2828

2929
```{workspace-package-grid}
3030
```
31-
32-
```{toctree}
33-
:caption: Shared Infrastructure
34-
:hidden:
35-
36-
sphinx-ux-badges
37-
sphinx-ux-autodoc-layout
38-
sphinx-autodoc-typehints-gp
39-
```
40-
41-
```{toctree}
42-
:caption: Domain Packages
43-
:hidden:
44-
45-
sphinx-autodoc-api-style
46-
sphinx-autodoc-docutils
47-
sphinx-autodoc-fastmcp
48-
sphinx-autodoc-pytest-fixtures
49-
sphinx-autodoc-sphinx
50-
```
51-
52-
```{toctree}
53-
:caption: Theme, Fonts & CLI
54-
:hidden:
55-
56-
gp-sphinx
57-
sphinx-gp-theme
58-
sphinx-fonts
59-
sphinx-autodoc-argparse
60-
```

0 commit comments

Comments
 (0)