用hexo创建github博客

倒腾了好久才用hexo加github搭建好属于自己的博客，好激动，为此写篇博客记录一下。
要使用hexo的话，需在你的系统中支持node.js和git。

安装node.js

安装git

安装Hexo

1. $ npm install -g hexo-cli     //全局安装hexo-cli
2. $ hexo init my-blog          //创建一个hexo框架
3. $ cd my-blog                 //进入目录
4. $ npm install                //安装依赖包
5. $ hexo generate              //生成静态文件
6. $ hexo server               //启动本地服务，可以通过http://locallhost:4000/ 访问

特别提示：
a. hexo generate(可以简写成 hexo g)生成静态文件，会在当前目录下生成一个新的为public的文件夹。
b. hexo server (可以简写成hexo s)启动本地web服务，可以在本地预览博客。
c. hexo deploy(可以简写成hexo d)部署博客到远程(如github)。
d. hexo new post-name(可简写成hexo n post-name,新建文章)
e. hexo new page page-name(可简写成hexo n page page-name,新建页面)
常用组合命令：
a. hexo d -g  (生成和部署)
b. hexo s -g   (生成和预览)

新建完成后，指定文件夹的目录如下：

|—— _config.yml             // 网站的配置信息
|—— package.json            // 项目包信息
|—— scaffolds               // 模板文件夹，Hexo根据scaffold中的模板来新建文件
|—— source                  // 存放用户资源的地方
|   |—— _drafts             // 存放草稿
|   |—— _posts              // 存放文章
|—— themes                  // 主题文件夹

_config.yml
网站的配置信息，可以在此配置大部分的参数。
例如：
到这里，你就可以用四步骤在本地预览到自己的博客了：

1.把markdown文章放到_posts文件夹。
2. $ hexo clean       //清除缓存文件db.json和已生成的静态文件public.
3. $hexo g              //生成静态文件，存放到当前一个新生成文件夹public里面。
4. $hexo s          //用浏览器访问http://localhost:4000,就可以在本地预览到自己的博客。

发布到github上面

打开你的github创建repository
repository相当于一个仓库，用来放置你的代码文件。登录进入github，并进入个人页面，选择repositories，然后New一个repository。创建时，只需要填写Repository name即可。注意：格式必须为username.github.io。

将本地博客部署到GitHub Pages
GitHub Pages用于介绍托管在GitHub的项目的，每个账号只能创建一个repository来存放GitHub Pages,再次强调仓库名格式必须是username.github.io,这是固定的命名约定。

创建后，可以通过http://username.github.io来访问个人主页。
GitHub Pages中个人主页的内容是在master分支下的。部署Hexo到GitHub Pages指的就是将hexo -g生成的静态文件推送到GitHub Pages对应的仓库中。

先修改你的_config.yml文件，一个正确的部署至少要有type参数。注意，hexo的配置文件中任何':'后面都是带一个空格的。如下：

deploy:
    type: git

发布到git上需要安装hexo-deployer-git插件。

$ npm install hexo-deployer-git --save

然后修改配置，即_config.yml文件：

deploy:
    type: git
    repo: https://github.com/username/username.github.io.git
    branch: master

配置完成之后就可以执行命令：

$ hexo d

这样就可以把你写的博客，推送到github上了。
但是由于我是第一次搭建，我想熟悉部署到github上的每一个过程，所以目前我没有使用hexo d 这个命令，而是用下面的方法把博客部署到github上的。
步骤如下：

1.把markdown文章放到_posts文件夹。
2. $ hexo clean       //清除缓存文件db.json和已生成的静态文件public.
  2.1. $hexo g              //生成静态文件，存放到当前一个新生成文件夹public里面。
  2.2. $hexo s          //用浏览器访问http://localhost:4000,就可以在本地预览到自己的博客。本地预览没有问题之后 ctrl+c.
3. cd username.github.io/     //cd 到你的git仓库文件夹，将刚刚生成的html复制(copy)到这个文件夹中。如下图cp -r ../../public/*  
 3.1 cp代表拷贝(cope的缩写)， -r代表连带着目录文件夹一起复制。
4. 在username.github.io的git仓库文件夹中提交到github中。
  4.1 git add .
  4.2 git commit
  4.3 git push origin master
  4.4 git pull origin master

这样我就把自己的博客部署到github上了。

image.png

文章著作权归irwenjing所有，转载须说明来源