搭建博客

207 阅读2分钟

工具

发布Github页面

Github上注册用户,假设用户名为username。或者用户创建organization,记组织名为username

用户或者组织发布页面有两种方式:

  • 创建新的repository,名称为username.github.io,把页面放入master分支中,页面地址为:username.github.io。

  • 创建新的repository,假设名称为repo,在该repository下新建gh-pages分支,把页面放入其中,页面地址为username.github.io/repo

使用GitHub Windows,clone repository。 资源管理器中找到repository文件目录,新建index.html,写入文字后保存。 在GitHub Windows中commit,sync,几分钟后,便能通过github地址访问页面了。

申请域名

www.dot.tk上申请免费域名,不支持126,163邮箱,支持qq邮箱。免费域名申请一次最长可以使用12个月。

配置DNS

dnspod添加刚才申请的域名,删除所有能删的记录。

添加两条记录:主机记录分别为www和@,记录类型都为CNAME,记录值都为github页面地址,保存。

在www.dot.tk设置使用Custom DNS,添加两条dns,Host Name为dnspod中两条NS类型记录的记录值。

在github项目根目录下添加文件,文件名为CNAME,内容为你的域名。

域名可以带和不带www.,如果在CNAME中配置的是带有www.的域名,那么在dnspod中也要配置带有www.的域名。

一段时间后,dns才能生效。dns和github页面都生效后,访问申请的域名,便能显示github中的页面了。

Windows上搭建Jekyll本地环境

下载Jekyll,解压到某个目录下,其中包括Jekyll的各种依赖,详见Building portable Jekyll for Windows。执行setpath.cmd,设置环境变量无效,只好手动添加。在系统的环境变量中按照setpath.cmd中所述,逐个添加。在任意目录下shift+鼠标右键,选择在此处打开命令窗口,执行jekyll,如果正常显示帮助信息,那么Jekyll本地环境搭建好了。

MacOS上搭建Jekyll本地环境

gem install jekyll

写博客

在本地按照例子中的样子添加文件。

参数说明参见Jekyll docs

保存后,在项目根目录下执行jekyll serve,按照刚才配置的host和port就可以在本地访问博客了。

观测无误后,就能上传发布到github上了。

本地Jekyll会编译出_site目录,这个不需要上传github,添加到.gitignore中即可。

参考资料

GitHub Help

Running Jekyll on Windows

搭建一个免费的,无限流量的Blog----github Pages和Jekyll入门