博客模板

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文件,将时间戳改为负数(多个负数会按从大到小排序)。