2023-04-01 17:01:38 +10:00
2026-10-11 12:44:56 +10:00
2026-10-11 12:44:56 +10:00
2023-03-30 22:52:12 +10:00
2026-10-11 12:44:56 +10:00
2026-10-11 12:44:56 +10:00
2026-10-11 12:44:56 +10:00
2026-10-11 12:44:56 +10:00
2024-08-25 15:58:13 +10:00
2026-10-11 12:44:56 +10:00
2026-10-11 12:44:56 +10:00
2026-10-11 12:44:56 +10:00
2026-11-01 22:09:32 +10:00
2026-10-11 12:44:56 +10:00
2026-10-11 12:44:56 +10:00
2026-10-11 12:44:56 +10:00
2026-10-11 12:44:56 +10:00

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 build renders the site into .pub/.
  • make image packages .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%