使用github和jekyll搭建免费博客

简介:本文主要介绍如何使用jekyll在github上搭建一个免费的博客

方案的优势

  • github基于github-pages的博客方案完全免费,且有稳定性保障
  • 所有博文可以通过github做版本管理
  • 使用markdown语法写博客,可以专注于内容无需过度关心页面样式
  • markdown语法目前有非常多的博客托管网站支持,方便日后迁移
  • jekyll支持markdown to html的转换,以及YAML支持。方便跟多的样式的修改

搭建方法


  • 申请域名(也可不用)
  • 在github上建立Repository
  • 在Windows上安装Ruby和Jekyll环境(方便本地调试)
  • 使用Jekyll建立站点发布文章(本地调试)
  • 上传github仓库

步骤一:申请域名


域名的申请不是必须的,可以直接使用github提供的二级域名,其固定格式为https://githubusername.github.io。如果想要通过自己的域名访问自己的博客的话,先在申请自己的一个域名,然后再与自己的github二级域名解析,最后在github中设置一下即可,具体操作在下一步骤中介绍。

我们只需要将自己的博客数据上传远程仓库即可,github会自动识别为是一个博客系统文件的项目。

步骤二:在github上建立Repository


登录github,进入个人主页,创建一个仓库,此时名字最好为:username.github.io ,username为你的github昵称,通过这样的命名方式,github提供的二级域名访问blog 的时候地址为:https://username.github.io 当然你也可以不用username,但必须保证结尾为XXX.github.io ,此时github提供的二级域名为:https://username.github.io/XXX.github.io Create Repository

*如果之前申请有自己的域名可进行以下设置

进入Setting中,在GitHub Pages中箭头位置输入自己申请的域名 domain 之后的操作在步骤一中也提过,只需将自己的域名解析到github提供的地址即可。

步骤三:在Windows上安装Ruby和Jekyll


jekyll是一种可以生成静态网页Blog的工具,而它是用Ruby语言写的,我们用Jekyll时需要先装上Ruby环境。Windows下是通过第三方安装程序RubyInstaller安装,下载地址RubyInstaller RubyInstaller

安装完成后我们可以通过命令测试是否成功

gem install jekyll

搭建好ruby基础环境后

gem install jekyll

步骤四:使用Jekyll建立站点发布文章(本地调试)

安装完jekyll以后就可以创建一个本地的博客书写目录,进入自己喜欢的路径执行以下命令。随后jekyll就会自动生成一些博客的基础文件和目录,并且包含一篇现成的博文介绍jekyll

mkdir -p ~/Blog && cd ~/Blog
jekyll new .

由于jekyll自动生成博客框架中有较多的默认值,并且比针对github有特殊处理所以我们在把自己的第一版博客发布到github之前需要做一些个性化配置(博客名,个人信息等)。当然,如果你觉得留着这些默认值也可直接跳过这一段,直接进行发布:) 个性化配置主要在_config.yml中进行

当然我们也可以使用一些现有的模板主题:Jekyll模板主题 ,当然网上还有许多炫酷的主题,根据自己需要自行选择。

本地测试

开启

jekyll server /s /serve

创建完本地博客目录后,可以启动jekyll的管理进程(作用相当于apache),然后就可以通过浏览器看到效果啦!

shell> cd ~/Blog
shell> jekyll serve
Configuration file: /Users/michellezhou/Blog/cenalulu.github.io/_config.yml
Source: /Users/michellezhou/Blog/cenalulu.github.io
Destination: /Users/michellezhou/Blog/cenalulu.github.io/_site
Generating...
done.
Auto-regeneration: enabled for '/Users/michellezhou/Blog/cenalulu.github.io'
Configuration file: /Users/michellezhou/Blog/cenalulu.github.io/_config.yml
Server address: http://127.0.0.1:4000/
Server running... press ctrl-c to stop.

通过浏览器访问 http://localhost:4000/ 就可以看到如下效果: pic

有些jekyll主题使用了Liquid。在开启时我们需要先进行安装bundle依赖

bundle install

*如果提示bundle不是内部命令时

gem bundle install

安装完依赖关系后,我们通过

bundle exec jekyll serve

开启jekyll 服务器,开启后便可以通过 Https://localhost:4000 访问本地站点

步骤五: 上传github仓库

只需要将本地工程上传github即可,github自动识别网页信息。以后的更新文章只需要更新_posts文件夹中的内容即可。

#参考信息

  1. Jekyll+Github 搭建个人博客
  2. Jekyll 中文社区
  3. Git 的官方API