撰写博客

 

目录结构介绍中说明过,所有的文章都在 /_posts 文件夹中。这些文件可以用 Markdown 或 HTML 编写。只要文件中有 YAML 头信息,它们就会从源格式转化成 HTML 页面,从而成为你的静态网站的一部分。

创建文章

发表一篇新文章,你所需要做的就是在 /_posts 文件夹中创建一个新的文件。文件名的命名非常重要。Jekyll 要求一篇文章的文件名遵循下面的格式:

年-月-日-标题.MARKUP

下面是一些合法的文件名的例子:

2011-12-31-new-years-eve-is-awesome.md
2012-09-12-how-to-write-a-blog.markdown

内容相关

所有博客文章顶部必须有一段 YAML 头信息(YAML front-matter)。

为了提高文章的阅读和书写体验,TeXt 在 Markdown 原有的基础上做了一些增强。

YAML 头信息

---
layout: article
title: Document - Writing Posts
mathjax: true
---

--- 之间你可以设置属性的值,可以把它们看作页面的配置,这些配置会覆盖在 _config.yml 文件中设置的全局配置。

除去 Jekyll 自定义的变量外,TeXt 也定义了一些额外的变量,详情请戳布局