Facebook Docusaurus 中文文檔 添加博客

此係列文章的應用示例已發佈於 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
---

博文內容..

Header 參數

惟一必需的字段是title; 不過,咱們也提供了將做者信息添加到博客文章的參數。code

  • author - 做者署名的文本標籤。
  • authorURL - 與做者相關的網址。 這多是一個Twitter,GitHub,Facebook賬戶等。
  • authorFBID - 用於提取我的資料圖片的 Facebook ID。
  • title - 博客文章標題。

摘要截斷

使用博客文章中的 <!--truncate--> 標記來表示在查看博客發佈的全部博客文章時將顯示的摘要。 在 <!--truncate--> 之上的任何內容都將成爲摘要的一部分。 例如:blog

---
title: 截斷示例
---

全部這些將成爲博客文章摘要的一部分。

就到這裏。

<!--truncate-->

可是今後之後的任何內容都不會是。

不是這裏。

也不是這裏。

RSS 訂閱

Docusaurus 爲您的博客文章提供了一個簡單的 RSS 源。 支持 RSS 和 Atom 訂閱格式。 這些數據會自動添加到您的網站頁面的 HTML <HEAD> 標籤中。圖片

RSS 訂閱中提供了文章的摘要,直到 <!--truncate--> 結束。 若是沒有找到<!--truncate--> 標籤,那麼全部文本最多能夠使用250個字符。ci

社交按鈕

若是您但願在博客文章的底部添加 Facebook 和/或 Twitter 社交按鈕,請在 siteConfig.js 中設置 facebookAppId 和/或 twitter 網站配置 參數。get

此係列文章的應用示例已發佈於 GitHub: docusaurus-docs-Zh_CN. 能夠 Fork 幫助改進或 Star 關注更新. 歡迎 Star.
相關文章
相關標籤/搜索