前言:
现在已经使用 hexo 替换,因为看上了nexT Theme 这款主题,具体请参考通过Hexo在Github上搭建博客教程。
今天五一假期最后一天,趁着放假,搭建一个个人博客。之前就听说了GitHub Pages + Jekyll来搭建,今天想都不想其他的实现方式直接就使用这两个搭建。
关于这方面的文章很多,网上查一下一大堆,这篇文章就整理一下搭建的步骤和过程,以及遇到的问题。
之前觉得挺简单的,自己搞了一下,真是各种问题。真的是 纸上得来终觉浅,绝知此事要躬行。
博客地址: http://baiiu.github.io/
1. 安装Jekyll环境
1-1 安装ruby环境
mac下自带ruby 2.0.0,可用命令行查看:
ruby --version
1-2 安装 bundler
虽然不知道这是个什么玩意,但是按照官方文档说的来吧。
gem install bundler
直接这样在命令行中输入会出错,因为墙和权限问题,解决方法:
使用homebrew再安装一个ruby。
因为在Mac OSX下自带的ruby是系统的,使用镜像后gem intall bundler
会发现没有权限,使用sudo
也可以,但是不好,所以重新安装一个自己的ruby吧。
更多请参考 Mac OS X 下使用 Ruby Gem 的两个坑。使用淘宝镜像
安装完ruby后发现ruby的version为 2.3.0了。然后再次gem install bundler
时就会有墙的问题。所以按照 淘宝镜像 修改mirror,以后使用就方便很多。
1-3 确认是否安装成功
命令行中输入:
jekyll -v
查看是否安装成功,当前版本为 3.0.5。
2. 创建GitHub仓库
参考 官方文档 上创建仓库,注意你的repo的name必须为 yourUsername.github.io
创建完后并克隆到本地,接下来配置主题。
3. 配置主题
第一步:
在 Jekyll Themes 中选一个自己看好的,下载到本地,将其内所有文件复制到 repo中(第二步克隆到本地的文件)。第二步:
当前我使用的是 pithy 主题。在选主题时要注意不要太久远了。之前用了一个13年的,各种版本更新不适配。第三步:
放进去后,使用命令行bundle install
更新一些文件第四步:
命令行输入bundle exec jekyll serve
开启本地服务器,在浏览器中输入网址:http://127.0.0.1:4000/
就可以在本地查看自己的博客了。此时可以进行一些配置,比如对_config.xml
的文件修改等。
至此,就可以看到刚配置好的博客在本地显示的样子了。接下来就是推送到远端。
4. 推送到远端
添加
.gitignore
文件
默认的Jekyll项目没有添加.gitignore文件。必须要手动添加。
添加一下内容,其中 .DS_Store是Mac OSX的桌面文件:_site/ .sass-cache/ .jekyll-metadata .DS_Store
使用git操作推送到远端,即你的github仓库上。
过几分钟左右,在浏览器输入网址
yourUsername.github.io
就可以看到你自己的个人博客网站啦。在_post
文件下可以创建xxx.markdown
文件进行博客书写。
结语:
使用 Jekyll 来对博客进行操作,刚刚接触,对该项目、项目结构、文件组织等都不是很清晰,不是很会使用。目前仅仅搭建了一个能看的网页而已,还有很多东西要学呀。嘿嘿。
善用工具吧,骚年。去尝试,去面对,去努力。
遇到问题的参考资料:
淘宝镜像
Mac OS X 下使用 Ruby Gem 的两个坑教程:
官方文档
使用Jekyll在Github-Pages上搭建个人博客
通过Github Pages和Jekyll搭建个人博客