diff options
author | 2020-02-11 17:42:10 +0100 | |
---|---|---|
committer | 2020-02-11 17:42:10 +0100 | |
commit | 0a56365672dab47d27a57d703aeb33477c60b10c (patch) | |
tree | 94de7fdade68804285db7c4beb2e4fabb2e20550 /README.md | |
parent | 02b59bc3650bab684f4661f7a75b96f19c6fa87b (diff) | |
download | alps-0a56365672dab47d27a57d703aeb33477c60b10c.tar.gz alps-0a56365672dab47d27a57d703aeb33477c60b10c.tar.bz2 alps-0a56365672dab47d27a57d703aeb33477c60b10c.zip |
docs/themes-and-plugins: extract from README
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 39 |
1 files changed, 0 insertions, 39 deletions
@@ -16,45 +16,6 @@ To manually specify upstream servers: See `docs/cli.md` for more information. -## Themes - -They should be put in `themes/<name>/`. - -Templates in `themes/<name>/*.html` override default templates in plugins. -Assets in `themes/<name>/assets/*` are served by the HTTP server at -`/themes/<name>/assets/*`. - -## Plugins - -Plugins can be written in Go or in Lua and live in `plugins/<name>/`. - -Plugins can provide their own templates in `plugins/<name>/public/*.html`. -Assets in `plugins/<name>/public/assets/*` are served by the HTTP server at -`/plugins/<name>/assets/*`. - -### Go plugins - -They can use the [Go plugin helpers] and need to be included at compile-time in -`cmd/koushin/main.go`. - -### Lua plugins - -The entry point is at `plugins/<name>/main.lua`. - -API: - -* `koushin.on_render(name, f)`: prior to rendering the template `name`, call - `f` with the template data (the special name `*` matches all templates) -* `koushin.set_filter(name, f)`: set a template function -* `koushin.set_route(method, path, f)`: register a new HTTP route, `f` will be - called with the HTTP context - -## Hot reload - -Lua plugins and templates can be reloaded by sending `SIGUSR1` to koushin. - - killall -USR1 koushin - ## Contributing Send patches on the [mailing list], report bugs on the [issue tracker]. |