DOC-2608: Move input and output file names into Antora playbook config

Author: Farzad Hayatbakhsh

antora-playbook-local.yml

@@ -19,6 +19,8 @@ asciidoc:
     - '@tinymce/antora-extension-livedemos'
 antora:
   extensions:
-    - './lib/rssfeed.cjs'
+    - require: './lib/rssfeed.cjs'
+      input_file: 'changelog.adoc'
+      output_file: 'rss.xml'
 runtime:
   fetch: true

antora-playbook.yml

@@ -21,6 +21,8 @@ asciidoc:
     - '@tinymce/antora-extension-livedemos'
 antora:
   extensions:
-    - './lib/rssfeed.cjs'
+    - require: './lib/rssfeed.cjs'
+      input_file: 'changelog.adoc'
+      output_file: 'rss.xml'
 runtime:
   fetch: true

lib/rssfeed.cjs

@@ -2,15 +2,16 @@
 
 const cheerio = require("cheerio");
 
-module.exports.register = function () {
+module.exports.register = function ({ config }) {
     this.on("beforePublish", ({ siteCatalog, contentCatalog, playbook }) => {
         try {
             // Find the changelog page
-            const page = contentCatalog.findBy({ basename: "changelog.adoc" })[0];
+            const page = contentCatalog.findBy({
+                basename: config.inputFile,
+            })[0];
 
             if (!page) {
-                console.error("changelog.adoc page not found.");
-                return;
+                throw new Error(`${config.inputFile} page not found.`);
             }
 
             // Destructure page attributes
@@ -92,8 +93,9 @@ module.exports.register = function () {
             // Add RSS feed to site catalog
             siteCatalog.addFile({
                 contents: Buffer.from(rss),
-                out: { path: "rss.xml" },
+                out: { path: config.outputFile },
             });
+            console.log(`RSS feed generated at ${config.outputFile}`);
         } catch (error) {
             // Catch any errors to allow the build to continue
             console.error("Error generating RSS feed:", error);