Struct comrak::html::Anchorizer

pub struct Anchorizer(/* private fields */);

Converts header Strings to canonical, unique, but still human-readable, anchors.

To guarantee uniqueness, an anchorizer keeps track of the anchors it has returned. So, for example, to parse several MarkDown files, use a new anchorizer per file.

Example

use comrak::Anchorizer;

let mut anchorizer = Anchorizer::new();

// First "stuff" is unsuffixed.
assert_eq!("stuff".to_string(), anchorizer.anchorize("Stuff".to_string()));
// Second "stuff" has "-1" appended to make it unique.
assert_eq!("stuff-1".to_string(), anchorizer.anchorize("Stuff".to_string()));

Implementations

impl Anchorizer

pub fn new() -> Self

Construct a new anchorizer.

pub fn anchorize(&mut self, header: String) -> String

Returns a String that has been converted into an anchor using the GFM algorithm, which involves changing spaces to dashes, removing problem characters and, if needed, adding a suffix to make the resultant anchor unique.

use comrak::Anchorizer;

let mut anchorizer = Anchorizer::new();

let source = "Ticks aren't in";

assert_eq!("ticks-arent-in".to_string(), anchorizer.anchorize(source.to_string()));

Trait Implementations

impl Debug for Anchorizer

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

Formats the value using the given formatter.

impl Default for Anchorizer

fn default() -> Anchorizer

Returns the “default value” for a type.