Struct SiteConfig 

pub struct SiteConfig {
    pub site_title: String,
    pub assets_dir: String,
    pub site_description_file: String,
    pub colors: ColorConfig,
    pub thumbnails: ThumbnailsConfig,
    pub full_index: FullIndexConfig,
    pub images: ImagesConfig,
    pub theme: ThemeConfig,
    pub font: FontConfig,
    pub processing: ProcessingConfig,
}

Site configuration loaded from config.toml.

All fields have sensible defaults. User config files need only specify the values they want to override. Unknown keys are rejected.

Fields

site_title: String

Site title used in breadcrumbs and the browser tab for the home page.

assets_dir: String

Directory for static assets (favicon, fonts, etc.), relative to content root. Contents are copied verbatim to the output root during generation. If the directory doesn’t exist, it is silently skipped.

site_description_file: String

Stem of the site description file in the content root (e.g. site → looks for site.md / site.txt). Rendered on the index page.

colors: ColorConfig

Color schemes for light and dark modes.

thumbnails: ThumbnailsConfig

Thumbnail generation settings (aspect ratio, size).

full_index: FullIndexConfig

Site-wide “All Photos” index settings.

images: ImagesConfig

Responsive image generation settings (sizes, quality).

theme: ThemeConfig

Theme / layout settings (mats, grid spacing).

font: FontConfig

Font configuration (Google Fonts or local font file).

processing: ProcessingConfig

Parallel processing settings.

Implementations

impl SiteConfig

pub fn validate(&self) -> Result<(), ConfigError>

Validate semantic constraints that confique’s type system can’t express: numeric ranges, non-empty arrays, and so on.

Wired into clapfig’s .post_validate() hook in load_config so every loaded config (CLI, cascade leaf, test fixture) runs the same checks.

Trait Implementations

impl Clone for SiteConfig

fn clone(&self) -> SiteConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Config for SiteConfig

const META: Meta

A description of this configuration.

type Layer = SiteConfigLayer

A layer of Self (a potentially partial configuration).

fn from_layer(layer: Self::Layer) -> Result<Self, Error>

Tries to create Self from a layer and validates itself.

fn builder() -> Builder<Self>

Convenience builder to configure, load and merge multiple configuration sources. Sources specified earlier have a higher priority; later sources only fill in the gaps. After all sources have been loaded, the default values (usually specified with #[default = ...]) are merged (with the lowest priority).

fn from_file(path: impl Into<PathBuf>) -> Result<Self, Error>

Load the configuration from a single file.

impl Debug for SiteConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SiteConfig

fn default() -> Self

Construct a SiteConfig populated entirely from confique-declared defaults. Used by tests and by the scan stage to seed the cascade before any user config.toml is layered on.

impl<'de> Deserialize<'de> for SiteConfig

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Custom deserialize that funnels any input (TOML config file, JSON manifest field, test fixture) through the same sparse-layer + fill-defaults pipeline load_config uses.

Without this, missing fields on a directly-deserialized SiteConfig would be hard errors instead of falling through to confique-declared defaults — which would force every manifest writer (and every test fixture) to spell out every field explicitly.

impl PartialEq for SiteConfig

fn eq(&self, other: &SiteConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for SiteConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SiteConfig