From 7ab97d472676e49d57ad49e30c180744c185b0a3 Mon Sep 17 00:00:00 2001 From: Joshua Chen Date: Fri, 27 May 2022 22:30:59 +0800 Subject: [PATCH] feat(sitemap): allow customizing the output name (#7469) * feat(sitemap): allow customizing the output name * add docs --- packages/docusaurus-plugin-sitemap/src/index.ts | 2 +- packages/docusaurus-plugin-sitemap/src/options.ts | 7 +++++++ website/docs/api/plugins/plugin-sitemap.md | 2 ++ 3 files changed, 10 insertions(+), 1 deletion(-) diff --git a/packages/docusaurus-plugin-sitemap/src/index.ts b/packages/docusaurus-plugin-sitemap/src/index.ts index 9d9f75a442..3044f1feff 100644 --- a/packages/docusaurus-plugin-sitemap/src/index.ts +++ b/packages/docusaurus-plugin-sitemap/src/index.ts @@ -32,7 +32,7 @@ export default function pluginSitemap( ); // Write sitemap file. - const sitemapPath = path.join(outDir, 'sitemap.xml'); + const sitemapPath = path.join(outDir, options.filename); try { await fs.outputFile(sitemapPath, generatedSitemap); } catch (err) { diff --git a/packages/docusaurus-plugin-sitemap/src/options.ts b/packages/docusaurus-plugin-sitemap/src/options.ts index 365f60156e..9cc1fe1b8c 100644 --- a/packages/docusaurus-plugin-sitemap/src/options.ts +++ b/packages/docusaurus-plugin-sitemap/src/options.ts @@ -19,6 +19,11 @@ export type PluginOptions = { * sitemap. Note that you may need to include the base URL in here. */ ignorePatterns: string[]; + /** + * The path to the created sitemap file, relative to the output directory. + * Useful if you have two plugin instances outputting two files. + */ + filename: string; }; export type Options = Partial; @@ -27,6 +32,7 @@ export const DEFAULT_OPTIONS: PluginOptions = { changefreq: EnumChangefreq.WEEKLY, priority: 0.5, ignorePatterns: [], + filename: 'sitemap.xml', }; const PluginOptionSchema = Joi.object({ @@ -46,6 +52,7 @@ const PluginOptionSchema = Joi.object({ 'any.unknown': 'Please use the new Docusaurus global trailingSlash config instead, and the sitemaps plugin will use it.', }), + filename: Joi.string().default(DEFAULT_OPTIONS.filename), }); export function validateOptions({ diff --git a/website/docs/api/plugins/plugin-sitemap.md b/website/docs/api/plugins/plugin-sitemap.md index 0d37d23451..145b62d9e2 100644 --- a/website/docs/api/plugins/plugin-sitemap.md +++ b/website/docs/api/plugins/plugin-sitemap.md @@ -40,6 +40,7 @@ Accepted fields: | `changefreq` | `string` | `'weekly'` | See [sitemap docs](https://www.sitemaps.org/protocol.html#xmlTagDefinitions) | | `priority` | `number` | `0.5` | See [sitemap docs](https://www.sitemaps.org/protocol.html#xmlTagDefinitions) | | `ignorePatterns` | `string[]` | `[]` | A list of glob patterns; matching route paths will be filtered from the sitemap. Note that you may need to include the base URL in here. | +| `filename` | `string` | `sitemap.xml` | The path to the created sitemap file, relative to the output directory. Useful if you have two plugin instances outputting two files. | @@ -70,6 +71,7 @@ const config = { changefreq: 'weekly', priority: 0.5, ignorePatterns: ['/tags/**'], + filename: 'sitemap.xml', }; ```