tiny.zen.BuildOptions

1/// Controls one source-tree to static-site publication.2pub const BuildOptions = struct {3    /// Existing source directory with Markdown, assets, and optional `.zen` files.4    source: []const u8,5    /// Destination directory. With `clean`, publication replaces it atomically.6    output: []const u8,7    /// Root-relative URL prefix such as `/docs`; use empty text at a host root.8    base: []const u8 = "",9    /// Hosted parent prefix whose root-relative references remain unchanged.10    parent_site_base: ?[]const u8 = null,11    /// In-memory theme used when source theme files do not override it.12    theme: theme.Theme = .{},13    /// Bounds HTML produced by the page theme.14    theme_render_limits: theme.RenderLimits = theme.default_render_limits,15    /// Builds in staging and replaces prior output when true.16    clean: bool = true,17    /// Writes `page/index.html` routes when true and `page.html` when false.18    clean_urls: bool = true,19    /// Copies hidden source paths other than the owned `.zen` theme path.20    copy_hidden: bool = false,21    /// Excludes README Markdown pages when true.22    skip_readme: bool = false,23    /// Source-relative prefixes omitted from pages and assets.24    exclude: []const []const u8 = &.{},25    /// Includes pages whose frontmatter sets `draft: true`.26    include_drafts: bool = false,27    /// Includes non-curated pages and marks them as slop.28    include_slop: bool = true,29    /// Default Markdown render mode unless page metadata selects slides.30    render_mode: markdown.Mode = .document,31    /// Publishes the source-bearing authored route manifest for local editing.32    publish_authored_routes: bool = false,33    /// Keeps one exact call-map stylesheet per rendered page when true.34    one_call_map_style_per_page: bool = true,35    /// Selects bounded theme files inside the source tree.36    theme_files: theme.Files = .{},37    /// Bounds retained page records and catalog text.38    catalog_limits: site_catalog.Limits = site_catalog.default_limits,39    /// Bounds the largest Markdown page read into reusable storage.40    page_limits: site_page.Limits = site_page.default_limits,41    /// Maximum bytes copied from one asset.42    asset_limit: usize = max_asset_bytes,43    /// Bounds frontmatter pairs and joined continuation bytes.44    frontmatter_limits: frontmatter.Limits = .{45        .max_pairs = site_page.default_limits.max_page_bytes,46        .max_continuation_bytes = site_page.default_limits.max_page_bytes,47    },48    /// Bounds headings per Markdown page.49    heading_limits: document.Limits = document.default_limits,50    /// Bounds footnotes per Markdown page.51    footnote_limits: footnote.Limits = footnote.default_limits,52    /// Bounds each quiz fence in a Markdown page.53    quiz_limits: quiz.Limits = quiz.default_limits,54    /// Bounds transformed target paths and public URLs.55    path_limits: site_path.Limits = site_path.default_limits,56    /// Receives source-relative page and repair detail after supported failures.57    diagnostic: ?*diagnostic.Diagnostic = null,58    /// Runs on the complete staging site before it can replace current output.59    before_publish: ?BeforePublish = null,60};

1/// Bounds and controls one source-tree to static-site publication.2pub const BuildOptions = site.BuildOptions;