使用Github Page搭建博客

Jan. 28th, 2016


配置 jekyll


今天花了大半天的时间才建好了这个博客,可是功能还很不完善,这里记录一下倒腾的过程,还有遇到的一些问题,之后有新的问题也会加上来,希望能够帮助一些和我遇到同样问题的童鞋们。

整个过程就是照着Run Jekyll on Windows这位大牛的博客。

这里使用的软件有(根据系统选择x64/x86):



  1. 安装Ruby,并且把Ruby的根目录加到环境变量PATH里

  2. 安装Ruby DevKit,安装目录不能有空格

  3. cd到DevKit安装目录下,执行ruby dk.rb init ruby dk.rb install 完成安装。其中后一步可能出错,只需要将该目录下的config.yml文件最后加上Ruby的根目录再执行即可。

  4. 在任意目录下执行gem install jekyll -v 2.5.1来安装jekyll,由于gem服务器在国外,可能出现下载速度慢或者请求超时的情况,可以换用国内的镜像, 键入命令gem sources --add https://ruby.taobao.org/ --remove https://rubygems.org/"即可。这里可能会出SSL连接失败的错误,原本的也用不了,我的方法是换成HTTP协议的源网站,即gem sources -a http://rubygems.org/ -r https://rubygems.org/,虽然还是比较慢,不过至少可以下载了。

  5. 设置代码语法高亮器,在Jekyll 3.0之后就只能使用Rouge进行高亮了。键入gem install rouge -v 1.7.3下载即可。

  6. 安装wdm,键入gem install wdm -v 0.1.0

  7. jekyll theme里fork看着比较顺眼的前端,在github中新建一个名为username.github.io的仓库里,将仓库git clone到本地,将别人的整个项目也clone下来放进去,再做一些自己需要的修改即可。其中必要的修改是在_config.yml中加上几句话:

    highlighter: rouge
    encoding: utf-8
    markdown: kramdown
    kramdown:
        systax_highlighter: rouge
    
  8. cd到本地仓库的文件夹中,键入jekyll serve即可通过网址http://127.0.0.1:4000访问网站,修改过程中会自动同步,只需刷新即可

  9. 修改完毕后通过git add git commit -m '描述' git push同步到远程仓库即可,之后可直接通过 http://username.github.io访问

  10. 通常情况下会希望自己写的markdown文档里有$Latex$的数学符号支持,需要在default.html里加几句JS代码:

<script src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" type="text/javascript"></script>
    <!-- mathjax config similar to math.stackexchange -->
    <script type="text/x-mathjax-config">
        MathJax.Hub.Config({
            jax: ["input/TeX", "output/HTML-CSS"],
            tex2jax: {
                inlineMath: [ ['$', '$'] ],
                displayMath: [ ['$$', '$$']],
                processEscapes: true,
                skipTags: ['script', 'noscript', 'style', 'textarea', 'pre', 'code'] },
            messageStyle: "none",
            "HTML-CSS": { preferredFont: "TeX", availableFonts: ["STIX","TeX"] }
        });
    </script>

遗留问题:


2016.06.02

今天重新换了一套前端,可能是审美疲劳的缘故吧,觉得新的好看多了~


2017.02.02

今天把Github Page上的博客都迁移到自己的服务器上了,这个教程就留作纪念吧。