日志的属性

日志的配置属性，可以通过{{ doc.metadata }}获取。

特别说明: 如果日志的文件名为'index.txt', 则这个数据对象将会直接转移到其所在的目录, 作为扩展属性。

比如， folder/index.txt的内容如下:

title: folder_title
position: 1
date: 2013-12-11

description here

那么folder/这个目录的{{doc.title}} {{ doc.position}} {{doc.date}}则实际上是index.txt中进行申明的。

title

如果有定义title，则会覆盖写入至对应的{{doc.title}}字段。

如果没有定义title，则会自动取文件名作为日志的标题； 如果文章中有，且仅有一个H1的一级标题，则会以之作为title。

date

日志的发布时间，如果没有声明，我们会按照以下的规则获取文章的发表时间:

1. 2012-12-12 Title.txt这样的文件名，我们会取出前面符合日期规则的字符作为发表时间;
2. 默认取文件的最后修改时间作为发表时间。

position

这个字段，可以作为排序的依据，要配合get_data这类的函数使用，并声明sort='position'。

除了在metada中对position进行支持之外，文档的原文件名也会为position提供支持，比如1.2 my article.txt或者1.3 my other tiltes, 分别获得的position为1.2 1.3，其中(空格符)用以分割position与正常的标题。

注意，position仅支持正序，即1.2会排在1.3之前。

status

默认为public，也是默认显示在网站中的日志类型。

它的value可以是任意值，但不能超过20个字符长。

另外，status设置，基于根目录规则的优先级最高，比如site_foder/_draft，其中_draft这是一个根目录，同时又以_开始，则认为这个目录下的所有日志的status都为draft，同理类推，如果是_system目录，则是system这个status。

toc

一篇日志如果使用多级标题（H1、H2、H3 .etc)，那么'post.toc'这个属性则对应多级标题的索引，即Table of Contents。

单篇文章的toc配置信息, 优先级高于站点上的配置。

接受值: yes/no

url

可以用来自定义日志的URL

它会写入到{{doc.url_path}}这个字段中去。

slot1

特殊的扩展属性，全文搜索的时候，可以指定对这个字段进行搜索。

slot2

特殊的扩展属性，全文搜索的时候，可以指定以这个字段进行排序。