module

Hwaro::Content::Versions

Instance methods

lang_prefix(page : Models::Page, config : Models::Config) : String

"" for the default language, "/" otherwise — the same prefix PermalinkResolver puts in front of every non-default-language URL.

Source
link!(pages : Array(Models::Page), config : Models::Config) : Nil

Fill page.version_links for every versioned page and, when the latest version does NOT render at its parent's root, alias the parent URL (/docs/, /ko/docs/) to the latest version's root so the natural docs URL never 404s.

Counterparts are matched by (version, language, path relative to the version directory) — docs/v1/install.md ↔ docs/v2/install.md, docs/v1/install.ko.md ↔ docs/v2/install.ko.md. A headless (render = false) counterpart is never written, so it does not count as existing.

Source
page_version_value(page : Models::Page, config : Models::Config) : Crinja::Value

page.version object: {name, label, latest, url}. url is the root URL of the version in the page's language (see root_url).

Source
root_url(config : Models::Config, version : Models::VersionConfig, prefix : String) : String

Root URL of version for a language prefix: the root section in that language, else (a partial translation) the default language's root, never the unwritten /<lang>/… URL. The computed URL is the last resort when no root section exists at all.

Source
version_link_value(link : Models::VersionLink) : Crinja::Value
Source
version_links_value(page : Models::Page) : Crinja::Value
Source
version_value(version : Models::VersionConfig, url : String) : Crinja::Value
Source
versions_value(config : Models::Config, lang_prefix : String) : Crinja::Value

The global versions variable for one language prefix: iterable ({% for v in versions %}) AND attribute-addressable (versions.latest, versions.all, versions.size).

Source

Nested types