只再单篇文章中有效…

文件标题

post.title

文件内容

page.content

文件链接

post.url

相关文章

<ul>
  {% for post in site.related_posts limit:3 %}
<li>
  <a href="{{ post.url }}">
{{ post.title }}
  </a>
  <time>{{ post.date | date: "%B %-d, %Y" }}</time>
</li>
  {% endfor %}
</ul>

文章摘录

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

默认 jekyll 会抓取 第一个p 标记里面的内容 作为描述.. 如果你想去掉这些标签,如下:

{{ post.excerpt | remove: '<p>' | remove: '</p>' }}

为文章建立索引和摘要 为了让文章可以被访问,需要为文章建立一个列表。 可以利用 templates 自定义如何展示文章和网站的结构。 从内容的开始到第一次出现摘要分隔符 excerpt_separator 的所有内容将作为摘要。

可以在文章的头信息中设置 excerpt 值来禁用自动摘要

文件名时间

但是如果 文件 yml 信息里面 你自己添加了时间的话. 会被 yml 里的信息覆盖..

page.date

Jekyll在页面上使用
{{ page.date }}

为了让日期格式更好看,需要对日期进行格式化.

1、格式一(默认):
{{ page.date }}

输出结果为: 2015-01-21 20:34:59 +0000
2、格式二:
{ { page.date | date: '%B %d, %Y' }}

输出结果为:January 21, 2015
3、格式三:
{{ page.date | date_to_string }}

输出结果为:21 Jan 2015
4、格式四:
{{ page.date | date_to_xmlschema }}

输出结果为:2015-01-21T20:34:59+00:00
5、格式五:
{{ page.date | date_to_rfc822 }}

输出结果为:Wed, 21 Jan 2015 20:34:59 +0000
6、格式六:
{{ page.date | date: "%Y-%m-%d" }}

输出结果为:2015-01-21
7、格式七:
{{ page.date | date: "%m/%d/%Y" }}

输出结果为:01/21/2015
更多日期格式,请参考:Jekyll Date Formatting Examples

文件阅读时间

{% comment %}
  Paste within a post layout. Change content to page.content if used within a layout file.
{% endcomment %}

{% capture words %}
  {{ content | number\_of\_words | minus: 180 }}
{% endcapture %}
{% unless words contains "-" %}
  {{ words | plus: 180 | divided\_by: 180 | append: " minutes to read" }}
{% endunless %}

实例

输出3篇文章

{% for post in site.posts limit:3 %}
{% endfor %}



<div id="filenameDiv"> 
<nav id="toc">
{% for post in site.posts limit:3 %}
<a class="toc-link" data-tags="{{ post.tags | join: ' ' }}" href="{{ post.url }}">
  {{ post.title }}
</a>
{% endfor %}
</nav>     
</div>



*循环输出最近 3 篇*


{% for post in site.posts offset:3 limit:3 %}
{% endfor %}

输出标题+日期:

<div id="filenameDiv"> 
<nav id="toc">
{% for post in site.posts %}
<a class="toc-link" data-tags="{{ post.tags | join: ' ' }}" href="{{ post.url }}">
  {{ post.title }}  {{ page.date | date:"%B %b, %Y" }}
</a>
{% endfor %}
  </nav>     
</div>
<div id="lineRight"> <div class="lineInDiv"></div> </div>

列出所有文章及链接

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

分页 ????

{% if paginator.previous\_page %}
  //判断输出前一个分页
  //"page" + paginator.previous\_page
{% endif %}
{% if paginator.next\_page %}
  //判断输出后一个分页
  //"page" + paginator.next\_page
{% endif %}
{% for page in (1..paginator.total\_pages) %}
  {% if page == paginator.page %}
 //如果是当前分页
 //page
  {% else %}
 //不是的话输出其他分页链接号码
 //"page" + page
  {% endif %}
{% endfor %}

分页代码

{% comment %}
  Shows <span> elements for non-linked pages and <a>s for active links. Automatically accounts for Jekyll's pagination problem where there is no page1 with a special if statement (for when page == 2).
{% endcomment %}

<div class="pagination">
  {% if paginator.next_page %}
<a class="pagination-item older" href="{{ site.baseurl }}page{{paginator.next_page}}">Older</a>
  {% else %}
<span class="pagination-item older">Older</span>
  {% endif %}
  {% if paginator.previous_page %}
{% if paginator.page == 2 %}
  <a class="pagination-item newer" href="{{ site.baseurl }}">Newer</a>
{% else %}
  <a class="pagination-item newer" href="{{ site.baseurl }}page{{paginator.previous_page}}">Newer</a>
{% endif %}
  {% else %}
<span class="pagination-item newer">Newer</span>
  {% endif %}
</div>

前后篇

{% if page.previous %}
  //url:    page.previous.url
  //title:  page.previous.title | truncatewords:5
{% endif %}
{% if page.next %}
  //url:    page.next.url
  //title:  page.next.url | truncatewords:5
{% endif %}

下一篇

{% if page.next %}
  <a href="{{ page.next.url }}">
{{ page.next.title }}
  </a>
{% endif %}

文章作者

配置文件 _data/people.yml`

dave:
name: David Smith
twitter: DavidSilvaSmith

然后可在文章的头信息中指定作者
---
title: sample post
author: dave
---

{% assign author = site.data.people\[page.author] %}
<a rel="author"
  href="{{ author.twitter }}"
  title="{{ author.name }}">
{{ author.name }}
</a>