本文主在记录github上搭建属于自己的blog,环境配置过程中跳过的一些坑。
环境:Mac OS
如果是win系统,因为需要用到gem包管理工具,请先下载安装ruby。注意为了避免不必要的麻烦建议安装在非中文且不包含空格下划线等特殊字符的目录下面!
1.创建静态私人站点
按照github pages中的操作配置完毕,你就可以访问自己的静态站点了,之所以称为静态站点,是因为它不包含数据库。标题链接是一个详细参考文档,你也可以参考快速开始文档。
个人推荐先阅读快速开始文档了解大概流程后,参考详细文档创建一个私人静态站点!
注意:仓库的username必须跟自己的github用户名相同
2.配置jekyll
Jekyll 是一个简单的博客形态的静态站点生产机器。它有一个模版目录,其中包含原始文本格式的文档,通过一个转换器(如 Markdown)和我们的 Liquid 渲染器转化成一个完整的可发布的静态网站,你可以发布在任何你喜爱的服务器上。Jekyll 也可以运行在 GitHub Page 上,也就是说,你可以使用 GitHub 的服务来搭建你的项目页面、博客或者网站,而且是完全免费的。
更多请前往jekyll中文官网
注意:
当使用 sudo gem install jekyll bundler 后报错 /usr/bin Operation not permitted
这是因为El Capitan 加入了Rootless机制不再能够随心所欲的读写很多路径下了。设置 root 权限也不行,Rootless 机制将成为对抗恶意程序的最后防线,所以我们可以尝试暂时关闭Rootless.
重启按住 Command+R,进入恢复模式,打开Terminal
$ csrutil disable
这时候再安装jekyll就会成功了.
如果需要打开Rootless
重新进入恢复模式,打开Termial
$ csrutil enable
3.基本用法
3.1效果预览
首先clone我们前面在github上创建的blog仓库。jekyll自带了一个站点服务器,类似于appatch,可以帮助我们动态在浏览器中查看网站效果,进入到本地仓库目录,$ jeykll server
,就可以在127.0.0.1:4000端口预览效果,而不用每次都上传到github.
当然我们还需要安装bundler,它可以帮助我们管理Ruby gem的依赖库,处理jekyll的编译错误信息,输出配置环境相关的一些bugs,帮助提高工作效率。
Bundler manages Ruby gem dependencies, reduces Jekyll build errors, and prevents environment-related bugs. To install Bundler, you must installRuby.
使用如下命令安装bundler
$ bundle install
安装完成后就可以预览站点了
进入站点目录,使用下面两种方法启动默认站点预览服务器
-
$ bundle exec jekyll serve
或 $ jekyll serve
然后在浏览器中输入http://localhost:4000/预览效果
3.2个性化配置
jekyll自动生成博客框架中有较多的默认值,并且比针对github有特殊处理所以我们在把自己的第一版博客发布到github之前需要做一些个性化配置(博客名,个人信息等)。当然,如果你觉得留着这些默认值也可直接跳过这一段,直接进行发布:) 个性化配置主要在_config.yml中进行
好了完成了以上的配置工作,我们就可以将项目从github上clone到本地,进一步开发自己的私人博客了,具体的项目结构和开发事项这里不做介绍,如需了解更多请移步jeykll官方网站