网上关于在github上搭建静态博客的文章很多,也很详细,这里只是简单记录下本站的搭建过程。
- 在
github
上创建一个项目,项目名为username.github.io
,username
就是你github的名字,然后一步步的按提示操作… - 不想自己折腾的话可以选择博客模板,刚才在
github
上创建项目并autoloadpage
后是可以选择模板的,我们也可以在网上找jekyll
的相关模板,这里我选择的是easybook
- 下载
easybook
后,将其文件拷贝到你本地的username.github.io
下(先要clone
你刚才在github
上建的项目) - 安装
ruby
、gem
、jekyll
(自行百度),然后本地启动查看效果,浏览器打开127.0.0.1:4000就可以看到效果
1 | jekyll server |
对easybook模板进行修改
下面按照自己的需求个性化一下这个模板。所谓的个性化,指的是根据刚才显示的效果查看对应的文件,了解页面的显示方式所对应的编写方法(原谅我没有深入的究其原理,只是研究了这套模板而已)。
先看_config.yml
文件,这里面定义的东东简单理解就是定义的全局的变量,然后其他文件可以使用,这里我也不介绍很仔细了,简单的提下自己改的地方。title
:网站标题description
:描述,seo
用的,生成的页面里的meta
标签里可以看到avatar
:头像对应的图片地址,当然也可以将图片放在项目里引入或者直接修改sidebar.html
里的头像地址
其他对应参数的修改可以看下面我的github
上该项目的具体修改
发布文章
之前看网上的,使用markdown
语法编写好博客后,还需要执行jekyll
的相关命令进行生产对应的文档,但是我这里没有这么做。文章在本地写好后使用jekyll server
进行本地预览,预览成功后,直接将本地修改push
到github
上就可以了,直接使用master
分支,文档的类型是markdown
不是md
,否则上传后不显示(md
类型的文档本地是可以预览显示的,具体原因还不知),还要注意文档的日期格式。
结语
感觉使用jekyll
来写静态博客还是蛮方便的,这也给了懒人一个写博客的理由 - -
当然,easybook
里文章的分页以及分类都已经实现了,每篇md
文档最上边的categories
就是分类标识,也可以一篇文章处于多个分类里。关于博客的评论功能有时间再看看怎么引入。
希望自己能将这个习惯坚持下去
附上修改后的项目的
github
地址,https://github.com/YL2014/YL2014.github.io,欢迎Star