38 lines
1.2 KiB
JavaScript
38 lines
1.2 KiB
JavaScript
|
const rehype = require('rehype');
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @dgProcessor postProcessHtml
|
||
|
|
*
|
||
|
|
* @description
|
||
|
|
* Use the rehype processing engine to manipulate the
|
||
|
|
* `renderedContent` HTML via rehype "plugins" that work with HTML ASTs (HASTs).
|
||
|
|
* See https://github.com/wooorm/rehype
|
||
|
|
*
|
||
|
|
* Each plugin is a factory function that will be called with the "rehype" engine as `this`.
|
||
|
|
* The factory should return a function that takes a HAST and returns a `boolean` or `undefined`.
|
||
|
|
* The HAST can be mutated by the this function.
|
||
|
|
* If `false` is returned then the processing stops with that plugin.
|
||
|
|
*
|
||
|
|
* @property docTypes {string[]} the `docTypes` of docs that should be post-processed
|
||
|
|
* @property plugins {Function[]} the rehype plugins that will modify the HAST.
|
||
|
|
*
|
||
|
|
*/
|
||
|
|
module.exports = function postProcessHtml() {
|
||
|
|
return {
|
||
|
|
$runAfter: ['docs-rendered'],
|
||
|
|
$runBefore: ['writing-files'],
|
||
|
|
docTypes: [],
|
||
|
|
plugins: [],
|
||
|
|
$process(docs) {
|
||
|
|
const engine = rehype()
|
||
|
|
.data('settings', { fragment: true });
|
||
|
|
this.plugins.forEach(plugin => engine.use(plugin));
|
||
|
|
|
||
|
|
docs
|
||
|
|
.filter(doc => this.docTypes.indexOf(doc.docType) !== -1)
|
||
|
|
.forEach(doc =>
|
||
|
|
doc.renderedContent = engine.processSync(doc.renderedContent).contents);
|
||
|
|
}
|
||
|
|
};
|
||
|
|
};
|