Struct PublishedPages 

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

Where each source document is actually published: the file the site serves, keyed by the source markdown’s file name.

[rewrite_doc_link] used to derive a link’s target from the link’s own spelling — ../BUILD_PLAN_V2.md → ../BUILD_PLAN_V2.html — which is correct only while every document is served under its own stem. Site pages ended that: a page is published as its declared site-page: slug, and a slug is URL-safe by construction ([a-z0-9-]+), so docs/BUILD_PLAN_V2.md is served as build-plan-v2.html. The rewrite then pointed four correct repository links at a page that is never emitted — issue #446, live on roteiro.dev.

So the served name is looked up rather than guessed. The renderer is handed the index of what the site emits, which is the only thing that knows the answer.

Keyed by file name rather than by full path because the site mirrors the repository’s layout — docs/*.md at the root, docs/adr/*.md under adr/ — so a link’s directory hops are already correct and only the final segment can differ. A file name claimed by two published documents is recorded as ambiguous and left unrewritten: guessing which one a link meant is how a link silently points at the wrong page, which is worse than the 404 it replaces.

Implementations

impl PublishedPages

pub fn new() -> Self

An empty index: every .md link falls back to its own stem.

pub fn publish(&mut self, source_file: &str, served_as: &str)

Record that source_file (a markdown file name, e.g. BUILD_PLAN_V2.md) is served as served_as (e.g. build-plan-v2.html).

A second, differing claim on one file name makes it ambiguous; see the type’s documentation for why that is left unrewritten.

Trait Implementations

impl Clone for PublishedPages

fn clone(&self) -> PublishedPages

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PublishedPages

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

Formats the value using the given formatter.

impl Default for PublishedPages

fn default() -> PublishedPages

Returns the “default value” for a type.

impl Eq for PublishedPages

impl PartialEq for PublishedPages

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PublishedPages