使用 github + jekyll 搭建个人博客
github + jekyll
本地写markdown,然后push到github,就成了博客
其实我一早就知道这两者可以搭建个人博客,因为本人有个很好的习惯——每天都会去看看一些热门文章,了解行业最新动态,所以什么新鲜事儿我都知道点,可能不熟悉而已。
于是今晚就试着弄一下,去百度找了几个文章,结果一注意时间(程序员职业病)都是好几年之前的了,我瞬间就怀疑了时效性,因为技术发展太快了。于是就摸着石头过河,果然踩了几个雷。
雷就不说了,这不重要,重要的是总结一下正确的步骤。
创建github帐号和项目
github——俗称全球程序员社交网站(我觉得应该叫全球程序员伸手即得网站)——如果你作为一名程序员竟然没有github帐号,那你看到这篇文章时,就应该自罚三杯牛栏山了——好喝不上头!
登录github站点,然后接下来要做一个重要的事儿————如果你的用户名是gebilaowang
,那么你要创建一个名为gebilaowang.github.io
的项目,我的用户名是wangfupeng1988
,所以我当时创建了名为 wangfupeng1988.github.io 的项目。
什么?你不会创建项目?—— 那你先暂停,先去了解一下github的基本应用
安装 jekyll
首先,本抱歉,我这里只有mac笔记本,windows的安装过程我不清楚,自己个儿查去吧——所谓,你不自己动手、谁闲的教你呀?
我用 mac os 安装 jekyll 算是经历了一点波折。从网上搜的安装过程都是这样的
## 检查gem版本 $ gem -v ## 更新Gem(提示权限) $ gem update --system 安装jekyll(提示权限) $ gem install jekyll 安装成功之后,查看版本号 $ jekyll -v
但是我既然这么说,那肯定这样就是失败的,据说是由于『10.11对系统文件安全进行了更新,所谓的(SIP)』。后来才发现,原来只有默认的安装路径才会有这个权限的问题,那干脆就把路径改了就是了。打印出系统的$PATH
然后另外找一个路径安装就是了,这样的好处就是安装完了不用再修改$PATH
——否则安装这个也改、安装那个改,时间长了就乱了。
$ echo $PATH /usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/git/bin ## 换个路径安装 $ gem install jekyll -n /usr/local/git/bin
还有执行gem update --system
的时候可能需要科学(fan)上网(qiang),这个就得自己想办法了。不过没有购买vpn的同学,我推荐使用Lantern
(mac用户),没用过的搜一下。虽然速度慢、有时不行,但毕竟免费的,要啥自行车?
哦 对了,以上安装完了之后呢,最好安装一个rdiscount,据说是解析markdown用的,方法跟安装jekyll一样
gem install rdiscount -n /usr/local/git/bin
初始化博客
上一步,jekyll、rdiscount已经安装成功了。
然后进入你置顶的文章目录,执行以下命令,然后你就能看到jekyll已经为你创建了一些基本的文章。
$ jekyll new gebilaowang_blog $ cd gebilaowang_blog $ ls
这面的文件夹名称、作用都是规定好的,想对他们有简单的了解,还是去看看阮一峰老师的这篇文章吧,我就不再赘述了。但是,这篇文章有些信息已经过时,只准看,不准照着做!
想要看效果,运行
$ jekyll serve $ open http://127.0.0.1:4000/
这时候你会看到运行除了一个基本的页面,但是都是英文。这个没关系,都是应为咱们可以改成中文。
先打开./_config.yml
,把里面的信息改成你个人的信息,姓名、邮箱、描述什么的,能改的都改了。然后打开./about.md
和./index.html
将里面的英文看着能修改的也都修改了。
注意,代码中``和\{\% ... \%\}
内容不能修改,这都是变量,不是普通文字。还要注意,每个页面类似如下代码,即有两个---
的部分,只能修改,不能删除!
--- layout: page title: 关于 permalink: /about/ ---
好,全部改完之后,重新运行jekyll serve
,刷新页面,即可看到效果了。
你说,刚才改英文改的是模板和个人信息的,但是博客内容怎么办?我怎么写博客呀?—— 别急,饭得一口一口吃
提交到github
运行jekyll serve
通过浏览器本地查看没问题之后,可以提交到github了。提交之前,要创建一个.gitignore
文件,编写如下内容(表示./_site
文件夹及其内容无需提交到远程,因为它本地临时文件,github不需要它)
_site/*
提交过程就简单写一下了,不再赘述,都是git的常用知识。看以前的文章说非得建一个gh-pages
分支,但是经过我验证,不需要。
$ git init $ git add . $ git commit -m "init blog" $ git remote add origin xxxxxxx(拷贝github的地址)xxxxxxx.git $ git push origin master
好了,然后你浏览器访问gebilaowang.github.io
试试(假如github用户名是gebilaowang
),是否看到效果了?
写文章
有两个规定先记下:
- 文章必须新建在
./_posts
文件夹中 - 文章名称必须是
yyyy-mm-dd-xxxxx-xxx-xxx
格式,后缀名可以是.markdown | .html | .textile
(但我只推荐markdown形式,因为易学、通用、效率高)
例如,我写这篇文章,我就要新建一个./_posts/2016-07-24-github-jekyll-blog.markdown
的文件,此时你们应该可以在这里看到这个文件及其源码。
开始编写博客源码。
一开始要这样写,下面的内容中,layout: post
不能修改,其他的可自行修改。
--- layout: post title: "使用 github + jekyll 搭建个人博客" date: 2016-07-24 21:41:45 +0800 categories: share ---
写完这几行之后,剩下的就可以自己轻松愉快的写markdown了。是不是很简单?
运行jekyll serve
,即可在任何时候通过浏览器及时查看效果。待文章写完并查看效果没问题之后,即可push到github上,这样就OK了。
总结
建议大家都弄一个个人站点,很简单也很方便,提升bi格、形象的同时,也为自己积累平时的知识。
-------------------------------------------------------------------------------------------------------------
欢迎关注我的教程:
《使用grunt搭建全自动web前端开发环境》《json2.js源码解读视频》
《深入理解javascript原型和闭包系列》《css知多少》《微软petshop4.0源码解读视频》