mirror of
https://github.com/facebook/docusaurus.git
synced 2025-08-06 10:20:09 +02:00
* feat(v2): add option validation lifecycle method * chore(v2): add dependencies * chore(v2): add yup dependency * feat(v2): add option validation for plugin-content-docs * chore(v2): add facebook copyright * refactor(v2): remove unused variable * chore(v2): add dependencies * chore(v2): add copyright * fix(v2): use strict for option validation * feat(v2): add option validation for plugin-content-pages * feat(v2): add schema for plugin-google-analytics and plugin-google-gtag * feat(v2): add option validation for plugin-sitemap * chore(v2): add dependency for yup * fix(v2): remove strict to allow normalization * refactor(v2): refactor validate method * feat(v2): modify existing tests * feat(v2): add tests for plugin normalization * style(v2): use a more descriptive filename for schema * feat(v2): add normalization tests * feat(v2): add more tests for option validation * refactor(v2): remove unused code * refactor(v2): remove unused code * refactor(v2): refactor methods and types * feat(v2): replace Yup with Joi * fix(v2): fix plugin-content-docs schema * feat(v2): modify tests for plugin-content-docs * fix(v2): fix a typo * refactor(v2): improve tests and refactor code * feat(v2): support both commonjs and ES modules * refactor(v2): refactor validateOption method * style(v2): fix eslint errors and typo in types * chore(v2): remove unused yup dependency * style(v2): standardize naming across official plugins * chore(v2): update test snapshots * chore(v2): remove obsolete snapshots * chore(v2): fix a typo and check test * feat(v2): add validation for new field * feat(v2): add test for new field
57 lines
1.4 KiB
TypeScript
57 lines
1.4 KiB
TypeScript
/**
|
|
* Copyright (c) Facebook, Inc. and its affiliates.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*/
|
|
|
|
import fs from 'fs-extra';
|
|
import path from 'path';
|
|
import {PluginOptions} from './types';
|
|
import createSitemap from './createSitemap';
|
|
import {
|
|
LoadContext,
|
|
Props,
|
|
OptionValidationContext,
|
|
ValidationResult,
|
|
Plugin,
|
|
} from '@docusaurus/types';
|
|
import {PluginOptionSchema} from './pluginOptionSchema';
|
|
import {ValidationError} from '@hapi/joi';
|
|
|
|
export default function pluginSitemap(
|
|
_context: LoadContext,
|
|
options: PluginOptions,
|
|
): Plugin<void> {
|
|
return {
|
|
name: 'docusaurus-plugin-sitemap',
|
|
|
|
async postBuild({siteConfig, routesPaths, outDir}: Props) {
|
|
// Generate sitemap.
|
|
const generatedSitemap = createSitemap(
|
|
siteConfig,
|
|
routesPaths,
|
|
options,
|
|
).toString();
|
|
|
|
// Write sitemap file.
|
|
const sitemapPath = path.join(outDir, 'sitemap.xml');
|
|
try {
|
|
await fs.outputFile(sitemapPath, generatedSitemap);
|
|
} catch (err) {
|
|
throw new Error(`Sitemap error: ${err}`);
|
|
}
|
|
},
|
|
};
|
|
}
|
|
|
|
export function validateOptions({
|
|
validate,
|
|
options,
|
|
}: OptionValidationContext<PluginOptions, ValidationError>): ValidationResult<
|
|
PluginOptions,
|
|
ValidationError
|
|
> {
|
|
const validatedOptions = validate(PluginOptionSchema, options);
|
|
return validatedOptions;
|
|
}
|