build

type Builder struct {
	ContentDir string
	PubDir     string
	// AssetsDir, if non-empty, is a directory of static assets (css/, js/)
	// to copy into PubDir. When empty the assets embedded in the binary are used.
	AssetsDir string
	// Debug, when true, adds a debug footer to every rendered page.
	Debug bool
	// BaseURL, if non-empty, is the scheme+host used to build absolute <loc>
	// URLs in sitemap.xml (e.g. "https://example.com"). When empty, no
	// sitemap.xml is written.
	BaseURL string
	// IncludeDrafts, when true, publishes pages with draft: true in their
	// front-matter instead of skipping them.
	IncludeDrafts bool
	// IncludePrivate, when true, renders the full body of pages with
	// private: yes in their front-matter. When false, the body is hidden
	// and a placeholder message is shown instead.
	IncludePrivate bool
	// contains filtered or unexported fields
}

type FrontMatter struct {
	// Core identification
	ID      string   `yaml:"id"`
	Title   string   `yaml:"title"`
	Layout  string   `yaml:"layout"`
	Draft   flexBool `yaml:"draft"`
	Private flexBool `yaml:"private"`
	Hide    flexBool `yaml:"hide"`

	// Page description
	Summary   string `yaml:"summary"`
	Category  string `yaml:"category"`
	Image     string `yaml:"image"`
	BasePath  string `yaml:"basepath"`
	TreeTitle string `yaml:"treetitle"`
	LastMod   string `yaml:"lastmod"`
	Converted bool   `yaml:"converted"`

	// Taxonomy
	Tags    []string `yaml:"tags"`
	Aliases []string `yaml:"aliases"`

	// Pagination (list pages only)
	First string `yaml:"first"`
	Last  string `yaml:"last"`
	Next  string `yaml:"next"`
	Prev  string `yaml:"prev"`

	// Person-specific
	Gender         string   `yaml:"gender"`
	Era            string   `yaml:"era"`
	Maturity       string   `yaml:"maturity"`
	Trade          string   `yaml:"trade"`
	GrampsID       string   `yaml:"grampsid"`
	Slug           string   `yaml:"slug"`
	WikiTreeID     string   `yaml:"wikitreeid"`
	MarkdownFormat string   `yaml:"markdownformat"`
	Ancestor       flexBool `yaml:"ancestor"`

	// Place-specific
	PlaceType    string `yaml:"placetype"`
	BuildingKind string `yaml:"buildingkind"`

	// Calendar-specific
	Month string `yaml:"month"`

	// Question/story-specific
	People     flexStrings         `yaml:"people"`
	Author     string              `yaml:"author"`
	Started    string              `yaml:"started"`
	Updated    string              `yaml:"updated"`
	Status     string              `yaml:"status"`
	Ai         string              `yaml:"ai"`
	StoryParts []map[string]string `yaml:"storyparts"`

	// Sidebar link lists (person pages)
	Links       []map[string]string `yaml:"links"`
	Descendants []map[string]string `yaml:"descendants"`

	// Sitemap control: {disable: "1"} suppresses the page from sitemap.xml
	Sitemap map[string]string `yaml:"sitemap"`
}

type NavEntry struct {
	URL   string
	Title string
}

type PageData struct {
	FrontMatter
	Body       template.HTML
	Tree       TreeData
	Section    string      // human-readable section name inferred from path (e.g. "Stories", "Research Diary")
	PrevEntry  NavEntry    // previous page in sequence (e.g. previous diary entry); zero if none
	NextEntry  NavEntry    // next page in sequence (e.g. next diary entry); zero if none
	Children   []childPage // non-nil when page uses diaryentries or storieshome layout
	DiaryYears []string    // descending list of diary years for sidebar nav (diaryhome and diaryentries only)
	Debug      bool        // true when the build was invoked with --debug
	PageLayout string      // resolved layout name, available to debug footer
}

type TreeData struct {
	Title    string
	BasePath string
}