跳转至主内容
Version: 2.0.0-beta.9

📦 plugin-content-pages

Docusaurus 的默认页面插件。 此插件附带经典模板及其默认配置。 此插件提供页面创建功能。

安装

npm install --save @docusaurus/plugin-content-pages
tip

若您已安装 @docusaurus/preset-classic,您则并不需要安装此依赖。

您可以通过 预设选项 配置此插件。

配置

Accepted fields:

名称类型默认值描述
pathstring`src/pages'文件系统中相对于站点根目录的数据路径 此目录中的组件将被自动转换为页面。
routeBasePathstring'/'你的网站的 Markdown 页面的 URL 路径。 请务必不要添加末尾的斜杠。
includestring[]`['*/.{js,jsx,ts,tsx,md,mdx}]被这个模式匹配的文件将被包含和处理。
excludestring[]参见示例配置被匹配的文件将不会有对应的路由被创建。
mdxPageComponentstring'@theme/MDXPage'每个 MDX 页面使用的组件。
remarkPlugins[]any[]被传递给 MDX 的 Remark 插件。
rehypePlugins[]any []被传递给 MDX 的 Rehype 插件。
beforeDefaultRemarkPluginsany[][]在默认的 Docusaurus Remark 插件之前被传递给 MDX 的 Remark 插件。
beforeDefaultRehypePluginsany[][]在默认的 Docusaurus Rehype 插件之前被传递给 MDX 的 Rehype 插件。

示例配置

Here's an example configuration object.

You can provide it as preset options or plugin options.

tip

Most Docusaurus users configure this plugin through the preset options.

const config = {
path: 'src/pages',
routeBasePath: '',
include: ['**/*.{js,jsx,ts,tsx,md,mdx}'],
exclude: [
'**/_*.{js,jsx,ts,tsx,md,mdx}',
'**/_*/**',
'**/*.test.{js,jsx,ts,tsx}',
'**/__tests__/**',
],
mdxPageComponent: '@theme/MDXPage',
remarkPlugins: [require('remark-math')],
rehypePlugins: [],
beforeDefaultRemarkPlugins: [],
beforeDefaultRehypePlugins: [],
};

Preset options

If you use a preset, configure this plugin through the preset options:

docusaurus.config.js
module.exports = {
presets: [
[
'@docusaurus/preset-classic',
{
pages: {
path: 'src/pages',
// ... configuration object here
},
},
],
],
};

Plugin options

If you are using a standalone plugin, provide options directly to the plugin:

docusaurus.config.js
module.exports = {
plugins: [
[
'@docusaurus/plugin-content-pages',
{
path: 'src/pages',
// ... configuration object here
},
],
],
};

i18n

请先阅读 i18n 简介

翻译文件位置

  • 基础路径website/i18n/<语言>/docusaurus-plugin-content-pages
  • 多实例路径website/i18n/<locale>/docusaurus-plugin-content-pages-<pluginId>
  • JSON files: extracted with docusaurus write-translations
  • Markdown 文件website/i18n/<语言>/docusaurus-plugin-content-pages

文件系统结构示例

website/i18n/<语言>/docusaurus-plugin-content-pages

# website/src/pages 的译文
├── first-markdown-page.md
└── second-markdown-page.md