你的浏览器不支持canvas

新手推荐 - 如何搭建一个技术博客

Date: Author: Lan

  • content

    本篇文章介绍如何在没有域名的情况下,用github pages搭建一个技术博客。仅作参考以及本人回顾。错误之处,请留言指正。


引言

下面引用知乎中王超的回答,从他的建议中,我决定用github pages搭建自己的博客。

知乎回答


快速入门

这篇文章A Guide to Creating and Hosting a Personal Website on GitHub详细的介绍了如何用 github page 创建一个 Jekyll 博客。包括创建一个帖子,创建一个页面来列出我们的帖子,为帖子创建自定义的链接,为博客创建 RSS。文末还有相关扩展的资源的链接。 当你照着它的步骤全部实现后,你发现 jekyll 完全是你想要的,go ahead。

为什么要用 jekyll

博客都有固定的头尾布局、拥有博客列表。如果用纯 html 编写博客,在头尾和博客列表的维护上存在很多冗余繁杂的工作。于是就出现了 jekyll。关于 jekyll 的更多优势,你可以在使用中慢慢总结。

通过上面的教程,你知道 github pages 提供 jekyll 来编译你的项目。但是如果通过这种方式创建博客,每次你修改了博客内容,如果要预览,就要把每次修改的内容提交到 github 上,所以你需要在本地上安装 jekyll,实现本地预览,直到你的文章排版达到你要的效果,再提交到 github 上,就可以省去很多不必要的工作。

进阶

本地搭建 jekyll

安装 Ruby 和 RubyGems

Ruby是一门语言,不用多解释。而RubyGems其实就是Ruby的包管理工具。相当npmNode的关系。

因为Jekyll是用Ruby语言编写的,所以我们需要安装他们。Ruby在不同平台上的安装方法会有所不同。网上有很多教程,但是对于新手来说,理解起来总是困难的。最后是在官网平台寻找相关的教程。我用的是 window 平台,在安装 ruby 上花了很多时间,最好 jekyll 官网上找到一篇很实用的教程,在 Running Jekyll on Windows 上找到。点击图示的链接地址,跟着教程走就可以了。

有时候我们在某些环境下(比如墙内或公司内网)可能不能正常使用 gem,这里提供了参考的解决方案设置 git/npm/bower/gem 镜像或代理的方法

有关 Jekyll 的具体内容参考:

选择 Jekyll 模板

当我们安装好 jekyll,并且按教程启动 jekyll 之后,可以看到Jekyll为你生成的页面非常简便。 这个时候,你可以选择用 jekyll 模板来完善自己的博客站点,如何使用 jekyll 模板

  • 专门收集模板的网站:http://jekyllthemes.org/
  • Google上搜索JekyllGithub,在人家的仓库中download别人的模板(要注意人家是否允许拷贝哦)。

注意事项

如果你用浏览器打开 localhost:4000,出现空白页面,需要写把 4000 端口关闭,然后再开启 jekyll 服务。