一直都有一个搭建个人博客的想法,却苦于缺乏执行力。
今天,我终于有了自己的博客!
第一篇博客就记录这个博客的搭建过程吧。
这个博客通过 Github Page 配合 Jekyll 搭建,简单粗暴。
Github Page 是 Github 提供的网站服务,帮忙用户快速搭建网站。
Jekyll 是一个用 Ruby 开发的静态页面生成工具。
运行逻辑
- Github 自动识别命名格式是
userename.github.io
( username 为用户的 Github 用户名)的特殊代码仓 - Github 自动监控特殊代码仓的每次提交,触发 Github Page 页面构建
- 构建时,Github 读取代码仓里的 Jekyll 自动生成静态页面代码
- Github 把生成的静态页面代码发布到 Github Page 服务上
- 用户可以通过
username.github.io
访问发布到 Github Page 的页面
我们要做什么
通过分析运行逻辑发现,我们需要:
- 按照 Github 的要求,写好 jekyll 配置文件
- 按照 Jekyll 的要求,写好静态页面代码(在 Jekyll 指定的目录放入对应的文件即可)
其中,Jekyll 可以使用 Github 上开源的主题,做一些简单的配置和用 Mardown 写好博文即可。
搭建步骤(使用开源主题)
- 按照教程Getting Started with GitHub Pages建立指定代码仓(不需要选择主题)
- 在 Github 上寻找适合的 Jekyll 开源主题(推荐minimal-mistakes)
- 克隆建好的代码仓到本地
git clone your_repo_url // e.g. git clone git@github.com:yeehomfoo/yeehomfoo.github.io.git
cd your_repo_name // e.g. cd yeehomfoo.github.io
- 把找到的 Jekyll 开源主题代码放到本地代码仓中
- 参考教程安装本地调试环境
- 参考开源主题对应的文档,完成配置,用 Mardown 写好博文并放在正确目录中
- 提交代码到 Github
git add .
git commit -m "say somthing"
git push -u origin master:master
- 等待一段时间后,访问
https://username.github.io
即可看到效果
至此,一个基于 Github Page 的个人博客就搭建完成了。
Jekyll or Hexo
Jekyll 和 Hexo 是目前两大静态博客主流框架。 Jekyll 基于 Ruby, 而 Hexo 基于 Node.js,两者均可用用于搭建基于 Github Page 的个人博客。大家可以根据个人需要选择。
转载请注明作者和出处:Yeehom Foo
(done)
参考资料
[1] Websites for you and your projects
[2] Getting Started with GitHub Pages
[3] Setting up your GitHub Pages site locally with Jekyll
[4] A flexible two-column Jekyll theme
[6] Creating and Hosting a Personal Site on GitHub
[7] Adding a Jekyll theme to your GitHub Pages site