summaryrefslogtreecommitdiff
path: root/src/post/preprocess.go
blob: 77aea81d0f0be34d71bdc7e2b4517475540230ef (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
package post

import (
	"fmt"
	"io"
	"text/template"
)

// PreprocessFunctions are functions which can be used by posts themselves to
// interleave dynamic content into their bodies. Usually this is used for
// properly constructing URLs, but also for things like displaying images.
type PreprocessFunctions struct {

	// BlogURL returns the given string, rooted to the blog's base url (which
	// may or may not include path components itself).
	//
	// The given path should not have a leading slash.
	BlogURL func(path string) string

	// BlogHTTPURL returns the given string, rooted to the base URL of the
	// blog's HTTP server (which may or may not include path components itself).
	//
	// The given path should not have a leading slash.
	BlogHTTPURL func(path string) string

	// BlogGeminiURL returns the given string, rooted to the base URL of the
	// blog's gemini server (which may or may not include path components
	// itself).
	//
	// The given path should not have a leading slash.
	BlogGeminiURL func(path string) string

	// AssetURL returns the URL of the asset with the given ID.
	AssetURL func(id string) string

	// PostURL returns the URL of the post with the given ID.
	PostURL func(id string) string

	// StaticURL returns the URL of a file being served from the static
	// directory. The given path should _not_ include the prefixed 'static/'
	// path element.
	StaticURL func(path string) string

	// Image returns a string which should be inlined into the post body in
	// order to display an.
	//
	// The first argument to Image _must_ be the ID of an image asset. The
	// second argument _may_ be a description of the image which will be used as
	// alt text, or possibly displayed to the user with the image.
	Image func(args ...string) (string, error)
}

func (funcs PreprocessFunctions) ToFuncMap() template.FuncMap {
	return template.FuncMap{
		"BlogURL":       funcs.BlogURL,
		"BlogHTTPURL":   funcs.BlogHTTPURL,
		"BlogGeminiURL": funcs.BlogGeminiURL,
		"AssetURL":      funcs.AssetURL,
		"PostURL":       funcs.PostURL,
		"StaticURL":     funcs.StaticURL,
		"Image":         funcs.Image,
	}
}

// PreprocessBody interprets the Post's Body as a text template which may use
// any of the functions found in PreprocessFunctions (all must be set). It
// executes the template and writes the result to the given writer.
func (p Post) PreprocessBody(into io.Writer, funcs PreprocessFunctions) error {

	tpl := template.New("")

	tpl.Funcs(funcs.ToFuncMap())

	tpl, err := tpl.Parse(p.Body)

	if err != nil {
		return fmt.Errorf("parsing post body as template: %w", err)
	}

	if err := tpl.Execute(into, nil); err != nil {
		return fmt.Errorf("executing post body as template: %w", err)
	}

	return nil
}