Struct BuildOptions 

pub struct BuildOptions {
    pub base_url: Option<String>,
    pub output_dir: PathBuf,
    pub static_dir: PathBuf,
    pub clean_output_dir: bool,
    pub assets: AssetsOptions,
}

Maudit build options. Should be passed to coronate().

Examples

Default values:

use maudit::{
 content_sources, coronate, routes, BuildOptions, BuildOutput,
};

fn main() -> Result<BuildOutput, Box<dyn std::error::Error>> {
  coronate(
    routes![],
    content_sources![],
    BuildOptions::default(),
  )
}

Custom values:

use maudit::{
  content_sources, coronate, routes, BuildOptions, BuildOutput, AssetsOptions,
};

fn main() -> Result<BuildOutput, Box<dyn std::error::Error>> {
  coronate(
    routes![],
    content_sources![],
    BuildOptions {
      output_dir: "public".into(),
      static_dir: "static".into(),
      assets: AssetsOptions {
        assets_dir: "_assets".into(),
        tailwind_binary_path: "./node_modules/.bin/tailwindcss".into(),
        ..Default::default()
      },
      ..Default::default()
    },
  )
}

Fields

base_url: Option<String>

Base URL for the site, e.g. https://example.com or https://example.com/subdir. This value is used to generate canonical URLs and can be used wherever the full site URL is needed (e.g. in SEO meta tags) through PageContext::base_url in pages.

output_dir: PathBuf

static_dir: PathBuf

clean_output_dir: bool

Whether to clean the output directory before building.

At the speed Maudit operates at, not cleaning the output directory may offer a significant performance improvement at the cost of potentially serving stale content.

assets: AssetsOptions

Implementations

impl BuildOptions

pub fn route_assets_options(&self) -> RouteAssetsOptions

Returns the fully resolved assets options, with the output_assets_dir property resolved to be inside output_dir. e.g. if output_dir is dist and assets.assets_dir is _maudit, output_assets_dir will return dist/_maudit. The user-entered assets.assets_dir is also available and unchanged.

Trait Implementations

impl Default for BuildOptions

Provides default values for crate::coronate(). Designed to work for most projects.

Examples

use maudit::{
 content_sources, coronate, routes, BuildOptions, BuildOutput,
};

fn main() -> Result<BuildOutput, Box<dyn std::error::Error>> {
  coronate(
    routes![],
    content_sources![],
    BuildOptions::default(),
  )
}

fn default() -> BuildOptions

Returns the “default value” for a type.