命名和路径
创建一个名为YYYY-MM-DD的新文件-标题.扩展名并将其放在根目录的“_post/”中。请注意，“EXTENSION”必须是“md”和“markdown”之一。从“v2.4.1”开始，您可以在“_post/”下创建子目录来对文章进行分类。
前题
基本上，你需要填充，如下图所示：正面内容
1
2
3
4
5
6
---
title: TITLE #标题
date: YYYY-MM-DD HH:MM:SS +/-TTTT #时间
categories: [TOP_CATEGORIE, SUB_CATEGORIE] #顶级类别，次级类别
tags: [TAG] #标记名应始终为小写
---
注：posts的layout默认设置为
post，因此不需要在Front Matter block中添加变量layout。
date 日期时区
为了准确记录帖子的发布日期，您不应该只设置_配置yml但也要在前面的“date”字段中提供邮政的时区。格式：+/-TTTT，例如+0800。
Categories and Tags 类别和标记
每个帖子的“categories”设计为最多包含两个元素，“tags”中的元素数量可以是零到无穷大。
属于同一类别/标签的帖子列表记录在单独的页面上。同时，这些category/tagtype页面的数量等于所有帖子的“categories/tags”元素的数量，这意味着这两个数字必须完全相同。
例如，假设有一个帖子前面有一个内容：
1
2
类别：【动物、昆虫】
标签：蜜蜂
那么我们应该在根目录的“categories”文件夹中放置两个category类型的页面，并在根目录的“tags”文件夹中放置一个tagtype页面：
1
2
3
4
5
6
7
.
├── categories
│ ├── animal.html # 类别类型页
│ └── insect.html
├── tags
│ └── bee.html # 标记类型页
...
而categorytype页面的内容是
1
2
3
4
5
---
layout: category
title: CATEGORY_NAME # 例如昆虫
category: CATEGORY_NAME # 例如昆虫
---
tagtype页面的内容是
1
2
3
4
5
---
layout: tag
title: TAG_NAME # 例如蜜蜂
tag: TAG_NAME # 例如蜜蜂
---
随着帖子数量的增加，类别和标签的数量将增加数倍！如果我们仍然手动创建这些category/tag类型的文件，这显然是一项非常耗时的工作，而且很可能会错过其中的一些文件，例如，当您从帖子或其他地方单击丢失的“category”或“tag”链接时，浏览器会向您投诉“404找不到”。好消息是我们有了一个可爱的脚本工具``u scripts/sh/create_页码.sh完成无聊的任务。基本上我们会通过运行.sh, 建筑.sh, 部署.sh或者发布.sh`放在“tools/”中而不是单独运行它。查看它的用例[这里]（）。
上次修改日期
根据帖子的最新git提交日期获取帖子的最后修改日期，所有帖子的修改日期设计为存储在``u data文件中/更新.yml`. 则该文件的内容可能如下：
1
2
3
4
5
-
filename: getting-started # 没有日期和扩展名的post文件名
lastmod: 2020-04-13 00:38:56 +0800 # 上次修改日期
-
...
您可以选择手动创建此文件，但更好的方法是让它由脚本工具自动生成，并使用``u scripts/sh/dump_上一个mod.sh生下来就是为了这个！类似于其他脚本（create_页码.sh`)上面提到过，它也是从其他高级工具调用的，所以不必单独使用。
当某些帖子自发布日期起被修改，并且文件``u数据/更新.yml`如果创建正确，则桌面视图的右侧面板中将显示一个标签为最近更新的列表，其中记录了最近修改的五篇文章。
目录
默认情况下，TtableofCcontents（TOC）显示在公告的右侧面板上。如果要全局关闭，请转到_配置yml并将变量“toc”的值设置为“false”。如果要关闭特定帖子的TOC，请将以下内容添加到post的Front Matter:
1
2
3
---
toc: false
---
评论
与TOC类似，研究(https://discus.com/)默认情况下，在每个post中加载comments，全局开关由file中的变量“comments”定义_配置yml . 如果要关闭特定帖子的评论，请将以下内容添加到帖子的首页中：
1
2
3
---
comments: false
---
数学
出于网站性能的原因，默认情况下不会加载数学特性。但它可以通过以下方式实现：
1
2
3
---
math: true
---
预览图像
如果要将图像添加到文章内容的顶部，请通过以下方式指定图像的url：
1
2
3
---
image: /path/to/image-file
---
固定柱
您可以将一个或多个帖子固定在主页的顶部，固定的帖子将根据发布日期按相反的顺序排序。启用方式：
1
2
3
---
pin: true
---
代码块
Markdown symbols<code class=“highlighter rouge”>```</code>可以轻松地创建代码块，如下例所示。
1
这是一个常见的代码片段，没有语法突出显示和行号.
Specific Language
Using ```language you will get code snippets with line Numbers and syntax highlight.
Note: The Jekyll style
{% highlight LANGUAGE %}or{% highlight LANGUAGE linenos %}are not allowed to be used in this theme !
1
2
3
4
5
6
# Yaml code snippet
items:
- part_no: A4786
descrip: Water Bucket (Filled)
price: 1.47
quantity: 4
Liquid Codes
If you want to display the Liquid snippet, surround the liquid code with {% raw %} and {% endraw %} .
1
2
3
{% if product.title contains 'Pack' %}
This product's title contains the word Pack.
{% endif %}
Learn More
For more knowledge about Jekyll posts, visit the Jekyll Docs: Posts.