inputPathToUrl Universal Filter

Pre-release only: v3.0.0-alpha.5 Map a file’s location and to the template’s output URL. Very useful for robust hyperlinking allowing you to change your output URLs without breaking content links!

Inspired by GitHub issue #84.

Usage Jump to heading #

<a href="{{ "index.md" | inputPathToUrl }}">Home</a>

<a href="{{ "index.md" | inputPathToUrl }}">Home</a>

module.exports = function (data) {
	return `<a href="${this.inputPathToUrl("index.md")}">Home</a>`;
};

export default function (data) {
	return `<a href="${this.inputPathToUrl("index.md")}">Home</a>`;
}

<a href="{{inputPathToUrl 'index.md'}}">Home</a>

Renders as <a href="/">Home</a>.

• The paths used here should be relative to the input directory though they can be relative to the project root (the former is simpler and more robust).
• If an inputPath match can not be found, this filter will throw an error.
• When pointing to a Pagination template, the first URL in the pagination set is returned.

← Back to Filters documentation.

Other pages in Filters:

• url
• slugify
• log
• get*CollectionItem
• inputPathToUrl