2023-10-23 13:29:14 +02:00
|
|
|
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).
|
2023-10-23 22:39:52 +02:00
|
|
|
.pt files contain plain text.
|
2023-10-23 13:29:14 +02:00
|
|
|
|
2023-10-23 22:39:52 +02:00
|
|
|
Everything in `.control/static-files` is copied as is.
|
2023-10-23 13:31:17 +02:00
|
|
|
|
2023-10-23 22:39:52 +02:00
|
|
|
Execute `make debug` to create the website with debug output.
|
|
|
|
Execute `make` to hide the debug output.
|
|
|
|
Execute `make install` to copy the page to the remote in `.control/remote-ssh-target`.
|
2023-10-23 13:31:17 +02:00
|
|
|
|
|
|
|
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.
|