Struct Link 

pub struct Link {
    pub text: String,
    pub target: String,
    pub kind: LinkKind,
}

A markdown link found in a concept body.

Fields

text: String

The link text (between [ and ]).

target: String

The raw destination (between ( and )), with any title removed.

kind: LinkKind

The classification of Link::target.

Implementations

impl Link

pub fn classify(target: &str) -> LinkKind

Classifies a raw target string.

pub fn resolve(&self, source: &ConceptId) -> Option<ConceptId>

Resolves an internal link to the concept id it points at, given the id of the concept the link appears in.

Returns None for external links, anchors, links to directories (targets ending in /), or targets that cannot form a valid concept id. The result is not guaranteed to exist in the bundle: broken links are permitted by the spec.

Where a target is percent-encoded this returns the literal reading; use Link::resolve_all to also consider the decoded one.

pub fn resolve_all(&self, source: &ConceptId) -> Vec<ConceptId>

Every concept id this link may denote, most likely first.

A markdown destination is a URL, so a concept whose filename contains a space is normally linked as /tables/my%20notes.md. Decoding is offered as a second candidate rather than applied outright, so that a file genuinely named my%20notes.md still resolves by its literal spelling. Callers should prefer the first candidate that exists in the bundle.

pub fn target_without_anchor(&self) -> &str

Returns the target with any anchor fragment removed.

pub fn anchor(&self) -> Option<&str>

Returns the anchor fragment, if one was present.

Trait Implementations

impl Clone for Link

fn clone(&self) -> Link

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Link

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

Formats the value using the given formatter.

impl Eq for Link

impl PartialEq for Link

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Link