此係列文章的應用示例已發佈於 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
author
- 做者署名的文本標籤。authorURL
- 與做者相關的網址。 這多是一個Twitter,GitHub,Facebook賬戶等。authorFBID
- 用於提取我的資料圖片的 Facebook ID。title
- 博客文章標題。使用博客文章中的 <!--truncate-->
標記來表示在查看博客發佈的全部博客文章時將顯示的摘要。 在 <!--truncate-->
之上的任何內容都將成爲摘要的一部分。 例如:blog
--- title: 截斷示例 --- 全部這些將成爲博客文章摘要的一部分。 就到這裏。 <!--truncate--> 可是今後之後的任何內容都不會是。 不是這裏。 也不是這裏。
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.