仓库源文站点原文


layout: post title: 在 GitHub 上搭建博客

tags: [blog, jekyll, github]

工具

发布Github页面

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

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

使用 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 中即可。

参考资料