39 lines
2.2 KiB
Markdown
39 lines
2.2 KiB
Markdown
hatmill - HTML generation DSL for Go
|
|
=====================================
|
|
[](https://gitlab.codemonkeysoftware.net/b/hatmill/blob/master/COPYING)
|
|
[](https://gitlab.codemonkeysoftware.net/b/hatmill/commits/master)
|
|
[](https://goreportcard.com/report/gitlab.codemonkeysoftware.net/b/hatmill)
|
|
[](https://godoc.org/gitlab.codemonkeysoftware.net/b/hatmill)
|
|
|
|
|
|
`hatmill` provides a simple set of types and helper functions for writing HTML in plain Go code, without having to deal with any template languages. It is not spectacularly performant, but is comparable to the `html/template` package (at least in simple cases; run `go test -bench=. -benchmem` for proof). `hatmill` “templates” are arguably easier to read and write than many template languages.
|
|
|
|
`hatmill` uses [semantic versioning](https://semver.org/).
|
|
|
|
Installation
|
|
---------------
|
|
There are three necessary packages:
|
|
|
|
- `gitlab.codemonkeysoftware.net/b/hatmill`
|
|
- `gitlab.codemonkeysoftware.net/b/hatmill/attribute`
|
|
- `gitlab.codemonkeysoftware.net/b/hatmill/element`
|
|
|
|
Install them as you would any other Go package, with `go get` or whatever.
|
|
`gitlab.codemonkeysoftware.net/b/hatmill` is a Go module and so will play nicely
|
|
with Go ≥ 1.11.
|
|
|
|
Usage
|
|
------
|
|
Basic types are in `gitlab.codemonkeysoftware.net/b/hatmill`. The `attribute`
|
|
and `element` subpackages contain helper functions for HTML5 attributes and
|
|
elements. See the `Example` function in `hatmill_test.go`.
|
|
|
|
Hacking
|
|
--------
|
|
If there is a missing attribute or element helper function, describe it in
|
|
`defs.json` and run `go generate` in the repository root. If you can't figure
|
|
out what you need to know by reading `defs.json`, `internal/codegen/*`,
|
|
`attribute/*`, and `element/*`, then
|
|
[pester me](https://gitlab.codemonkeysoftware.net/b/hatmill/issues/new) to
|
|
improve the documentation.
|