@11ty/posthtml-urls

PostHTML plugin for transforming URLs. This is a fork of posthtml/posthtml-urls.

Installation

Node.js >= 6 is required. To install, type this at the command line:

1npm install @11ty/posthtml-urls

Usage

1const posthtml = require('posthtml');
2const urls = require('@11ty/posthtml-urls');
3
4const options = {
5  eachURL: (url, attr, tagName) => `http://domain.com/${url}`
6};
7
8posthtml()
9  .use( urls(options) )
10  .process('<a href="link.html">link</a>')
11  .then(result => console.log(result.html));
12//-> <a href="http://domain.com/link.html">link</a>

Options

eachURL

Type: Function Default value: undefined A callback function ran for each URL value found. You can return either a synchronous value or a Promise.

filter

Type: Object Default value: {…} The elements and attributes for which to search. An attribute value can optionally be a function, for deeper filtering.

FAQ

1. How can I filter <style> elements and style attributes? Use posthtml-postcss and postcss-url.