Lindenii Project Forge
Export functions intended to be used in HTML templates
// SPDX-License-Identifier: AGPL-3.0-only // SPDX-FileCopyrightText: Copyright (c) 2025 Runxi Yu <https://runxiyu.org> package forge import ( "net/url" "strings" )
// These are all trivial functions that are used in HTML templates. // See resources.go.
// These are all trivial functions that are intended to be used in HTML // templates.
// firstLine returns the first line of a string. func firstLine(s string) string {
// FirstLine returns the first line of a string. func FirstLine(s string) string {
before, _, _ := strings.Cut(s, "\n") return before }
// pathEscape escapes the input as an URL path segment. func pathEscape(s string) string {
// PathEscape escapes the input as an URL path segment. func PathEscape(s string) string {
return url.PathEscape(s) }
// queryEscape escapes the input as an URL query segment. func queryEscape(s string) string {
// QueryEscape escapes the input as an URL query segment. func QueryEscape(s string) string {
return url.QueryEscape(s) }
// dereference dereferences a pointer. func dereference[T any](p *T) T {
// Dereference dereferences a pointer. func Dereference[T any](p *T) T {
return *p }
// dereferenceOrZero dereferences a pointer. If the pointer is nil, the zero
// DereferenceOrZero dereferences a pointer. If the pointer is nil, the zero
// value of its associated type is returned instead.
func dereferenceOrZero[T any](p *T) T {
func DereferenceOrZero[T any](p *T) T {
if p != nil { return *p } var z T return z }
// minus subtracts two numbers. func minus(a, b int) int {
// Minus subtracts two numbers. func Minus(a, b int) int {
return a - b }
// SPDX-License-Identifier: AGPL-3.0-only // SPDX-FileCopyrightText: Copyright (c) 2025 Runxi Yu <https://runxiyu.org> package forge import ( "embed" "html/template" "io/fs" "github.com/tdewolff/minify/v2" "github.com/tdewolff/minify/v2/html" "go.lindenii.runxiyu.org/forge/internal/misc" ) //go:embed LICENSE source.tar.gz var embeddedSourceFS embed.FS //go:embed templates/* static/* //go:embed hookc/hookc git2d/git2d var embeddedResourcesFS embed.FS var templates *template.Template //nolint:gochecknoglobals // loadTemplates minifies and loads HTML templates. func loadTemplates() (err error) { minifier := minify.New() minifierOptions := html.Minifier{ TemplateDelims: [2]string{"{{", "}}"}, KeepDefaultAttrVals: true, } //exhaustruct:ignore minifier.Add("text/html", &minifierOptions) templates = template.New("templates").Funcs(template.FuncMap{
"first_line": firstLine, "path_escape": pathEscape, "query_escape": queryEscape, "dereference_error": dereferenceOrZero[error], "minus": minus,
"first_line": FirstLine, "path_escape": PathEscape, "query_escape": QueryEscape, "dereference_error": DereferenceOrZero[error], "minus": Minus,
}) err = fs.WalkDir(embeddedResourcesFS, "templates", func(path string, d fs.DirEntry, err error) error { if err != nil { return err } if !d.IsDir() { content, err := fs.ReadFile(embeddedResourcesFS, path) if err != nil { return err } minified, err := minifier.Bytes("text/html", content) if err != nil { return err } _, err = templates.Parse(misc.BytesToString(minified)) if err != nil { return err } } return nil }) return err }