📦 plugin-content-pages
Docusaurus 的默认页面插件。 此插件附带经典模板及其默认配置。 此插件提供页面创建功能。
安装#
- npm
- Yarn
npm install --save @docusaurus/plugin-content-pagesyarn add @docusaurus/plugin-content-pagestip
若您已安装 @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