Template loading for golang, improved.
| examples | ||
| go.mod | ||
| LICENSE.md | ||
| loader.go | ||
| Makefile | ||
| README.md | ||
Template loader
TL works like template.Glob(), but has a few improvements:
- TL loads templates from nested directories.
- TL uses relative file path as a template name to avoid collisions.
- Optional prefix may be added to a template name.
- TL supports shared templates.
Example
- Project structure:
.
├── main.go
└── templates
├── icons
│ └── material
│ └── favicon.svg
├── layouts
│ └── base.html
└── pages
└── index.html
- main.go:
package main
import (
"bufio"
"log/slog"
"os"
"code.app-house.ru/go/tl"
)
func main() {
templates, err := tl.LoadWithOptions(
// Main templates.
tl.Collection{
RootDir: "templates/pages",
},
tl.Options{
SharedCollections: []tl.Collection{
tl.Collection{
RootDir: "templates/layouts",
Prefix: "layouts", // template name prefix, may be omitted.
},
tl.Collection{
RootDir: "templates/icons",
Prefix: "icons",
},
// you can add other collections (e.g. snippets, components...)
},
},
)
if err != nil {
slog.Error("can't load templates", "err", err)
os.Exit(-1)
}
w := bufio.NewWriter(os.Stdout)
err = templates["index.html"].Execute(w, nil)
if err != nil {
slog.Error("can't execute index.html", "err", err)
os.Exit(-1)
}
w.Flush()
}
- layouts/base.html:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
</head>
<body>
{{ block "main" . }}{{ end }}
</body>
</html>
- pages/index.html:
{{ template "layouts/base.html" . }}
{{ define "main" }}
{{ template "icons/material/favicon.svg" . }}
<h1>Index</h1>
{{ end }}