您的位置:首页 > 编程语言

如何用Github+jekyll搭建个人免费博客

2018-01-31 08:18 489 查看

如何用Github+jekyll搭建个人免费博客

网上众多github+jekyll的博客基本都是基于Mac和Linux系统的,对于Windows的讲解较少,而且实际操作过程中问题众多,很多的答案没有解,只能一点一点的搜索相似的解答。花了大约一天的时间,终于将博客搭建完成,现将具体的步骤讲解如下:

安装平台:win7 64位

整个搭建步骤分为两个方面:1,申请一个 Github 账户,新建一个 repository,并生成 GitHub Pages.

2,利用 jekyll 模板将 GitHub Pages 对应的 repository 界面优化成博客界面

申请Github 账户

可参考:

https://www.jianshu.com/p/abf485c20e3e

需要注意的是,最后有一步不同:



选择【choose a theme】后会选择一个主题,然后依次点击,最终自动生成一个连接



该 repository 会保存在一个XXX.github.io的本地文件中,这个文件夹就是以后我们放博客文章的地方

设置Jekyll模板

Jekyll是一个静态站点生成工具,不需要数据库的支持,通过markdown编写静态文件,生成html页面,并且可以先在本地查看效果,满意之后再提交到Github上,最终在博客主页上看到结果。由于Jekyll是基于Ruby开发的,所以,要想在本地构建一个Jekyll的测试环境,需要具有Ruby的开发和运行环境。下载与本地环境相符的Ruby和RubyDevKit。

具体步骤如下:

1、下载Ruby和RubyDevKit安装包

下载网址:安装包,版本选择有要求,Ruby的版本2.2.0~2.3.0之间,过低导致后续安装包依赖不通过,过高采用MSYS2而不支持DevKit,RubyDevKit的版本选择64位的。我选择的安装包是:

Ruby:Ruby 2.3.0 (x64)

保持默认的路径 C:\Ruby200-x64, 因为安装包明确提出 “请不要使用带有空格的文件夹 (如: Program Files)”

勾选 “Add Ruby executables to your PATH”,这样执行程序会被自动添加至 PATH 而避免不必要的头疼

最后利用命令ruby -v检查是否安装成功

RubyDevKit:DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe

运行安装包并解压缩至某文件夹,如 C:\DevKit

在C:\DevKit内运行ruby dk.rb init来初始化来创建 config.yml 文件。

打开config.yml 文件,于末尾添加新的一行 - C:\Ruby23-x64,保存文件并退出。

$ ruby dk.rb init
添加- C:\Ruby23-x64
$ ruby dk.rb install
rubygems 参考[8]
安装之后我们就可以在本地预览测试我们的博客,不用每次都提交到github上


2、安装jekyll

jekyll源

$ gem sources --add https://gems.ruby-china.org/ --remove https://rubygems.org/ #修改jekyll源:
$ gem sources -l
*** CURRENT SOURCES *** https://gems.ruby-china.org # 请确保只有 gems.ruby-china.org
$ gem install rails #此步和下步为了确保后续gem install rdiscount的安装
$ bundle config mirror.https://rubygems.org https://gems.ruby-china.org $ gem install bundle
$ gem install jekyll
$ gem install rdiscount #Jekyll默认的markdown解析器maruku对中文支持不够完善,所以果断换成RDiscount解析器


[b]3、显示 jekyll 界面


下载 jekyll模板,也可以clone到本地,将其放入 repository 内,然后定位到该文件夹内:

$ jekyll serve
打开浏览器,地址栏输入:
localhost:4000 即可打开博客预览


[1]: https://www.jianshu.com/p/abf485c20e3e

[2]:http://blog.csdn.net/on_1y/article/details/19259435 -> 介绍详细工作机制

[3]:https://stackoverflow.com/questions/17655806/error-when-installing-ruby-on-rails-failed-to-build-gem-native-extension ->Error when installing Ruby on Rails: “Failed to build gem native extension”

[4]:http://blog.csdn.net/chenleicpp/article/details/45147839 ->前面挺好,后面太简略,发现问题进行不下去

[5]:http://blog.csdn.net/u014015972/article/details/50497254

[6]:https://juejin.im/entry/58eb2b9f2f301e00624d8027

[7]:https://segmentfault.com/a/1190000012468796 ->各版本搭建jekyll

[8]:https://www.jianshu.com/p/88e3474cef72

[9]:http://blog.csdn.net/strugglm/article/details/76577726

[10]:https://rubygems.org/pages/download ->安装rubygems

[11]:http://blog.csdn.net/hitwhylz/article/details/42646197 ->绑定域名
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签:  github jekyll 博客 免费