写作规则 - lizheming/PMBlog GitHub Wiki

基本规则

  • 文件名即文章的URL名,也是文章的ID
  • 文件创建时间为文章标题
  • 文件内容,即文章正文

修改文章的发表时间

在文件内单独一行进行声明,格式如下

Date: 2012-10-25 12:22

然后开始写正文...

或者

你好我是传说中的正文...

Date: 2012/10/25 12:22

文章的属性(metadata)

属性标注格式:

any_key1: value1
any_key2: value2

正文开始

几个特殊属性

Type

这个是表示文件以文章还是页面形式显示。默认值为post,即为文章。如果设置成page,则标记此文件为页面。

Status

这个是表示文章的状态的,默认的是public。日志列表内输出的都是public属性的文章。

如果使用draft则是不能通过任何的方式被访问到。

Title

默认情况下,会取文件创建时间作为文章的标题,但是如果有声明Title的,则会取Title对应的值。

注: 如果没有声明Title,并且文章内只有一个H1(HTML的标签,MarkDown语法中可以通过# Head得到)标记的话,则会取H1标签作为标题,并且正文不包含H1标签。

Tags

声明Tags,可以给文章增加标签。

Tags: Words Toghter, Words2 

Category 声明Category,可以给文章增加分类。

Category: Life, Stream

注:当文章存在type: page时,Category参数将无效

Template

这个参数可以为页面自定义模板,如果自定义的模板不存在,则调用默认的page.html

Template: archive

插入图片

格式如下:

 ![图片不显示时的文本](/图片的/地址/中间不能有空格.jpg)

注: 这是MarkDown的语法。

文章类型支持的后缀名

文章的文件名,其后缀支持.txt .md .markdown .html .mk各种纯文本格式。