Hexo博客搭建

一、环境搭建

1.1 安装Node.js

（略）

检查安装情况。

muyijundeMacBook-Air:workspace_github yangjun$ node -v
v8.4.0
muyijundeMacBook-Air:workspace_github yangjun$ npm -v
5.3.0
muyijundeMacBook-Air:workspace_github yangjun$

1.2 安装hexo

hexo是基于node.js的静态博客，node.js自带的NPM需要FQ，使用淘宝NPM镜像防止被墙。

##使用root权限 全局安装cnpm
muyijundeMacBook-Air:.ssh yangjun$ sudo npm install -g cnpm --registry=https://registry.npm.taobao.org

使用淘宝NPM安装hexo

##使用root权限 全局安装hexo
muyijundeMacBook-Air:.ssh yangjun$ sudo cnpm install -g hexo-cli

1.3 新建项目

创建一个空文件夹进去初始化为hexo项目（过程需要联网）

$ hexo init
$ cnpm install

然后使用hexo s -g尝试启动

二、个性化配置

• 安装主题

  下载主题

  git clone https://github.com/zhwangart/hexo-theme-ocean.git themes/ocean
  

  修改hexo配置文件_config.yml

  theme: ocean
  

• 创建新页面

  创建分类页面

  hexo new page categories
  

  修改主题配置文件_config.yml来启用页面

  menu:
    主页: /
    分类: /categories
  

• 使用相对路径插入图片

  安装hexo-asset-image插件

  cnpm install hexo-asset-image --save
  

  使用方式：创建文章aa.md，在当前文件夹下创建文件夹aa，插入图片就可以直接用![](aa/1.jpg)

• 搜索

  Hexo提供的Local Search,原理是通过hexo-generator-search插件在本地生成一个search.xml文件，搜索的时候从这个文件中根据关键字检索出相应的链接。

  1. 安装 hexo-generator-search

     cnpm install hexo-generator-search --save
     

  2. 安装 hexo-generator-searchdb

     $ cnpm install hexo-generator-searchdb --save
     

  3. 启用搜索

     编辑站点配置文件

     search:
       path: search.xml
       field: post
       format: html
       limit: 1000012345
     

三、推送代码

3.1 GitHub创建新的repository

名称和用户名对应的取成：username.github.io

例如：

创建完成后在项目的setting标签页里面会显示发布的地址

3.2 安装并配置git

$ git config --global user.name "mooejun"
$ git config --global user.email "xxxxxxxxx@qq.com"
$ git config --global --list

3.3 修改hexo配置

编辑hexo配置文件_config.yml

deploy: 
  type: git
  #repository地址
  repository: https://github.com/looyang/looyang.github.io.git
  #master分支
  branch: master

保存后执行命令推送数据

$ hexo clean
$ hexo g
$ hexo d

需要注意的是，推送的数据是编译后的文件，不是hexo代码，所以最好把源代码也提交上去

创建hexo分支，提交代码

四、其他备忘

• hexo命令

  • hexo s --debug：以调试模式启动
  • hexo clean：清除 Hexo 的缓存
  • hexo s -g：正常启动
  • hexo s：正常启动
  • hexo server：正常启动
  • hexo generate：手动编译
  • hexo g：手动编译
  • hexo d：上传静态文件代码

• 创建流程

  1. 创建仓库，looyang.github.io；
  2. 创建两个分支：master 与 hexo；
  3. 设置master为默认分支（因为我们只需要手动管理这个分支上的Hexo网站文件）；
  4. 使用git clone git@github.com:looyang/looyang.github.io.git拷贝仓库；
  5. 在本地looyang.github.io文件夹下通过Git bash依次执行npm install hexo、hexo init、npm install 和 npm install hexo-deployer-git（此时当前分支应显示为hexo）;
  6. 修改_config.yml中的deploy参数，分支应为master；
  7. 依次执行git add 、git commit -m …git push origin master提交网站相关的文件；
  8. 执行hexo generate -d生成网站并部署到GitHub上。

  这样一来，在GitHub上的looyang.github.io仓库就有两个分支，一个hexo分支用来存放网站的原始文件，一个master分支用来存放生成的静态网页。完美( •̀ ω •́ )y！

• 本地资料丢失

  当重装电脑之后，或者想在其他电脑上修改博客，可以使用下列步骤：

  1. 使用git clone git@github.com:looyang/looyang.github.io.git拷贝仓库（默认分支为hexo）；
  2. 在本地新拷贝的looyang.github.io文件夹下通过Git bash依次执行下列指令：npm install hexo、npm install、npm install hexo-deployer-git（记得，不需要hexo init这条指令）。

• 使用 Hexo 部署博客到 Github Pages 时经常会遇到文件夹大小写问题导致的 404问题，如tag标签无法访问返回404

  当重装电脑之后，或者想在其他电脑上修改博客，可以使用下列步骤：

  原因
  git 默认忽略文件名大小写，所以即使文件夹大小写变更，git 也检测不到。

  解决办法
  进入到博客项目中 .deploy_git文件夹，修改 .git 下的 config 文件，将 ignorecase=true 改为 ignorecase=false

• hexo d上传的时候出现错误

  error: RPC failed; result=56, HTTP code = 200| 5.00 KiB/s
  fatal: The remote end hung up unexpectedlfy12
  

  原因
  导致传不上远程库这是由于博客源文件较大，需要将postBuffer设置大一些

  解决办法

  git config –global http.postBuffer 524288000
  

• bLF will be replaced

  Windows 提交命令的时候出现 warning: LF will be replaced by CRLF in XXXXXXXXXXXXXX 的警告。输入命令：

  解决办法

  git config --global core.autocrlf false