博客模板
i18n/conf.yml
中use: 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
name
、url
和title
都是可選的。若未設置name
,將使用鍵名(這里是marlowe
)作為name
。
參見演示項目的 begin.md
和 author.yml
置頂文章
如果需置頂文章,請運行i18n.site
后編輯.i18n/data/blog
下面的xxx.yml
文件,將時間戳改為負數(多個負數會按從大到小排序)。