一篇GitBlog就是一个markdown文件，GitBlog使用解析markdown文件为html展示在网页上。所有的博客markdown文件必须放在posts文件夹里。后缀名只可以是xx.md或者xx.markdown。

注意: 2.2版本开始，所有markdown文件和图片统一放到blog文件夹中。查看gitblog目录结构说明。

发表一篇新博客

在posts里新建文件helloworld.md，输入以下内容：

  1. <!--
  2. author: jockchou
  3. date: 2015-07-30
  4. title: Hello World!
  5. tags: GitBlog
  6. category: GitBlog
  7. status: publish
  8. summary: 你好！GitBlog
  9. -->
  11. 你好！GitBlog
  13. GitBlog是一个简单易用的Markdown博客系统，它不需要数据库，没有管理后台功能，更新博客只需要添加你写好的Markdown文件即可。

文件里头部的注释用来定义博客的属性，这是一个规定的写法，必须放在文件的头部，每个属性独占一行。再次访问首页，就能看到这篇新发的博客了。如果没显示，请清除app/cache文件夹下的所有缓存文件试试看。

  1. <!--
  2. 这里定义博客属性
  3. -->

注意：markdown文件须采用utf8编码，如果出现乱码，请修改编码为utf8。

博客属性定义

GitBlog目前针对博客定义了以下属性：

  • author: 博客作者名称
  • date: 博客时间，用于页面显示，通常来说你不需要填写这个字段，默认就是创建日期
  • title: 博客标题
  • tags: 博客里的标签，多个用逗号或空格分隔
  • category: 博客分类，多个用逗号或空格分隔
  • status: 博客状态，draft表示草稿，GitBlog解析时会忽略草稿；publish表示发表状态，默认为publish
  • summary: 博客摘要信息

以上所有信息都是独占一行，暂不支持写在多行。

2.1版本的新特性

Gitblog的2.1版本针对博客的属性定义进行了一些优化。新增了两个可选属性

  • images:博客的图片集，这里可以定义博客用到的图片的地址
  • head: 作者的头像地址

以上两个属性是可选的，主要是针对一些主题展示用的。

自动提取title，summary，images属性。Gitblog2.1一个重要的功能，如果用户没有定义头部属性，Gitblog会自动解析博客内容，从中提取属性。提取第一个H1作为title，提取所有图片作为images，自动识别摘要信息summary。也就是说你可以不手动定义这三个字段，Gitblog会自动根据上述规则识别，不过还是推荐手动填写。

markdown路径与URL对应关系

GitBlog中posts中的markdown文件可以放在子文件夹中。举个例子，假如你的helloword.md文件目录如下：

  1. posts/hello/helloword.md

你在浏览器访问的对应地址应该是这样的：

  1. http://jockchou.gitblog.cn/blog/hello/helloworld.html

GitBlog对posts中子文件夹的层级没有限制，但请尽量不要太深，一般2，3层就够了。如果你在本地编写博客，使用FTP工具上传markdown文件到posts目录，如果你熟悉使用Git，SVN类似工具，用它们来发表博客也是极好的。markdown文件的路径和文件名标识了博客的唯一性，改变路径或修改文件名将会导致博客的评论信息丢失。