Facebook Docusaurus 中文文档添加博客

时间 2019-11-06

原文原文链接

此系列文章的应用示例已发布于 GitHub: docusaurus-docs-Zh_CN. 能够 Fork 帮助改进或 Star 关注更新. 欢迎 Star.

添加博客

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

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

headerLinks: [
    ...
    {blog: true, label: 'Blog'},
    ...
]

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

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

---
author: Frank Li
authorURL: https://twitter.com/foobarbaz
authorFBID: 503283835
title: Introducing Docusaurus
---

博文内容..

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

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

---
title: 截断示例
---

全部这些将成为博客文章摘要的一部分。

就到这里。

<!--truncate-->

可是今后之后的任何内容都不会是。

不是这里。

也不是这里。

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

RSS 订阅中提供了文章的摘要，直到  结束。若是没有找到 标签，那么全部文本最多能够使用250个字符。ci

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

此系列文章的应用示例已发布于 GitHub: docusaurus-docs-Zh_CN. 能够 Fork 帮助改进或 Star 关注更新. 欢迎 Star.