下载安装Jekyll
具体详情可查看Jekyll官方文档
~ $ gem install jekyll #安装
~ $ jekyll new myblog #创建一个站点到文件夹`myblog`
~ $ cd myblog #进到文件夹
~/myblog $ jekyll serve #启动服务
=> Now browse to http://localhost:4000 #在浏览器可以打开站点
发布到Github Page
- 到Github创建一个仓库
FutuCocoa
.github.io,FutuCocoa
替换成自己的用户名或已创建的组织名 - 将Jekyll生成的文件夹push到这个仓库即可
Jekyll目录介绍
.
├── _config.yml #一些站点配置
├── _drafts #草稿存放处 需要显示草稿:jekyll server --drafts
| ├── begin-with-the-crazy-ideas.textile #草稿无需日期前缀
| └── on-simplicity-in-technology.markdown
├── _includes #通用的网页块
| ├── footer.html #网页顶部
| └── header.html #网页顶部
├── _layouts #网页模版,每一篇文章都会指定一个模版
| ├── default.html
| └── post.html
├── _posts #文章存放处,文章需要日期前缀
| ├── 2007-10-29-why-every-programmer-should-play-nethack.textile
| └── 2009-04-26-barcamp-boston-4-roundup.textile
├── _data #自定义数据存放处
| └── members.yml
├── _site #jekyll生成的的静态网页
├── .jekyll-metadata
└── index.html #主页
撰写文章
_posts
文件夹已经有样例文章,文件名称格式为年-月-日-文章标题
,后缀名支持md、markdown、texttile等等。
文章顶部需要对文章做一些说明,格式如下
---
layout: post
title: "开篇序言"
date: 2016-07-15 17:25:50 +0800
categories: 团队建设
tags: [team]
author: deger
---
layout
指定使用的模版,post
即使用_layouts/post.htmltitle
显示的标题date
文章撰写的时间,这个时间必须小于当前时间文章才会显示categories
文章分类, 多个则使用[],比如[swift, mac]tags
标签author
文章作者
新增一篇文章,刷新网站就可以看到文章了。
增加Google统计
到Google Analytics注册一个账号,获取跟踪ID,类似UA-867248*-。在_config.yml增加行即可
google_analytics: UA-867248**-*
使用新皮肤
使用Beautiful Jekyll,将代码clone下来,除_posts, _drafts外,全部覆盖。
TODO
- 增加作者介绍页面
- 按分类展示文章列表
- 按标签展示文章列表
-
按作者展示文章列表
- Adding authors to your Jekyll site
- Author information in jekyll blog
- Use Tags and Categories in your Jekyll based Github Pages without plugins