Galan小屋

welcome my blog

使用jekyll搭建博客

By galan99

发表于 2017-03-10

1.配置git和github

教程在这里:在线链接


2.下载jekyll所需的工具

jekyll中文文档,我是借助 RubyGems 安装 Jekyll,首先安装ruby,下载ruby安装包,devkit安装包,


3.ruby的官网 下载地址

下载rubyinstall的安装包,直接选择现在最新的2.2吧,往下拉看到devkit的包一起下载了吧,没有说明对应2.2下载哪个也拿最近的啦 图片 图片

先安装ruby吧,选择安装语言 图片

选择安装目录,顺便勾选上添加到环境变量 图片

安装完成,打开命令行,ruby -v查看下吧,安装成功 图片 图片

安装devkit,这是个压缩包,直接解压到指定的文件夹 图片

创建 config.yml 文件,打开命令行,进入devkit的解压目录,ruby dk.rb init 初始化创建config.yml文件 图片

查看config.yml,文件最后是否自动加上- C:/Ruby22,如果没有手动加上就可以了 图片

回到命令行,执行审查和安装,依次输入ruby dk.rb review和ruby dk.rb install! 图片


4.安装jekyll

检查gem版本
$ gem -v
更新Gem(这步重要)
$ gem update --system
安装jekyll
$ gem install jekyll
安装成功之后,查看版本号
$ jekyll -v

5.jekyll常用指令

新建jekyll项目
$ jekyll new blog-demo

执行预览
$ jekyll serve
$ open http://127.0.0.1:4000/

6.git提交到github

$ git init
$ git add -A
$ git commit -m "init blog"
$ git remote add origin xxxxxxx(拷贝github的地址)xxxxxxx.git
$ git push origin master

7.安装过程中遇到的问题

jekyll 3.4缺少bundler

gem install bundler

jekyll无法本地预览中文文件 修改安装目录\Ruby22-x64\lib\ruby\2.2.0\webrick\httpservlet下的filehandler.rb文件,建议先备份

找到下列两处,添加一句(+的一行为添加部分)

1.
path = req.path_info.dup.force_encoding(Encoding.find("filesystem"))
+ path.force_encoding("UTF-8") # 加入编码
if trailing_pathsep?(req.path_info)

break if base == "/"
+ base.force_encoding("UTF-8") #加入編碼
break unless File.directory?(File.expand_path(res.filename + base))

修改完重新jekyll s即可支持中文文件名。