- JavaScript 35.2%
- HTML 29.3%
- CSS 13.8%
- SCSS 13.6%
- Python 8.1%
| .impeccable | ||
| _includes | ||
| _layouts | ||
| _sass | ||
| assets | ||
| docs | ||
| evidence | ||
| fixtures | ||
| tools | ||
| .gitattributes | ||
| .gitignore | ||
| _config.yml | ||
| AGENTS.md | ||
| brand.yml | ||
| CONTEXT.md | ||
| DESIGN.md | ||
| PRODUCT.md | ||
| README.md | ||
Docside
Docside is a documentation theme for Jigyll, using stock Starlight as visual reference only.
Start a new site
Install Git and Jigyll 1.13.0 or later, then create a site with Docside:
jigyll new my-docs --theme https://github.com/reidransom/docside.git
cd my-docs
The installer clones Docside into _theme/docside/.
Replace _config.yml with a minimal site configuration:
title: My documentation
theme: docside
url: ""
baseurl: ""
navigation:
- label: Overview
link: /
defaults:
- scope:
path: ""
values:
layout: default
Replace index.md with an overview:
---
title: Overview
permalink: /
---
Welcome to my documentation.
## Next steps
Add ordinary Markdown pages and list them in `_config.yml`.
Serve the site from its new directory:
jigyll serve --host 127.0.0.1 --port 4322
Open http://127.0.0.1:4322/. The generated site is _site/.
See Getting started for page and navigation examples, then read the guides under docs/.
Develop the theme
Theme maintainers should use the installed-consumer workflow in Developing Docside. It explains how to preview and rebuild this repository's living documentation without making a direct source build look like consumer-installation proof.
Attribution
The theme retains upstream notices beside shipped third-party assets. Stock Starlight attribution is in assets/starlight-LICENSE, and the frozen Seti file-icon inventory is covered by assets/file-tree-icons-LICENSE. Search loads the MIT-licensed MiniSearch directly from jsDelivr; its bundle is not vendored.