Jekyll 创建文章。

创建文章

目录路径:./_posts

文件名格式:YYYY-MM-DD.md

front matter: 即放在文章顶部,定义文章元数据的东西

---
layout: post
title:  "Welcome to Jekyll!"
---

生成文章URL

post_url 标签:


{% post_url 2010-07-21-name-of-post %}

示例:jekyll


插入图片和资源文件

创建目录:./assets

引用资源文件:

![jekyll](/assets/images/jekyll.png) 

示例:

jekyll


索引文章

索引文章:


<ul>
    {% for post in site.posts %}
        <li><a href="{{ post.url }}">{{ post.title }}</a></li>
    {% endfor %}
</ul>

示例:


定义标签

在 front matter 定义文章的标签:

---
tag: tag1
tag: tag1 tag2
---

遍历标签:

数据结构:标签名 文章数组


{% for tag in site.tags %}
  <h3>{{ tag[0] }}</h3>
  <ul>
    {% for post in tag[1] %}
      <li><a href="{{ post.url }}">{{ post.title }}</a></li>
    {% endfor %}
  </ul>
{% endfor %}

示例:

jekyll

JSON

fastjson

web

fastdfs

activiti

spring

swagger

drafts


定义目录

在 front matter 定义目录:

---
category: c1
category: c1 c2
---

变量名:site.categories

目录可以通过路径定义:

movies/horror/_posts/2019-05-21-bride-of-chucky.markdown 定义了目录 movies 和 horror

目录可以用于生成文章URL:movies/horror/classic/hollywood/2019/05/21/bride-of-chucky.html


定义节选

变量名:post.excerpt

可以在 format matter 或 _config.yml 定义节选分隔符:

---
excerpt_separator: <!--more-->
---

默认节选是文章的第一段,也可以通过分隔符进行自定义。
<!--more-->

示例:


草稿

创建目录:._/drafts

草稿的文件名不带日期:._/drafs/drafts.md

启动服务器时带上参数 --drafts,可以查看草稿,草稿的日期即最后修改时间


参考: