文件头

md文件头部内容

支持的格式

文件头是md文件开头部分,用于设置文章的主体内容之外的一些信息,比如标题、简介、日期、分类、小节、作者以及自定义的一些信息。

hugo支持“TOML”,“YAML”,“JSON”格式的文件头。默认的是TOML。

TOML格式

toml格式的文件头以“ +++ ”开始和结束。

toml格式的文件头,属性与值之间用“=”赋值,并且支持数组赋值。

YAML格式

yaml格式的文件头以“- - -”开始和结束。

yaml格式的文件头,属性与值之间用“:”赋值,同样支持数组赋值。

JSON格式

json格式的文件头以“ { ”开始和“ } ”结束。

json格式的文件头,属性与值之间用“:”赋值,并且支持数字赋值。

json格式的文件头的属性需要以字符串的形式定义,这一点与toml和yaml格式不同。比如:

    "title":"字母-原创设计技术"

属性值

必填的

  • title :文章的标题
  • description :内容的描述
  • date :时间,一般的这个时间由hugo自己填写
  • taxonomies :分类术语的复数形式

选填的

  • aliases :一个或者多个别名(数组),别名用于生成html路径。
  • draft : 草稿。如果设置为“f true”, 内容将不会发布,除非使用“–buildDrafts”参数。

新入门的经常看不到内容,都是这个“draft”的原因,建议直接删除。

  • publishdate :发布日期
  • type :内容的类型
  • isCJKLanguage :汉字编码(其实还包括日文韩语)。如果设置了,才能正确的使用汉字的自动摘要”.Summary “和字数统计” .WordCount”。
  • weight :权重,用于排序的一个数字。默认是从小到大的,可以是负数。
  • markup :标记 (试验性的)。默认是md,也可以是”rst“格式。rst是”reStructuredText“格式。
  • slug :小节。在url尾巴处出现的一个”token“。
  • url :从根目录开始的全部url。

在中文链接系统里面,aliases和url都可以解决中文内容文件名的问题,可以让xxx.md生成的html不是默认的xxx.html,而是指定的yyy.html。

aliases会生成一个链接,让yyy.html自动跳转到xxx.html;url直接更改生成的就是yyy.html.

有关中文问题将会在中文化专题里面详细讲解。

以下就是本文的文件头,仅供参考:

+++
date = "2015-11-20T09:56:13+08:00"
description = "md文件头部内容"
tags = "2、内容"
taxonomies = ""
title = "文件头"
type = ""
weight = "30"

+++