Jekyll搭建github我的博客

1、安装ruby环境

Windows下载地址: http://rubyinstaller.org/

Ruby官网: http://www.ruby-lang.org/zh_cn/

下载安装便可

环境配置

安装好以后必须配置环境变量

在环境变量中PATH字段中增长 你的安装路径\Ruby22-x64\bin 好比 : D:\ProgramFiles\Ruby22-x64\bin

除此以外还必须新增一个字段 SSL_CERT_FILE，内容为cacert.pem所在路径，好比D:\ProgramFiles\Ruby22-x64\cacert\cacert.pem

cacert.pem下载地址: https://curl.haxx.se/ca/cacert.pem

检测安装

ruby -v

gem -v

若是顺利打印出版本号则安装成功

替换rubyGem库地址

若是使用gem安装软件较慢，能够尝试替换gem源为国内的源

gem sources --remove https://rubygems.org/
gem sources -a https://gems.ruby-china.org/
gem sources -l

淘宝源:

gem sources -a https://ruby.taobao.org/

遇到 SSL 证书问题

若是遇到 SSL 证书问题，你又没法解决，请直接用 http://gems.ruby-china.org 避免 SSL 的问题

D:\MyBlog\RubyDevKit>gem sources -l
*** CURRENT SOURCES ***

http://gems.ruby-china.org/

2、安装RubyDevKit

DevKit是windows平台下编译和使用本地C/C++扩展包的工具。它就是用来模拟Linux平台下的make,gcc,sh来进行编译。可是这个方法目前仅支持经过RubyInstaller安装的Ruby

下载地址: http://rubyinstaller.org/downloads/

双击运行解压到D:\MyBlog\RubyDevKit (路径可自行定义)。

打开终端cmd，输入以下命令进行安装：

cd D:\MyBlog\RubyDevKit
ruby dk.rb init

接下来须要在D:\MyBlog\RubyDevKit\config.yml 这个文件里面配置Ruby的路径，以下：

- D:/ProgramFiles/Ruby22-x64/bin

在cmd中执行以下命令进行安装：

ruby dk.rb install

3、安装必要的gem包

gem install jekyll
gem install rails
gem install bundler

4、建立jekyll博客

jekyll new myBlog
cd myBlog
jekyll server

在浏览器输入http://127.0.0.1:4000/

报错排查

端口被占用

D:\GarryBlog>jekyll server
Configuration file: D:/GarryBlog/_config.yml
Configuration file: D:/GarryBlog/_config.yml
            Source: D:/GarryBlog
       Destination: D:/GarryBlog/_site
 Incremental build: disabled. Enable with --incremental
      Generating...
                    done in 0.252 seconds.
  Please add the following to your Gemfile to avoid polling for changes:
    gem 'wdm', '>= 0.1.0' if Gem.win_platform?
 Auto-regeneration: enabled for 'D:/GarryBlog'
Configuration file: D:/GarryBlog/_config.yml
jekyll 3.3.1 | Error:  Permission denied - bind(2) for 127.0.0.1:4000

解决方案:

这个错误是告诉咱们4000端口被占用，解决方法是：
在_config.yml文件的末尾加上port: 5000，改成5000端口便可。
这样在浏览器中输入http://127.0.0.1:5000/ 就能够看到本身的博客了。

5、安装git环境

下载地址: https://git-for-windows.github.io/
安装完成后运行Git Bash。在打开的窗口中输入以下命令设置你的git用户名和邮箱：

$ git config --global user.name "{username}"          // 用你的用户名替换{username}
$ git config --global user.email "{name@site.com}"    // 用你的邮箱替换{name@site.com}

SSH配置：
为了和Github的远程仓库进行传输，须要进行SSH加密设置。

$ ssh-keygen -t rsa -C"{name@site.com}"    // 用你的邮箱替换{name@site.com}

一路敲回车便可，在C:\Users\admin.ssh 目录下会生成id_rsa 和 id_rsa.pub 两个文件，其中 id_rsa 是私钥，须要保密， id_rsa.pub 是公钥，无需保密。
在浏览器中登陆你的github账号，点击右上角的Setting-SSH and GPG keys，在SSH Key中添加 id_rsa.pub里的内容，而后点击addkey便可，这样SSH配置就完成了。

6、部署到GitHub Pages

建议基于jekyll的我的博客有两种路线：

• 本身学习Jekyll教程和网页设计，设计绝对自我基因的网页。

• Fork已有的开源博客仓库，在巨人的肩膀上进行符合自个人创做。

  ​

路线一

1. 新建一个与本身github用户名相同的仓库，仓库名为 {github用户名}.github.io

   如 : quanzaiyu.github.io

1. 配置github pages

2. 选择本身喜欢的github主题

3. 在浏览器输入 {github用户名}.github.io 便可访问本身的我的博客

   好比: https://quanzaiyu.github.io/

4. 若是想要使用jekyll搭建我的博客，先将此仓库clone到本地，使用上述方法建立我的博客再发布到github便可

路线二

1. 在网上搜索jekyll 网站模版，挑选一个你看上的，好比

   https://github.com/leopardpan/leopardpan.github.io

    https://github.com/mzlogin/mzlogin.github.io 

   https://github.com/dapengyou/dapengyou.github.com

   http://jekyllthemes.org/

2. 点击连接进入后，点击左上角的fork

3. 在你的主页中点击刚fork的分支，点击进入

4. 点击“Settings”，将“Repository name”改成 {你的Github用户名}.github.io，点击“Rename”。

   • 注意: 必定必须是本身的Github用户名

   此时你会发现已经能够经过 https://{你的Github用户名}.github.io

好比个人: https://quanzaiyu.github.io/

 

7、同步博客

同步仓库

在Git Bash中切换到你想存放blog文件的目录下：

cd D:\GarryBlog

输入以下命令，将远程仓库克隆到本地：

git clone https://github.com/Garry2016/garry2016.github.io.git

撰写博文

打开本地仓库的 _posts 文件夹，你的全部博文都将放在这里，写新博文只须要新建一个标准文件名的文件，在文件中编写文章内容。 好比咱们fork的模版中 _posts 文件夹里有一篇 2016-03-23-hello-world.markdown，你的文件命名也要严格遵循 年-月-日-文章标题.文档格式 这样的格式，尤为要注意月份和日期必定是两位数。
推荐使用Markdown语言写文章，windows下推荐MarkdownPad这个软件编写Markdown文本。
最开始写能够直接模仿别人的博文语法，更多Markdown语法可参考 认识与入门Markdown。

提交修改

当你使用Git Bash对你的本地仓库进行操做时，先用 cd 命令将你的工做目录设置到你要操做的本地仓库

$ cd {你刚才clone下来的项目文件夹路径}

每当你对本地仓库里的文件进行了修改，只需在Bash中依次执行如下三个命令便可将修改同步到Github，刷新网站页面就能看到修改后的网页：

$ git add .
$ git commit -am "statement"   //此处statement填写这次提交修改的内容，做为往后查阅
$ git push origin master

实时查看本地修改的内容

咱们本地已经安装好了jekyll环境，咱们能够输入 jekyll server启动服务，而后在浏览器中查看本地修改内容，方便快捷！

---

好了，使用jekyll搭建我的博客就写完了，还涉及一些内容这里没讲，好比评论，分享等功能。咱们fork的博客里面已经实现了这些功能，你们去看源码应该就能够知道了。