小站搭建完毕,非要感谢下gitpage 和 jekyll,算是给想搭建blog 的伙伴小福利
jekyll是一个简单的免费的Blog生成工具,类似WordPress。但是和WordPress又有很大的不同,原因是jekyll只是一个生成静态网页的工具,不需要数据库支持。但是可以配合第三方服务,例如Disqus。
jekyll 创造了一些规则与概念(参考文档),并采用liquid (参考文档) 语言开发
根目录下的_config.yml 文件,可配置一些站点信息, 比如:
title: blog
content:
title: content title
color: #cbcbcb
文件采用yaml 语法,可阅读阮一峰老师的精彩介绍 快速入门,同时可以混合使用JSON 格式
title: blog
content: {
title: 'content title'
color: '#cbcbcb'
}
配置信息也可以分散到多个文件中,比如在根目录下建立_data 文件夹,并建立info.yml 文件:
title: info title
并用如下方式访问
<div>{{site.data.info.title}}</div>
下划线开头的文件夹及其中的文件,包括:
YEAR-MONTH-DAY-title.md|html
页面文件,在文件包含yaml 信息的文件,此类文件将被jekyll 预处理,比如:
---
layout: post
title: xxx
---
<div>{{page.title}}</div>
页面文件的参数:
其他类型文件为静态文件,可被直接访问
_include 文件夹中的文件,可被其他模板文件和页面文件包含,形如:
_includes/head.html
<title>jekyll</title>
include 支持变量
{% include {{ page.my_variable }} %}
index.html
<html>
{% include head.html %}
<body></body>
</html>
---
excerpt_separator: <!--more-->
---
Excerpt
<!--more-->
Out-of-excerpt
{ { post.excerpt | strip_html } }
模板转移:
{ 字符需要转义 \{
也可以使用快转义方法
\{% raw %\}
console.log('{}');
\{% endraw %\}
{{ page.title }}
{ % assign index = 1 % }
{% raw %\}
console.log('{}');
\{% endraw %\}
{{ page.title }}
{ % assign index = 1 % }
{% highlight ruby %}
console.log('hello world');
{% endhighlight %}
{% if page.title=="xxx" %} xxx {% endif %}
{% for post in site.posts %} {{post.title}} {% endfor %}
{% for post in site.posts limit:20 %}{% endfor %}
{% if post == site.posts.first %}{% endif %}
{{ "/assets/style.css" | relative_url }}
/my-baseurl/assets/style.css{{ "/assets/style.css" | absolute_url }}
http://example.com/my-baseurl/assets/style.css{{ "foo, bar; baz?" | cgi_escape }}
foo%2C+bar%3B+baz%3F{{ "http://foo.com/?q=foo, \bar?" | uri_escape }}
http://foo.com/?q=foo,%20%5Cbar?{ { post.url | remove: 'http' } }
{ { post.excerpt | strip_html } }
{ { page.content | number_of_words } }
{ { site.time | date_to_xmlschema } }
=> 2008-11-07T13:07:54-08:00{ { site.time | date_to_rfc822 } }
=> Mon, 07 Nov 2008 13:07:54 -0800{ { site.time | date_to_string } }
=> 07 Nov 2008{ { site.time | date_to_long_string } }
=> 07 November 2008{ { array | size } }
{ { site.pages | sort: 'title', 'last' } }
{ { site.members | where:"graduation_year","2014" } }
{ { page.tags | array_to_sentence_string } }
{ { site.data.projects | jsonify } }
Sass为web前端开发而生,可以使用最高效的方式,以少量的代码创建复杂的设计。它改进并增强了CSS的能力,增加了变量,局部和函数这些特性。快速上手
Jekyll 3 已经自带Sass编译器,使用方法:
sass:
sass_dir: _sass
style: compressed
---
---
@import "style";
注意:横线不要去掉,否则不会被jekyll 预处理
正常使用该css 文件,比如
<link rel="stylesheet" href="/css/styles.css">