docs: strip empty ps

Author: bennypowers

eleventy.config.cjs

@@ -3,6 +3,7 @@ const SyntaxHighlightPlugin = require('@11ty/eleventy-plugin-syntaxhighlight');
 const DirectoryOutputPlugin = require('@11ty/eleventy-plugin-directory-output');
 
 const PfeAssetsPlugin = require('./docs/_plugins/pfe-assets.cjs');
+const EmptyParagraphPlugin = require('./docs/_plugins/empty-p.cjs');
 
 const AnchorsPlugin = require('@patternfly/pfe-tools/11ty/plugins/anchors.cjs');
 const CustomElementsManifestPlugin = require('@patternfly/pfe-tools/11ty/plugins/custom-elements-manifest.cjs');
@@ -50,6 +51,9 @@ module.exports = function(eleventyConfig) {
   /** fancy syntax highlighting with diff support */
   eleventyConfig.addPlugin(SyntaxHighlightPlugin);
 
+  /** Strip empty paragraphs */
+  eleventyConfig.addPlugin(EmptyParagraphPlugin);
+
   /** Add IDs to heading elements */
   eleventyConfig.addPlugin(AnchorsPlugin, {
     exclude: /\/components\/.*\/demo\//,

tools/pfe-tools/11ty/plugins/empty-p.cjs

@@ -0,0 +1,20 @@
+const cheerio = require('cheerio');
+
+/**
+ * @param {import('@11ty/eleventy/src/UserConfig')} eleventyConfig
+ */
+module.exports = function(eleventyConfig) {
+  eleventyConfig.addTransform('delete-empty-p', async function(rawContent, outputPath) {
+    if (!outputPath || !outputPath.endsWith('.html')) {
+      return rawContent;
+    } else {
+      const $ = cheerio.load(rawContent);
+      $('p:empty').each(function() {
+        if (!this.attributes.length) {
+          $(this).remove();
+        }
+      });
+      return $.html();
+    }
+  });
+};