Something went wrong. Try again.
[READ-ONLY] Mirror of https://github.com/glacials/winter. a thoughtful static website generator for long-lasting content twos.dev/winter
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174package document // import "twos.dev/winter/document"
import ( "fmt" "html/template" "io" "path/filepath" "strings" "time"
"github.com/adrg/frontmatter")
var textDocExts = map[string]struct{}{ ".htm": {}, ".html": {}, ".md": {}, ".markdown": {}, ".org": {}, ".tmpl": {},}
// Metadata holds information about a Document that isn't inside the document itself.type Metadata struct { // Category is an optional category for the document. This is used // only for a small visual treatment on the index page (if this is // of kind post) and on the document page itself. // // Category MUST be a singular noun that can be pluralized by adding // a single "s" at its end, as this is exactly what the visual // treatment will do. If this doesn't work for you, go fix that // code. Category string `yaml:"category,omitempty"` // PublishedAt is the time the document was first published. // The canonical frontmatter key is published; date remains an input alias. PublishedAt time.Time `yaml:"published,omitempty"` // Kind specifies the type of document this is. // In every user-facing context, this is called "type". // In Go we cannot use the "type" keyword, so we use "kind" instead. Kind kind `yaml:"type,omitempty"` // Layout is the path to the source file for the layout this document should be rendered into. // // If unset, src/templates/text_document.html.tmpl is used. Layout string `yaml:"layout,omitempty"` // GeminiPath is the path component of the Geminispace URL that will point to this document, // once rendered. // GeminiPath MUST NOT contain any slashes; // everything is top-level. // // GeminiPath is equivalent to the path to the destination file relative to dist. GeminiPath string `yaml:"-,omitempty"` // ParentFilename is the filename component of another document that this one is a child of. // Parenthood is a purely semantic relationship for the benefit of the user. // Templates can access parents to influence rendering. ParentFilename string `yaml:"parent,omitempty"` // Preview is a sentence-long blurb of the document, // to be shown along with its title as a teaser of its contents. Preview string `yaml:"preview,omitempty"` // SourcePath is the location on disk of the original file that this document represents. // It is relative to the working directory. SourcePath string `yaml:"-"` // TemplateDir is the location on disk of a directory containing any templates that will be used in the document. // By default, it is src/templates. TemplateDir string `yaml:"-"` // Title is the human-readable title of the document. Title string `yaml:"title,omitempty"` // TOC is whether a table of contents should be rendered with the // document. If true, the table of contents is rendered immediately // above the first non-first-level heading. TOC bool `yaml:"toc,omitempty"` // CreatedAt is the time work on the document began. CreatedAt time.Time `yaml:"created,omitempty"` // UpdatedAt is the time the document was last meaningfully updated. UpdatedAt time.Time `yaml:"updated,omitempty"` // WebPath is the path component of the URL that will point to this document, // once rendered. // WebPath MUST NOT contain any slashes; // everything is top-level. // // WebPath is equivalent to the path to the destination file // relative to dist. WebPath string `yaml:"filename,omitempty"`}
// NewMetadata returns a Metadata with some defaults filled in// according path src.//// NewMetadata is purely lexicographic;// no files are opened or read.//// Defaults that depend on parsing the content of the document,// such as a Preview generated from its content,// are not filled in.func NewMetadata(src, tmplDir string) *Metadata { filename := filepath.Base(src) i := strings.IndexRune(filename, '.') if i < 0 { i = len(filename) } noExt := filename[0:i] webPath := noExt geminiPath := "" // Can't have Gemini files overwriting extensionless "web" files like CNAME if _, ok := textDocExts[filepath.Ext(src)]; ok { webPath = fmt.Sprintf("%s.html", noExt) geminiPath = fmt.Sprintf("%s.gmi", noExt) } return &Metadata{ GeminiPath: geminiPath, Kind: draft, Layout: filepath.Join(tmplDir, "text_document.html.tmpl"), SourcePath: src, TemplateDir: tmplDir, WebPath: webPath, }}
func (meta *Metadata) IsType(t string) bool { k, err := parseKind(t) if err != nil { return false } return k == meta.Kind}
// UnmarshalDocument parses the metadata from the given reader,// then reads and returns the remaining bytes.func (meta *Metadata) UnmarshalDocument(r io.Reader) ([]byte, error) { b, err := frontmatter.Parse(r, &meta) if err != nil { return nil, fmt.Errorf("cannot load frontmatter: %w", err) } return b, nil}
// UnmarshalYAML accepts date as a compatibility alias for published.// When both are set, published takes precedence regardless of key order.func (meta *Metadata) UnmarshalYAML(unmarshal func(interface{}) error) error { type plainMetadata Metadata decoded := plainMetadata(*meta) if err := unmarshal(&decoded); err != nil { return err } var dates struct { Published *time.Time `yaml:"published"` Date *time.Time `yaml:"date"` } if err := unmarshal(&dates); err != nil { return err } if dates.Published == nil && dates.Date != nil { decoded.PublishedAt = *dates.Date } *meta = Metadata(decoded) return nil}
// funcmap returns a [template.FuncMap] for the document.// It can be used with [html/template.Template.Funcs].func (meta *Metadata) funcmap() template.FuncMap { now := time.Now()
return template.FuncMap{ "add": add, "div": div, "mul": mul, "sub": sub,
"now": func() time.Time { return now },
"render": render, "yearly": yearly, }}