Resolve URLs

Resolve all URLs pointing to source files.

Description

The resolve_urls plugin converts all URLs in your HTML documents matching with any file in the src folder with the final URL.

For example, the following link pointing to a markdown file gets transformed:

Go to <a href="/about-us.md">About us</a>

If the page about-us.md has a different URL (because it has a url variable in the front matter), this plugin will use it accordingly. It also works with static files that change the output directory.

The plugin also resolves relative URLs (like ../about-us.md) and keeps any anchor or search query in the url (for example: /about-us.md#contact is replaced with /about-us/#contact).

A very common use case is a repository with documentation content in Markdown files. You may want the links to work in GitHub, but upon building the HTML site they change to the final urls.

Installation

Import this plugin in your _config.ts file to use it:

import lume from "lume/mod.ts";
import resolveUrls from "lume/plugins/resolve_urls.ts";

const site = lume();

site.use(resolveUrls());

export default site;