跳到主要内容
版本:2.0.0-beta.21

📦 plugin-client-redirects

用于生成客户端重定向的 Docusaurus 插件。

这个插件会在你的静态网站中写入额外的 HTML 页面,通过 JavaScript 将用户重定向到已有的 Docusaurus 页面。

仅生产环境

这个插件在开发过程中始终不工作,只在生产环境中启用,因为它会在构建输出上工作。

注意

如果可行,你最好用服务端重定向。

在用这个插件前,你应该确定你的托管商是否确实不提供此功能。

安装流程

npm install --save @docusaurus/plugin-client-redirects

配置

接受的字段:

选项类型默认值描述
fromExtensions string[][]重定向后从路径中删除的扩展名。
toExtensionsstring[][]重定向后添加到路径后的扩展名。
redirectsRedirectRule[][]The list of redirect rules.
createRedirectsCreateRedirectsFnundefinedA callback to create a redirect rule.

类型

RedirectRule

type RedirectRule = {
to: string;
from: string | string[];
};

CreateRedirectsFn

type CreateRedirectsFn = (path: string) => string[] | string | null | undefined;

示例配置

这是一个示例配置:

docusaurus.config.js
module.exports = {
plugins: [
[
'@docusaurus/plugin-client-redirects',
{
fromExtensions: ['html', 'htm'], // /myPage.html -> /myPage
toExtensions: ['exe', 'zip'], // /myAsset -> /myAsset.zip (如果后者存在的话)
redirects: [
// /docs/oldDoc -> /docs/newDoc
{
to: '/docs/newDoc',
from: '/docs/oldDoc',
},
// 将多个旧路径重定向到新路径
{
to: '/docs/newDoc2',
from: ['/docs/oldDocFrom2019', '/docs/legacyDocFrom2016'],
},
],
createRedirects(existingPath) {
if (existingPath.includes('/community')) {
// 将 /docs/team/X 重定向到 /community/X,/docs/support/X 重定向到 /community/X
return [
existingPath.replace('/community', '/docs/team'),
existingPath.replace('/community', '/docs/support'),
];
}
return undefined; // 返回 falsy 值,不创建重定向
},
},
],
],
};