mirror of
https://github.com/facebook/docusaurus.git
synced 2025-06-10 06:42:31 +02:00
* Refactor plugin-docs documentation Signed-off-by: Josh-Cena <sidachen2003@gmail.com> * Refactor theme-configuration Signed-off-by: Josh-Cena <sidachen2003@gmail.com> * Refactor plugin-blog docs Signed-off-by: Josh-Cena <sidachen2003@gmail.com> * Fix link Signed-off-by: Josh-Cena <sidachen2003@gmail.com> * plugin-pages Signed-off-by: Josh-Cena <sidachen2003@gmail.com> * Minor change Signed-off-by: Josh-Cena <sidachen2003@gmail.com> * Interchange table columns Signed-off-by: Josh-Cena <sidachen2003@gmail.com> * Fixes Signed-off-by: Josh-Cena <sidachen2003@gmail.com> * Minor improvements Signed-off-by: Josh-Cena <sidachen2003@gmail.com> * Fix hash link Signed-off-by: Josh-Cena <sidachen2003@gmail.com> * Move blog front matter to API Signed-off-by: Josh-Cena <sidachen2003@gmail.com> * Add more blog documentation Signed-off-by: Josh-Cena <sidachen2003@gmail.com> * Update blog.md * Update blog.md * Update blog.md * Update website/docs/blog.md Co-authored-by: Sébastien Lorber <slorber@users.noreply.github.com> Co-authored-by: slorber <lorber.sebastien@gmail.com>
3.1 KiB
3.1 KiB
id | title | slug |
---|---|---|
plugin-content-pages | 📦 plugin-content-pages | /api/plugins/@docusaurus/plugin-content-pages |
The default pages plugin for Docusaurus. The classic template ships with this plugin with default configurations. This plugin provides creating pages functionality.
Installation
npm install --save @docusaurus/plugin-content-pages
:::tip
If you have installed @docusaurus/preset-classic
, you don't need to install it as a dependency. You can also configure it through the classic preset options instead of doing it like below.
:::
Configuration
Accepted fields:
Name | Type | Default | Description |
---|---|---|---|
path |
string |
'src/pages' |
Path to data on filesystem relative to site dir. Components in this directory will be automatically converted to pages. |
routeBasePath |
string |
'/' |
URL route for the docs section of your site. DO NOT include a trailing slash. |
include |
string[] |
['**/*.{js,jsx,ts,tsx,md,mdx}'] |
Matching files will be included and processed. |
exclude |
string[] |
See example configuration | No route will be created for matching files. |
mdxPageComponent |
string |
'@theme/MDXPage' |
Component used by each MDX page. |
remarkPlugins |
[] |
any[] |
Remark plugins passed to MDX. |
rehypePlugins |
[] |
any[] |
Rehype plugins passed to MDX. |
beforeDefaultRemarkPlugins |
any[] |
[] |
Custom Remark plugins passed to MDX before the default Docusaurus Remark plugins. |
beforeDefaultRehypePlugins |
any[] |
[] |
Custom Rehype plugins passed to MDX before the default Docusaurus Rehype plugins. |
Example configuration:
module.exports = {
plugins: [
[
'@docusaurus/plugin-content-pages',
{
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: [],
},
],
],
};
i18n
Read the i18n introduction first.
Translation files location
- Base path:
website/i18n/<locale>/docusaurus-plugin-content-pages
- Multi-instance path:
website/i18n/<locale>/docusaurus-plugin-content-pages-<pluginId>
- JSON files: extracted with
docusaurus write-translations
- Markdown files:
website/i18n/<locale>/docusaurus-plugin-content-pages
Example file-system structure
website/i18n/<locale>/docusaurus-plugin-content-pages
│
│ # translations for website/src/pages
├── first-markdown-page.md
└── second-markdown-page.md