Struct Source 

pub struct Source<SourceMeta = (), EntryMeta = ()>
where
    SourceMeta: Meta,
    EntryMeta: Meta,
{
    pub title: String,
    pub root: PathBuf,
    pub origin: String,
    pub prefix: String,
    pub entries: Vec<Entry<EntryMeta>>,
    pub static_entries: Vec<StaticEntry>,
    pub stylesheets: Vec<PathBuf>,
    pub javascript: Vec<PathBuf>,
    pub icon: Option<PathBuf>,
    pub well_known: Option<PathBuf>,
    pub meta: SourceMeta,
}

The Source object reads and interprets a source directory.

The fields are intentionally public. Feel free to manually generate or modify this structure.

Fields

title: String

The website’s title.

By default, this field is read from gazetta.yaml.

root: PathBuf

The source root directory.

This is specified on construction.

origin: String

The website origin (http://mydomain.com:1234)

By default, this field is derived from the value of base in gazetta.yaml.

prefix: String

The directory under the origin at which this site will be hosted (e.g. “/”).

By default, this field is derived from the value of base in gazetta.yaml.

entries: Vec<Entry<EntryMeta>>

The website content to be rendered.

By default, this list is populated with Entries generated from files with the basename index under the root directory excluding:

1. Files under directories named “static”.

2. Files under assets/.

static_entries: Vec<StaticEntry>

The website content to be deployed as-is (no rendering).

By default, this list is populated with directories under the root directory named “static” excluding:

1. Directories under directories named “static”.

2. Directories under assets/.

stylesheets: Vec<PathBuf>

The website stylesheets. When rendered, these will be concatenated into a single stylesheet.

By default, this list is populated by the files in is assets/stylesheets/ in lexicographical order.

javascript: Vec<PathBuf>

The website javascript. When rendered, these will be concatenated into a single javascript file.

By default, this list is populated by the files in is assets/javascript/ in lexicographical order.

icon: Option<PathBuf>

The path to the website’s icon.

By default, this points to assets/icon.png (if it exists).

well_known: Option<PathBuf>

The path to the .well-known directory.

By default, this points to .well-known.

meta: SourceMeta

Additional metadata read from gazetta.yaml.

Implementations

impl<SourceMeta, EntryMeta> Source<SourceMeta, EntryMeta>

where SourceMeta: Meta, EntryMeta: Meta,

pub fn index<'a>( &'a self, ) -> Result<IndexedSource<'a, SourceMeta, EntryMeta>, SourceError>

Build the IndexedSource for this Source.

pub fn new<P: AsRef<Path>>(root: P) -> Result<Self, AnnotatedError<SourceError>>

Parse a source directory to create a new source.

pub fn reload(&mut self) -> Result<(), AnnotatedError<SourceError>>

Reload from the source directory.

Call this after changing source files.

Trait Implementations

impl<SourceMeta, EntryMeta> Clone for Source<SourceMeta, EntryMeta>

where SourceMeta: Meta + Clone, EntryMeta: Meta + Clone,

fn clone(&self) -> Source<SourceMeta, EntryMeta>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<SourceMeta, EntryMeta> Debug for Source<SourceMeta, EntryMeta>

where SourceMeta: Meta + Debug, EntryMeta: Meta + Debug,

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

Formats the value using the given formatter.