miti.sh/README.md

80 lines
1.4 KiB
Markdown

## requirements
`pandoc` utility must be installed
- Debian Bookworm:
$ apt-get update && apt-get install -y pandoc
## start default openresty
1. Run `docker run --rm -it --init -w /opt -v $PWD:/opt -p 80:80 openresty/openresty:1.27.1.2-0-bookworm-buildpack`
2. Visit `localhost` in web browser.
## start a custom site
### build docker image
$ docker build -t sitegen-openresty .
### generate a new site file
$ docker run --rm -w /opt -v $PWD:/opt sitegen-openresty sitegen new
### add an index page
$ docker run --rm -w /opt -v $PWD:/opt sitegen-openresty sitegen page /opt/ index
### add to `site.moon`
add "index.md"
### add config for nginx
$ mkdir logs/ conf/
# conf/nginx.conf
worker_processes 1;
error_log logs/error.log;
events {
worker_connections 1024;
}
http {
server {
listen 8080;
location / {
default_type text/html;
}
}
}
### build site
$ docker run --rm -w /opt/app -v $PWD:/opt/app sitegen-openresty sitegen
or
$ make build
### start server
$ docker run --rm -it --init -v $PWD:/opt/app -p 8080:8080 sitegen-openresty
or
$ make
### visit `localhost:8080` in web browser
### start watcher
$ docker exec -it container_name sitegen watch
## todo
* page titles
* draft documents
* treesitter highlighting for moonscript
* penlight library