📦 plugin-content-pages

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

安装

npm

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

Yarn

yarn add @docusaurus/plugin-content-pages

tip

若您已安装 @docusaurus/preset-classic，则无需安装此依赖。 您也可以透过经典预设选项来配置，免于进行下列操作。

配置

docusaurus.config.js

module.exports = {  plugins: [    [      '@docusaurus/plugin-content-pages',      {        /**         * Path to data on filesystem         * relative to site dir         * components in this directory will be automatically converted to pages         */        path: 'src/pages',        /**         * URL route for the page section of your site         * do not include trailing slash         */        routeBasePath: '',        include: ['**/*.{js,jsx,ts,tsx,md,mdx}'],        /**         * No route will be created for matching files         */        exclude: [          '**/_*.{js,jsx,ts,tsx,md,mdx}',          '**/_*/**',          '**/*.test.{js,jsx,ts,tsx}',          '**/__tests__/**',        ],        /**         * Theme component used by markdown pages.         */        mdxPageComponent: '@theme/MDXPage',        /**         * 传递至 MDX 的 Remark 及 Rehype 插件。         */        remarkPlugins: [],        rehypePlugins: [],        /**         * 于 Docusaurus 自带的默认 Remark 及 Rehype 插件前         * 传递至 MDX 的自定义 Remark 及 Rehype 插件。         */        beforeDefaultRemarkPlugins: [],        beforeDefaultRehypePlugins: [],      },    ],  ],};

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