Custom Features
Some custom features were added to the standard framework. These will need to be maintained by the W3 Committee.
Sidebar
Section titled “Sidebar”There is a custom sidebar at src/sidebar.ts that has a couple of extra features over the Starlight sidebar.
- To add items to the sidebar, modify
src/sidebar.config.ts. - You can assign both a
slugand anitemsfield to create article links that also have indented children. These will be referred to as Hybrid Sidebar Items. Theslugvalue indicates the article that should be referenced. Theitemsvalue is an array of the articles that should appear underneath the parent article.
Autogenerate
Section titled “Autogenerate”The way autogeneration works has been slightly modified.
- Directories and files will be changed from
kebab-casetoTitle Casee.g.hello-worldtoHello World. - If a directory contains a Markdown file and directory with the exact same file name (minus the extension) that will create a Hybrid Sidebar Item
- e.g., the following structure will produce a
Froshhybrid sidebar item, withGrantandPresentationas its children
Directoryevents/
Directoryfrosh/
- grant.mdx
- presentation.mdx
- frosh.mdx
- e.g., the following structure will produce a