mirror of
https://git.mills.io/prologic/zs-starter-template.git
synced 2026-11-11 03:54:05 -08:00
main
zs-starter-template
A ready-to-clone starter for zs, the Zen Static site generator. It is running live at https://zs.mills.io, where every page doubles as documentation for what the template can do.
Quick start
git clone https://git.mills.io/prologic/zs-starter-template.git
cd zs-starter-template
make dev
Open http://localhost:8000. Pages rebuild and reload as you save.
make buildrenders the site into.pub/.make imagepackages.pub/into a container that serves it on port 8000.
What is where
index.md, TestPage.md ... pages, as Markdown with YAML front matter
slides/ pages rendered as reveal.js decks (layout: slides.html)
cgi-bin/ scripts the runtime serves as CGI
assets/css/site.css the theme: tokens at the top, everything else below
assets/css/chroma.css syntax colours for build-time highlighting
assets/js/main.js the theme toggle and table-of-contents behaviour
.zs/layout.html the one page layout
.zs/slides.html the slide layout
.zs/config.yml site title, description, enabled extensions
.zs/nav, onthispage, ... shell-script plugins behind each {{ placeholder }}
DESIGN.md the design decisions behind the look
License
zs-starter-template is released under the terms of the WTFPL.
Languages
CSS
63.8%
JavaScript
20.9%
HTML
12.4%
Shell
2.5%
Makefile
0.3%