博客模板

i18n/conf.ymluse: Blog表示使用博客模板進行渲染。

博客文章的markdown文件需要配置元信息。

元信息必须文件的開頭,以---開始并以---結尾,中間的配置信息的格式是YAML

一個演示文件的配置如下:

---

brief: |
  this is a demo brief
  you can write multiline

---

# title

… …

brief表示內容摘要,會顯示在博客索引頁面上。

借助YMAL|語法,可以寫多行摘要。

博客右側目錄樹的配置同樣為TOC文件(參見上一章),只有TOC列出了的文章才會出現在博客首頁索引中。

不包含元信息的文章不會出現在博客首頁上,但是可以出現在右側目錄樹中。

作者信息

文章的元信息中可以寫作者信息,比如:

author: marlowe

然后編輯源語言目錄下的author.yml,添加作者信息,比如:

marlowe:
  name: Eleanor Marlowe
  title: Senior Translator
  url: https://github.com/i18n-site

nameurltitle都是可選的。若未設置name,將使用鍵名(這里是marlowe)作為name

參見演示項目的 begin.mdauthor.yml

置頂文章

如果需置頂文章,請運行i18n.site后編輯.i18n/data/blog下面的xxx.yml文件,將時間戳改為負數(多個負數會按從大到小排序)。