aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorBrian Picciano <me@mediocregopher.com>2024-07-03 12:36:05 +0200
committerBrian Picciano <me@mediocregopher.com>2024-07-03 12:36:05 +0200
commit7e1ecc4df44d20d2c9de1c8885ddc2c188062ef0 (patch)
treeac31b787dbaf6c3c702b508e9529d62ceb221923 /README.md
parent1a6d506a525e32bc374f89377e46a775c6737cf0 (diff)
Initial implementation of the gemtext template extension
Diffstat (limited to 'README.md')
-rw-r--r--README.md28
1 files changed, 28 insertions, 0 deletions
diff --git a/README.md b/README.md
index 52f3019..2a146ba 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,34 @@
TODO proper introduction
+## Build
+
+TODO
+
+## Plugins
+
+The following plugins are implemented in this module.
+
+### http.handlers.templates.functions.gemtext
+
+This extension to `templates` allows for rendering a [gemtext][gemtext] string
+as a roughly equivalent set of HTML tags. It is similar to the [markdown template
+function][mdfunc] in its usage. It can be enabled by being included in the
+`templates.extensions` set.
+
+```
+templates {
+ extensions {
+ gemtext
+ }
+}
+```
+
+See the `template.localhost` virtual host in `example/Caddyfile` for an example
+of using the `gemtext` template to render a gemtext file within an HTML file.
+
+[gemtext]: https://geminiprotocol.net/docs/gemtext.gmi
+
## Development
A nix-based development environment is provided with the correct versions of all