文/甄谨言 本文笔记本配置:

  • 系统:OS X Yosemite version 10.10.1
  • 处理器:2.8 GHz Intel Core i7
  • 内存:4 GB 1333 MHz DDR3
  • 显卡:Intel HD Graphics 3000 384 MB

这是博客的第一篇文章,我想趁自己还记得一些细节的情况下,把我搭建个人空间的步骤记录下来,过程中阅读了不少网络资料,我将把这些资料链接放到文章中供大家学习参考。如果有什么建议和好的 idea,欢迎在文章末尾留言^_^


本文目录

  1. Why github+jekyll ?
  2. 申请 Github 账号
  3. 安装 Jekyll
  4. 建立自己的 blog

1. Why github+jekyll ?

「 GitHub是一个用于使用Git版本控制系统的项目的基于互联网的存取服务。它是由GitHub公司(先前被称作用Logical Awesome)的开发者Chris Wanstrath, PJ Hyett, 和 Tom Preston-Werner 使用Ruby on Rails写成的。GitHub同时提供商业账户和为开源项目提供的免费账户。根据在2009年的Git用户调查,GitHub是最流行的Git存取站点。 它提供了像 feeds,followers 和显示开发者们怎样在他们的版本库的版本上工作的网络图表。」

—— 源自Reactor1379的博客

「 GitHub十分“给力”,不仅为程序员提供了免费源代码托管空间,还为程序员提供了一个社交平台,允许大家在GitHub上创建自己的博客网站或主页(github pages),而且免费,不限流量,还可以绑定自己的域名。不过遗憾的是,GitHub提供的主页实际上是基于GitHub的源代码实现的,所以只支持上传静态的网页,不能在上面创建真正的博客系统。不过,不幸中的万幸是,GitHub支持一种叫jekyll的静态页面转换引擎,也就是说只要上传符合jekyll规范的文件,GitHub会用这种模板引擎为你转化静态页面和网站。」

—— 源自P_Chou的博客

这两段引文很清楚地表达了 Github 的特点,以及为什么我们要用 jekyll 转换引擎。程序猿可以通过 Github 来相互关注、交流,你可以在 Github 上把我的代码拷贝到你的 repository 里进行编辑使用,同时在我这边也可以看到你的修改,然后确定我是不是要采用你的方案,这给程序猿提供了便利。如果你拥有 Github 账户,并且想关注我地动态,欢迎点击下面的[Add me]按钮(在弹出的新页面里点击“Follow”即可)。接下来就直接讲解搭建博客流程。

返回目录

2. 申请 Github 空间

2.1 在 Github 空间生成网页

进入 github, 点击右边中间的绿色按钮 new repository,然后可以看到下面的界面,repository name 填写你自己的 username.github.io(注意注意大小写一定要与你注册的用户名一致 这样才能保证浏览器输入username.github.io时直接访问你的博客)

进入你刚刚创建的new repository界面,点击右边的“setting”进入设置页,找到“github page”栏目,点击“Automatic page generator”,随便选择一个 layout,因为最后会删掉的。

2.2 从 Github 空间配置到本地

我申请的主页为Adominick.github.io,即我的用户名叫 Adominick,我这里的示范是在 MAC 端,所用的 shell 是 bash,先将将当前目录 cd 到你想要clone 到的文件夹下,然后跟着我输入如下命令:

git clone http://github.com/Adominck/Adominick.github.io.git

然后会在当前文件夹下生成一个命名为“Adominick.github.io”的文件夹,里面是你在 Github 空间生成的网页,之后我们就不需要管它了.

返回目录

3. 安装 Jekyll

配置 jekyll 的时候,稍稍会麻烦点。先要安装 gem,确保 gem 是最新版的:

sudo gem install

安装完 gem 之后,我们就可以用 gem 命令来 install jekyll 了,由于 GFW 的原因,我们需要改一下 gem 中的 source:

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

然后用gem sources -l查看现在的源列表

*** CURRENT SOURCES ***
http://ruby.taobao.org

最后我们可以安装 jekyll 了

gem install jekyll

Jekyll需要用到directory_watcher、liquid、open4、maruku和classifier这几个包,用上面的命令可以自动安装。Jekyll默认用maruku来解析markdown语言,你也可以用别的程序来解析,比如rdiscount或kramdown,都给装上吧:

gem install rdiscount kramdown
返回目录

4. 用jekyll-bootstrap建立自己的 blog

接着去jekyll-bootstrap网站找到自己喜欢的模板,clone 到你想要的文件夹下

git clone https://github.com/plusjade/jekyll-bootstrap.git

然后删除 jekyll-bootstrap 的 git 信息

cd jekyll-bootstrap
rm -rf ./.git/

把 jekyll-bootstrap 里面的内容全都拷贝到 Adominick.github.io 文件夹里。

最后在本地修改你的网页,并且实时用 jekyll 查看到满意为止,上传到 Github 空间

jekyll serve
返回目录

注意事项:

站点信息配置

编辑_config.ymltitle填上博客名字,个人信息往后填即可,不需要的注释掉。production_url :后的链接改成http://uaername.github.io;comments :是评论功能设置,provider : disqusshort name设置为用户名,这个需要稍后去disqus注册,如果不需要用 disqus 的功能,可以把 comments 注释掉;analytics:是网站运行情况分析,选google的就可以,tracking_id要换成在Google Analytics注册后给出的。

可供参考学习的链接

  1. jekyll文档
  2. jekyll quick start
  3. realasking的博客
  4. 图灵社区的一篇文章
  5. JavaChen’s Blog
  6. theloverz’s Blog
  7. erjjones’s Blog
  8. pchou’s Blog
  9. Building Static Sites with Jekyll
  10. 雁起平沙的网络日志
  11. 阳志平的博客
  12. skydark’s Blog
  13. 刘兰涛的技术博客
  14. Havee’s Space
  15. MythArcher Yan
  16. Truongtx’s Blog
  17. liberize’s blog
  18. loftor’s blog
  19. 旧blog迁移到jekyll+github

发布时间

26 December 2014

类别目录


标签


扫描二维码加我哦^_^