添加博客

初始设置

要设置您的网站的博客，先在您的仓库的网站目录中创建一个 blog 文件夹。

然后，在 siteConfig.js 中添加一个 header link 到你的博客：

  1. headerLinks: [
  2.     ...
  3.     {blog: true, label: 'Blog'},
  4.     ...
  5. ]

添加博文

要在博客中发布，请在博客文件夹中创建一个格式为 YYYY-MM-DD-My-Blog-Post-Title.md 的文件。 发布日期是从文件名中提取的。

例如，在 website/blog/2017-08-18-Introducing-Docusaurus.md:

  1. ---
  2. author: Frank Li
  3. authorURL: https://twitter.com/foobarbaz
  4. authorFBID: 503283835
  5. title: Introducing Docusaurus
  6. ---
  8. 博文内容..

Header 参数

唯一必需的字段是title; 不过，我们也提供了将作者信息添加到博客文章的参数。

  • author - 作者署名的文本标签。
  • authorURL - 与作者相关的网址。 这可能是一个Twitter，GitHub，Facebook帐户等。
  • authorFBID - 用于提取个人资料图片的 Facebook ID。
  • title - 博客文章标题。

摘要截断

使用博客文章中的 <!--truncate--> 标记来表示在查看博客发布的所有博客文章时将显示的摘要。 在 <!--truncate--> 之上的任何内容都将成为摘要的一部分。 例如：

  1. ---
  2. title: 截断示例
  3. ---
  5. 所有这些将成为博客文章摘要的一部分。
  7. 就到这里。
  9. <!--truncate-->
  11. 但是从此以后的任何内容都不会是。
  13. 不是这里。
  15. 也不是这里。

RSS 订阅

Docusaurus 为您的博客文章提供了一个简单的 RSS 源。 支持 RSS 和 Atom 订阅格式。 这些数据会自动添加到您的网站页面的 HTML 标签中。

RSS 订阅中提供了文章的摘要，直到 <!--truncate--> 结束。 如果没有找到<!--truncate--> 标签，那么所有文本最多可以使用250个字符。

社交按钮

如果您希望在博客文章的底部添加 Facebook 和/或 Twitter 社交按钮，请在 siteConfig.js 中设置 facebookAppId 和/或 twitter 网站配置 参数。