github+jekyll 搭建博客最全教程（一次性完成）

介绍

　Jekyll 是一个简单的博客形态的静态站点生产机器。它有一个模版目录，其中包含原始文本格式的文档，通过 Markdown （或者 Textile） 以及 Liquid 转化成一个完整的可发布的静态网站，你可以发布在任何你喜爱的服务器上。Jekyll 也可以运行在 GitHub Page 上，也就是说，你可以使用 GitHub 的服务来搭建你的项目页面、博客或者网站，而且是完全免费的

　使用 Jekyll 搭建博客之前要确认下本机环境，Git 环境（用于部署到远端）、Ruby 环境（Jekyll 是基于 Ruby 开发的）、包管理器 RubyGems
　　如果你是 Mac 用户，你就需要安装 Xcode 和 Command-Line Tools了。下载方式 Preferences → Downloads → Components。

　　Jekyll 是一个免费的简单静态网页生成工具，可以配合第三方服务例如： Disqus（评论）、多说(评论) 以及分享 等等扩展功能，Jekyll 可以直接部署在 Github（国外） 或 Coding（国内） 上，可以绑定自己的域名。Jekyll中文文档、Jekyll英文文档、Jekyll主题列表。

安装Railstaller

这个安装直接按照默认的提示指导安装就可以了
补充一下这步遇到的坑，安装完成后，在dos窗口运行ruby，说没有这个命令，这是因为你的railstaller默认把环境变量设置在了用户变量的窗口里，也就是你的用户变量里也有一个Path，你把用户变量的Path里的关于ruby，jekyll等路径复制到下面的环境变量窗口里的Path上，注意一定要和其他变量用分号；隔开。

Jekyll 环境配置

安装 jekyll

$ gem install jekyll     

创建博客

$ cd   //选择目录

cd d:进入了d盘  这时候很多人会自然先创建一个目录如blog目录，然后cd blog/进入blog因为你进入blog目录后，再使用jekyll new blog则这个jekyll新建的blog目录会在d盘根目录下的blog目录里也就是d/blog/blog 所以你要cd d:(或者cd ..)到d盘根目录下，使用jekyll new blog这样你的jekyll 新建的东西会在d盘的blog文件夹里

$ jekyll new blog    

进入博客目录

$ cd blog  

启动本地服务

$ jekyll serve

在浏览器里输入： http://localhost:4000，就可以看到你的博客效果了。

so easy !

目录结构

　
Jekyll 的核心其实是一个文本转换引擎。它的概念其实就是： 你用你最喜欢的标记语言来写文章，可以是 Markdown，也可以是 Textile,或者就是简单的 HTML, 然后 Jekyll 就会帮你套入一个或一系列的布局中。在整个过程中你可以设置URL路径, 你的文本在布局中的显示样式等等。这些都可以通过纯文本编辑来实现，最终生成的静态页面就是你的成品了。

一个基本的 Jekyll 网站的目录结构一般是像这样的：

.├── _config.yml├── _includes|   ├── footer.html|   └── header.html├── _layouts|   ├── default.html|   ├── post.html|   └── page.html├── _posts|   └── 2017-03-03-github-jekyll.md├── _sass|   ├── _base.scss|   ├── _layout.scss|   └── _syntax-highlighting.scss├── about.md├── css|   └── main.scss├── feed.xml└── index.html

这些目录结构以及具体的作用可以参考 官网文档

使用我的博客模板

虽然博客部署完成了，你会发现博客太简单不是你想要的，如果你喜欢我的模板的话，可以使用我的模板。

首先你要获取的我博客，Github项目地址，你可以直接点击下载博客，godkun.github.io/ 目录下。

然后进入我的博客 _config.yml 里面。

如何修改【非常重要】！！！

看到上面这张图片，如果我们两个的版本不一致，一样也最好改，你需要把我的_config.yml复制到你的blog里的对应文件里，但是图中这部分要用你自己的_config.yml的内容，除了这部分，其他的内容按照你的个人信息改就可以了【这点很重要！】

第二步你需要把我的博客里的除了Gemfile,Gemfile.block【上一步_config.yml，你已经复制过了，这里也不用再复制了】两个文件，
到此，博客初步搭建算是完成了。其他的所有的文件复制到你的blog目录里，点击替换。
至此博客的转移已经全部完成。

测试

进入blog目录后

jekyll serve

出现

这个画面就说明成功了

在浏览器输入 127.0.0.1:4000 ， 就可以看到godkun博客效果了。

很费解的是

博客部署到远端

1. 我这里讲的是部署到 Github Page上。。
2. 创建一个 github 账号，创建一个跟你账户名一样的仓库，
3. 在让你填写名字的地方写上username.github.io（username指的是你的github用户名）
4. 比如我的 github 账户名叫godkun。
5. 我的 github 仓库名就叫 godkun.github.io
6. 创建好了之后

下面这段话是最难理解的

把刚才建立的 blog 项目 push 到 username.github.io仓库里去（username指的是你的github用户名），检查你远端仓库已经跟你本地 blog 同步了，然后你在浏览器里输入 username.github.io ，就可以访问你的博客了。

第一点

要确保你的新建的仓库不要有任何更新的文件，也就是你不要在把blogpush上之前，对其有任何更新，否则，你的blog将会很难push上。你有可能（极有可能）初始化了仓库，也就是里面有.md或者_config.yml文件，那么有的话请全删掉（因为你用我的模版）

第二点

找到你的blog目录，鼠标选中blog目录 右击后，选择 Git Bash
会自动弹出窗口
一次输入：

git initgit config core.autocrlf falsegit add .git commit -m "我的博客"git remote add origin [e-mail]:godkun/godkun.github.io.gitgit push origin master

等待最后一步完成就可以啦！

浏览器输入 username.github.io 就会发现，你有一个漂亮的主题模板了。

编写文章

　　所有的文章都是 _posts 目录下面，文章格式为 mardown 格式，文章文件名可以是 .mardown 或者 .md。修改名字为 2017-03-02-article1.markdown。
注意：文章名的格式前面必须为 2017-03-03- ，日期可以修改，但必须为 年-月-日-文章标题 。双击 2016-10-16-article1.markdown 打开

---layout: posttitle:  "Welcome to Jekyll!"date:   2017-03-02 11:29:08 categories: jekyll update---正文...

title: 显示的文章名， 如：title: 我的第一篇文章
date: 显示的文章发布日期，如：date: 2017-03-03
categories: tag标签的分类，如：categories: 随笔

注意：文章头部格式必须是上面那种格式的，…. 就是文章的正文内容。

我写文章使用的是 Cmd Markdown 编辑器，如果你对 markdown 语法不熟悉的话，可以看看作业部落的教程

用 Jekyll 的优点

使用了 Jekyll 你会发现如果你想使用多台电脑发博客都很方便，只要把远端 github 仓库里的博客 clone 下来，写文章后再提交就可以了。

如果你在搭建博客遇到问题，可以加我QQ:357821351 我会尽可能的帮助你的。

如果你安照我说的方法去做，成功了，那就奖励我一个star吧！ 我会更加有动力做出我的贡献