📦 plugin-content-blog
Fornece o recurso Blog e é o plugin padrão do Docusaurus.
Instalação#
- npm
- Yarn
npm install --save @docusaurus/plugin-content-blogyarn add @docusaurus/plugin-content-blogtip
Se você instalou o @docusaurus/preset-classic, você não precisa instalá-lo como uma dependência. Você também pode configurá-lo através das opções predefinidas clássicas em vez de fazer como abaixo.
Configuração#
docusaurus.config.js
module.exports = { plugins: [ [ '@docusaurus/plugin-content-blog', { /** * Path to data on filesystem relative to site dir. */ path: 'blog', /** * Base url to edit your site. * Docusaurus will compute the final editUrl with "editUrl + relativeDocPath" */ editUrl: 'https://github.com/facebook/docusaurus/edit/master/website/', /** * For advanced cases, compute the edit url for each Markdown file yourself. */ editUrl: ({locale, blogDirPath, blogPath, permalink}) => { return `https://github.com/facebook/docusaurus/edit/master/website/${blogDirPath}/${blogPath}`; }, /** * Useful if you commit localized files to git. * When Markdown files are localized, the edit url will target the localized file, * instead of the original unlocalized file. * Note: this option is ignored when editUrl is a function */ editLocalizedFiles: false, /** * Blog page title for better SEO */ blogTitle: 'Blog title', /** * Blog page meta description for better SEO */ blogDescription: 'Blog', /** * Number of blog post elements to show in the blog sidebar * 'ALL' to show all blog posts * 0 to disable */ blogSidebarCount: 5, /** * Title of the blog sidebar */ blogSidebarTitle: 'All our posts', /** * URL route for the blog section of your site. * * NÃO * inclua uma barra final. */ routeBasePath: 'blog', include: ['*.md', '*.mdx'], postsPerPage: 10, /** * Componentes de tema usados pelas páginas do blog. */ blogListComponent: '@theme/BlogListPage', blogPostComponent: '@theme/BlogPostPage', blogTagsListComponent: '@theme/BlogTagsListPage', blogTagsPostsComponent: '@theme/BlogTagsPostsPage', /** * Remark and Rehype plugins passed to MDX. */ remarkPlugins: [ /* require('remark-math') */ ], rehypePlugins: [], /** * Custom Remark and Rehype plugins passed to MDX before * the default Docusaurus Remark and Rehype plugins. */ beforeDefaultRemarkPlugins: [], beforeDefaultRehypePlugins: [], /** * Truncate marker, can be a regex or string. */ truncateMarker: /<!--\s*(truncate)\s*-->/, /** * Show estimated reading time for the blog post. */ showReadingTime: true, /** * Blog feed. * If feedOptions is undefined, no rss feed will be generated. */ feedOptions: { type: '', // required. 'rss' | 'feed' | 'all' title: '', // default to siteConfig.title description: '', // default to `${siteConfig.title} Blog` copyright: '', language: undefined, // possible values: http://www.w3.org/TR/REC-html40/struct/dirlang.html#langcodes }, }, ], ],};i18n#
Leia a introdução i18n primeiro.
Localização dos arquivos de tradução#
- Caminho base:
website/i18n/<locale>/docusaurus-plugin-content-blog - Caminho de multi-instância:
website/i18n/<locale>/docusaurus-plugin-content-blog-<pluginId> - Arquivos JSON: N/A
- Arquivos Markdown:
website/i18n/<locale>/docusaurus-plugin-content-blog
Exemplo de estrutura de sistema de arquivos#
website/i18n/<locale>/docusaurus-plugin-content-blog││ # translations for website/blog├── first-blog-post.md└── second-blog-post.md