feat: add support to info, and tag, and schema custom tamplates

Author: fernandoseguim

demo/docusaurus.config.ts

@@ -297,7 +297,10 @@ const config: Config = {
               groupPathsBy: "tag",
               categoryLinkSource: "tag",
             },
-            template: "api.mustache", // Customize API MDX with mustache template
+            template: "templates/api.mustache", // Customize API MDX with mustache template
+            infoTemplate: "templates/info.mustache",
+            tagTemplate: "templates/tag.mustache",
+            schemaTemplate: "templates/schema.mustache",
             downloadUrl: "/petstore.yaml",
             hideSendButton: false,
             showSchemas: true,

demo/api.mustache renamed to demo/templates/api.mustache

@@ -0,0 +1,12 @@
+---
+id: {{{id}}}
+title: "{{{title}}}"
+description: "{{{frontMatter.description}}}"
+sidebar_label: "{{{title}}}"
+hide_title: true
+custom_edit_url: null
+---
+
+{{{markdown}}}
+
+Hello World!

demo/templates/info.mustache

@@ -0,0 +1,17 @@
+---
+id: {{{id}}}
+title: "{{{title}}}"
+description: "{{{frontMatter.description}}}"
+sidebar_label: "{{{title}}}"
+hide_title: true
+{{#schema}}
+hide_table_of_contents: true
+{{/schema}}
+schema: true
+sample: {{{frontMatter.sample}}}
+custom_edit_url: null
+---
+
+{{{markdown}}}
+
+Hello World!

demo/templates/schema.mustache

@@ -0,0 +1,10 @@
+---
+id: {{{id}}}
+title: "{{{frontMatter.description}}}"
+description: "{{{frontMatter.description}}}"
+custom_edit_url: null
+---
+
+{{{markdown}}}
+
+Hello World!

demo/templates/tag.mustache

@@ -117,6 +117,9 @@ export default function pluginOpenAPIDocs(
       specPath,
       outputDir,
       template,
+      infoTemplate,
+      tagTemplate,
+      schemaTemplate,
       markdownGenerators,
       downloadUrl,
       sidebarOptions,
@@ -236,7 +239,9 @@ show_extensions: true
 {{{markdown}}}
       `;
 
-      const infoMdTemplate = `---
+      const infoMdTemplate = infoTemplate
+        ? fs.readFileSync(infoTemplate).toString()
+        : `---
 id: {{{id}}}
 title: "{{{title}}}"
 description: "{{{frontMatter.description}}}"
@@ -255,7 +260,9 @@ import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
 \`\`\`
       `;
 
-      const tagMdTemplate = `---
+      const tagMdTemplate = tagTemplate
+        ? fs.readFileSync(tagTemplate).toString()
+        : `---
 id: {{{id}}}
 title: "{{{frontMatter.description}}}"
 description: "{{{frontMatter.description}}}"
@@ -272,7 +279,9 @@ import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
 \`\`\`
       `;
 
-      const schemaMdTemplate = `---
+      const schemaMdTemplate = schemaTemplate
+        ? fs.readFileSync(schemaTemplate).toString()
+        : `---
 id: {{{id}}}
 title: "{{{title}}}"
 description: "{{{frontMatter.description}}}"

packages/docusaurus-plugin-openapi-docs/src/index.ts

@@ -39,6 +39,9 @@ export const OptionsSchema = Joi.object({
         proxy: Joi.string(),
         outputDir: Joi.string().required(),
         template: Joi.string(),
+        infoTemplate: Joi.string(),
+        tagTemplate: Joi.string(),
+        schemaTemplate: Joi.string(),
         downloadUrl: Joi.string(),
         hideSendButton: Joi.boolean(),
         showExtensions: Joi.boolean(),

packages/docusaurus-plugin-openapi-docs/src/options.ts

@@ -35,6 +35,9 @@ export interface APIOptions {
   specPath: string;
   outputDir: string;
   template?: string;
+  infoTemplate?: string;
+  tagTemplate?: string;
+  schemaTemplate?: string;
   downloadUrl?: string;
   hideSendButton?: boolean;
   showExtensions?: boolean;