92 lines
1.8 KiB
Markdown
92 lines
1.8 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
|
|
|
|
### lint moonscript
|
|
|
|
$ make lint
|
|
|
|
## gotchas
|
|
|
|
### What is `cosmo failed: [string "..."]:62: cannot resume dead coroutine`?
|
|
|
|
If you call `cosmo.yield`, your function **must** return `nil`! If you forget
|
|
to return `nil`, you will see this cryptic error:
|
|
|
|
Error: index.html -> html/index.html: cosmo failed: [string "..."]:62: cannot resume dead coroutine
|
|
make: *** [Makefile:6: build] Error 1`
|
|
|
|
## todo
|
|
|
|
* draft documents
|
|
* treesitter highlighting for moonscript
|
|
* penlight library
|