Struct mdbook::renderer::RenderContext

pub struct RenderContext {
    pub version: String,
    pub root: PathBuf,
    pub book: Book,
    pub config: Config,
    pub destination: PathBuf,
    // some fields omitted
}

The context provided to all renderers.

Fields

version: String

Which version of mdbook did this come from (as written in mdbook's Cargo.toml). Useful if you know the renderer is only compatible with certain versions of mdbook.

root: PathBuf

The book's root directory.

book: Book

A loaded representation of the book itself.

config: Config

The loaded configuration file.

destination: PathBuf

Where the renderer must put any build artefacts generated. To allow renderers to cache intermediate results, this directory is not guaranteed to be empty or even exist.

Methods

impl RenderContext

pub fn new<P, Q>(
    root: P,
    book: Book,
    config: Config,
    destination: Q
) -> RenderContext where
    P: Into<PathBuf>,
    Q: Into<PathBuf>, 

Create a new RenderContext.

pub fn source_dir(&self) -> PathBuf

Get the source directory's (absolute) path on disk.

pub fn from_json<R: Read>(reader: R) -> Result<RenderContext>

Load a RenderContext from its JSON representation.

Trait Implementations

impl PartialEq<RenderContext> for RenderContext

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Clone for RenderContext

fn clone(&self) -> RenderContext

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RenderContext

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

Formats the value using the given formatter.

impl Serialize for RenderContext

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

Serialize this value into the given Serde serializer.

impl<'de> Deserialize<'de> for RenderContext

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.