git » homepage.git » master » tree

[master] / README.md

Homepage static site generator

This converts Markdown from md/ to HTML in out/ and can deploy the result to your shared host.

AI helpers: read AGENTS.md before making changes.

Usage

make assets && make xdg-open out/Index.html # or open on macOS

Note: make deploy requires a clean git worktree. Commit or stash changes first if you plan to publish.

Deploy

make deploy # uses rsync to upload to your shared host defined in DEPLOY_HOST

Build cmark

This project defaults to /usr/bin/cmark-gfm. If it is missing on your system you can build a local copy:

git clone https://github.com/github/cmark-gfm vendor/cmark-gfm cmake -S vendor/cmark-gfm -B vendor/cmark-gfm/build cmake --build vendor/cmark-gfm/build cp vendor/cmark-gfm/build/src/cmark-gfm bin/

Then rerun make with MD2HTML=bin/cmark-gfm.