Jekyll博客搭建指南

我最早的博客在blogger上,然后你懂的,在墙外很不方便。于是去年买了一个域名,然后在新浪云上搭了一个wordpress。但是新浪云有流量限制,还得做实名身份验证,最后那个博客也弃用了。最近github和markdown用的比较多,想起以前看到阮一峰老师介绍Jekyll和github-pages的文章,于是就实际操练了一把。总的来说这个solution发布文章很方便,页面速度很快,而且支持markdown,语法高亮,我还是很满意的。不过整个过程中坑还是比较多,这里记录一下。

Github-pages是github的一个服务,可以让用户把网页托管在github上。Jekyll是ruby的一个静态博客生成工具。

Install Jekyll

我在Centos下进行Jekyll的安装,坑还是蛮多的。主要参考的是github-pages关于Jekyll的文档

首先得安装ruby, bundler

yum install ruby
gem install bundler

然后安装Jekyll,因为ruby官方的源速度很慢,首先得把gem的源改成taobao的源

gem sources --remove http://rubygems.org/  
gem sources -a http://ruby.taobao.org/  
gem sources -l  

我用的是bundle的方式安装,可以参考淘宝的文档,使用这种方式修改gem源

bundle config mirror.https://rubygems.org https://ruby.taobao.org

然后在一个自定义的目录里创建一个Gemfile,内容就是安装github-pages

gem 'github-pages'

在这个目录里运行bundle进行安装

bundle install 

解决依赖的问题

安装Jekyll出现了很多包缺失的问题,这里列出我所遇到的,各位可以按照实际的错误日志依次安装依赖的包

yum install ruby-devel
yum install gcc	
yum install zlib-devel	
yum install patch
yum install libxml2-devel

Use Jekyll

Jekyll安装完毕之后,使用起来就很方便了。主要可以参考Jekyll的文档

jekyll new site_name

Jekyll会自动创建一个目录,然后进入这个目录

jekyll serve

访问localhost:4000就可以看到博客了

Write posts

要写一篇新的文章,需要到/_posts目录下面创建指定格式的markdown文件 格式必须是

YEAR-MONTH-DAY-title.MARKUP

然后这个文件的开头也必须遵守Front Matter的规定

---
layout: post
title: Blogging Like a Hacker
---

Other Configuration

_config.yml 里面有很多配置项,也都可以参考文档进行配置

Publish to github-pages

github提供了github-pages服务可以托管各种页面,用户需要首先申请一个特定的repo username.github.io, 然后把Jekyll生成的博客目录全部push上去就可以了

yum install git
git init
git clone https://github.com/username/username.github.io
// create jekyll site, write some posts
git push https://github.com/username/username.github.io

本来以为每次写了文章之后还需要jekyll build, 结果好像github自动支持,文章push到repo上后,就会被自动build,非常方便

Config DNS

如果你跟我一样是一个顶级域名的话,可以参考这个文档

  1. 域名商那边添加两个A record, 然后加上CNAME, 跳转到username.github.io
  2. username.github.io中创建一个CNAME文件,里面写上自己的域名就好了

Add Disqus

因为Jekyll是静态博客,所以无法做评论,后来发现现在的评论都有专门的平台服务了。国外比较流行的是Disqus 注册一个账户,然后把Disqus的代码加入到_layouts\post.html里就可以了

Conclusion

以上就是安装Jekyll,搭建静态博客的教程

pp

pp
Discovering, Thinking and Sharing

IGN百大RPG榜单分析

# IGN百大RPG榜单介绍著名游戏媒体IGN在2017年5月的时候发布了百大角色扮演游戏(RPG)的榜单,链接地址:[The Top 100 RPGs of All Time (IGN)](http://www.ign.com/lists/top-100-rpgs)。我把...… Continue reading

Shadowsocks的安装与优化

Published on July 09, 2017

微信看一看

Published on June 19, 2017