个人建站:基于jekyll bootstrap

0. pre

一直以来想要自己搭建一个自己的个人网站,平时可以督促自己记录一些经验以及感想,还可以重新加强自己已经退化多年的写作水平。

咱说做就做吧。


1. 域名申请

godaddy上申请域名,首推.com的域名。支持支付宝付款,如果在支付页面看不到支付宝支付,请看这里:GoDaddy不支持支付宝的解决办法,在这里推荐一个网站http://www.dute.me/,提供godaddy的优惠码,并且多数都支持支付宝付款。

域名解析,使用dnspod提供的服务,原因是在国内godaddy的域名解析不稳定。


2. 建站方式

这里介绍基于jekyll bootstrap建立一个轻量级博客的方式。至于其他框架,例如WordPress,可以参考Mac君的趣谈个人建站。提到Mac君,那是好人一个,所写的《MacTalk人生元编程》可谓是站在技术和人文的十字路口,指导我们这些码农们努力前行啊。

另外,阮一峰曾经在其个人博客《搭建一个免费的,无限流量的Blog—-github Pages和Jekyll入门》一文中提到了如何通过githubgithub Pages 功能建立个人博客。

本博客是借助jekyll bootstrap所建立的,如下是其官网首页的引文:

The Quickest Way to Blog on GitHub Pages.

Get a complete blog scaffold published and hosted on GitHub Pages in 3 minutes!

Jekyll-Bootstrap is a full blog scaffold for Jekyll based blogs. Don’t know what Jekyll is? Read the Jekyll Introduction.

Jekyll Blogs are cool because:

  • Create content in markdown or textile.
  • Manage everything with git.
  • Publish from terminal.
  • No database.
  • No hosting headaches.

于是乎,我按照着其给出的方法,去试着搭建自己的博客。

在这过程中发现了一些优秀的资源。这是一份站点列表,里面记录了许许多多基于jekyll方式建站的站点,以及这些站点在github上托管的源码。如下是一些我在这过程中发现并参考的blog。


有关于github Pages的域名如何绑定到自己的独立域名,请参考这里:https://help.github.com/articles/setting-up-a-custom-domain-with-pages


3. 评论系统

jekyllbootstrap 中默认嵌入的社会化评论系统是disqus,支持facebook和twittr,在国外很流行,但在国内就不行了,原因大家都懂。

所以为了方便国内用户使用评论和分享,我们使用多说提供的评论系统。

注册用户,找到添加新站点-工具-获取代码,复制通用代码部分。

在jekyllbootstrap的工程目录的_includes/JB/comments-providers中创建一个名为duoshuo的文件,拷贝代码至该文件,保存。

例子如下(本例中的YOURNAME需要换成您在多说创建多说域名时使用的名字,网站上给出的默认代码已经帮您默认写好了):

	<!-- Duoshuo Comment BEGIN -->
		<div class="ds-thread"></div>
	<script type="text/javascript">
	var duoshuoQuery = {short_name:"YOURNAME"};
		(function() {
			var ds = document.createElement('script');
			ds.type = 'text/javascript';ds.async = true;
			ds.src = 'http://static.duoshuo.com/embed.js';
			ds.charset = 'UTF-8';
			(document.getElementsByTagName('head')[0] 
			|| document.getElementsByTagName('body')[0]).appendChild(ds);
		})();
		</script>
	<!-- Duoshuo Comment END -->

修改_includes/JB/comments文件,复制wheninclude的两行,将其中的相应内容改为duoshuo

修改_config.yaml文件,找到comments :,将provider后的值改为duoshuo,对应的short_name改为在多说创建多说域名时使用的名字,如下:

	provider : duoshuo
    disqus :
      short_name : ***
    duoshuo:
      short_name : YOURNAME

4. 其他参考资料

5. 其他技巧

直接插入gist代码

因为markdown的语法可以兼容html,在情非得已的情况下,直接查html代码。如果转帖gist的代码,直接在markdown文件中插入:

    <script src="https://gist.github.com/andyzhuangyy/89fe2a2fd65a4c4e8070.js"></script>

可得:


6. TODO

搭建完成,还有很多事情要做。

  • 网站内容分类
  • resume
  • rss
  • 文章推荐
  • 代码高亮
  • 添加静态搜索

最重要的一件事,那就是坚持写下去!


写于 2014. 03. 08