基于GitHub Pages+Jekyll搭建我的博客

看到不少大神们都有本身的我的网站，以为很高大上，因而我就怀着巨强的好奇心去看各类教程和各类例子，总算了解其中的规则，而后就试着本身搭建了一个本身的网站，在折腾了两三天后总算把本身的网站搞起来了，很不容易，下面我大体给你们介绍下个人搭建过程，可是具体我没细讲，每种环境的安装百度均可以搜索到很详细的教程，我只是在这给你们列举过程当中须要注意到的点。

1、概述

Jekyll 基于Ruby的静态网页生成系统，采用模板将Markdown(或Textile)文件转换为统一的网页

GitHub Pages 免费的静态站点，三个特色：免费托管、自带主题、支持自制页面和Jekyll

2、搭建步骤

一、创建Github Pages站点

要求：本地安装git，拥有我的的github帐号

首先，在你的github上创建一个以xxx.github.io为命名的代码仓库，其中xxx表明的是你的github帐号名，如个人帐号名是MealiaLin，则创建的是
mealialin.github.io，同时在底部Add .gitigore选择Jekyll模板，这样Jekyll产生的临时文件，
例如_site目录就不会添加到源代码管理中，固然你也能够之后手动配置

创建完代码仓库后，将代码仓库克隆到本地

$ git clone https://github.com/xxx/xxx.github.io.git

而后在本地的代码仓库里面建立一个测试页面并推送到github的代码仓库

$ cd xxx.github.io
$ echo "Hello World" > index.html
$ git add --all
$ git commit -m "Initial commit"
$ git push -u origin master

推送完代码后等一段时间，快的话几分钟，慢的话要二十分钟或者半个小时吧，等github运行编译你的代码，
完了以后在浏览器输入你的项目名称：xxx.github.io，若是一切正常，你就能看到一个显示Hello World的页面

二、安装配置jekyll

这一块很麻烦，尤为是基于windows环境的，坑太多，不过这种东西，都是踩着坑过河，习惯了就好，其实整个过程很简单，若是不算被坑的话半天就能
搭完整个环境和项目了，我的来讲，我在这一步卡了一天多了，接下来跟你们讲讲的我步骤，千万要记住，不要偷工减料，严格来作，哪一步装错了或者装少了
什么，建议卸了重头再来，毕竟重作比补坑简单多了

注意：全部安装过程当中涉及到的目录路径最好不要出现空格

（1）安装ruby，根据相关教程，无脑点就行，可是有个注意点，安装的路径中，连同命名，不要出现空格！！！

（2）ruby安装完，会出现有个选项，让你安装MSYS2这个东东，若是没有勾选，后面本身打开cmd，输入“ridk install”进行MSYS2的安装，会出现然你选择123，你选3就行。这个过程会下载不少安装包什么的，耐心等待，必定要耐心，要完整装完才行，装好会让你再作一次123选择，这个时候不须要选了，直接enter退出就好了。

（3）安装DevKit，在官网下载DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe，而后点击运行，一样，安装目录不要出现空格，能够百度这个相关的安装，仍是比较简单的

（4）而后安装RubyGems，从官网下载压缩包，解压到你想要的目录下，路径不要有空格，而后cmd命令指到这个文件夹下面，输入“ruby setup.rb”执行安装，一样也可百度

（5）安装bundler，输入“gem install bundler”执行安装

（6）上面的安装基本缺一不可，而后就能够安装jekyll了，执行“gem install jekyll”，最后成功了。

三、搭建项目

装完jekyll，项目代码就好办了，项目就能够在本地运行了。

（1）在你的本地代码仓库中，建立或使用模板，建立模板使用git bash输入命令“jekyll new project-name”就好了，可是建立模板
极其简陋，因此推荐你们使用第三方主题模板，找一个本身喜欢的主题放到你的本地代码仓库就好了。

（2）环境有了，模板也有了，接下来是本地运行代码了。首先，有些模板须要依赖，因此在你的本地代码仓库目录下使用cmd命令运行bundle install
命令安装依赖包，有时候用这个命令不行，会出现缺什么什么的，可使用“jekyll install xxx”来一个个安装缺的东西。装完之后运行
jekyll serve来启动本地服务器，默认使用4000端口，若是须要更换端口，能够运行“jekyll serve -P $POST”指定其余的端口。

（3）启动服务器了以后，在浏览器输入：“127.0.0.1:4000”就能够进行本地预览了，建议使用webstorm开发，本人超喜欢用ide家的开发工具

四、项目相关配置文件

jekyll项目的配置文件主要在于_config.yml里面，模板的配置都会有相关介绍，根据你选的模板在里面进行相应的信息修改就能够将模板转化为你的东西了

本文原文地址