make-web/README.md
2023-10-23 13:31:17 +02:00

32 lines
885 B
Markdown

This is a BSD Makefile base webpage generator.
Pretty minimal... no features at all.
It needs:
- BSD make (written and tested on OpenBSD)
- discount (for parsing markdown file)
- asciidoctor + asciidoctor-diagram extension (for parsing asciidoctor files)
- ksh (for shell stuff)
- rsync (to copy static files)
Basic operation:
src/header.th gets prepended to every file.
src/footer.th gets appended to every file.
.pa files contain asciidoctor source.
.pm files contain markdown source.
.ph files contain plain html.
.ps files contain ksh shell script (the scripts must output html to stdout).
Everything in src/assets is copied as is.
Execute `make` to create the website with debug output.
Execute `make -s` to hide the debug output.
The generated website will be in the directory `www`.
Execute `make clean` to delete www. Or just `rm -rf www`, if you want
to start over.