Struct Context

pub struct Context {
    pub destination: PathBuf,
    pub frontmatter: Frontmatter,
    /* private fields */
}

Context holds metadata about a note which is being parsed.

This is used internally to keep track of nesting and help with constructing proper references to other notes.

It is also passed to postprocessors to provide contextual information and allow modification of a note’s frontmatter.

Fields

destination: PathBuf

The path where this note will be written to when exported.

Changing this path will result in the note being written to that new path instead, but beware: links will not be updated automatically. If this is changed by a postprocessor, it’s up to that postprocessor to rewrite any existing links to this new path.

frontmatter: Frontmatter

The Frontmatter for this note. Frontmatter may be modified in-place (see serde_yaml::Mapping for available methods) or replaced entirely.

Example

Insert foo: bar into a note’s frontmatter:

use obsidian_export::serde_yaml::Value;

let key = Value::String("foo".to_string());

context
    .frontmatter
    .insert(key.clone(), Value::String("bar".to_string()));

Implementations

impl Context

pub fn new(src: PathBuf, dest: PathBuf) -> Self

Create a new Context

pub fn from_parent(context: &Self, child: &Path) -> Self

Create a new Context which inherits from a parent Context.

pub fn current_file(&self) -> &PathBuf

Return the path of the file currently being parsed.

pub fn root_file(&self) -> &PathBuf

Return the path of the root file.

Typically this will yield the same element as current_file, but when a note is embedded within another note, this will return the outer-most note.

pub fn note_depth(&self) -> usize

Return the note depth (nesting level) for this context.

pub fn file_tree(&self) -> Vec<PathBuf>

Return the list of files associated with this context.

The first element corresponds to the root file, the final element corresponds to the file which is currently being processed (see also current_file).

Trait Implementations

impl Clone for Context

fn clone(&self) -> Context

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Context

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

Formats the value using the given formatter.