经过各种找资料,踩过各种坑,浏览了上百篇博客,终于搭建好了Hexo静态博客以及主题Next的配置,本篇只讲述如何搭建起来简单博客,后续会有文章讲解Hexo的主题。现在想把自己搭建博客的过程总结一下,方便自己和别人查看,中间可能有错误欢迎指出批评。此教程针对MAC OS的操作系统

本地配置环境

安装brewhome,一句话搞定(如果没有ruby环境请自行安装ruby环境)

ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"

安装Git(必须)

  • 作用:把本地的hexo内容提交到github上去.
  • 安装:

    1. 方式一:homebrew安装,一句话搞定

      sudo brew install git 
      
    2. 方式二:安装Xcode 自带Git无需在安装

安装Node.js(必须)

  • 作用:用来生成静态页面的
  • 安装:

    • 方式一:homebrew安装,一句话搞定

      brew install node
      
    • 方式二:到Node.js官网下载相应平台的最新版本,一路安装即可
  • 更新:node.js到最新稳定版

    node有一个模块叫n,是专门用来管理node.js的版本的。

    • 首先安装n模块:

      npm install -g n
      
    • 升级node.js到最新稳定版

      n stable
      
    • n后面也可以跟随版本号比如:

      n v5.4.1
      

安装Hexo(必须)

Node和Git都安装好后,可执行如下命令安装hexo:

npm install -g hexo
或者
sudo npm install --unsafe-perm --verbose -g hexo

检查环境是否安装成功

git --version
node -v
hexo -v

本地静态博客初始化

初始化:

执行init命令初始化hexo到你指定的目录,我是直接cd到目标目录执行hexo init的。命令:

    hexo init

生成静态页面:

cd 到你的init目录,执行如下命令,生成静态页面至hexo\public\目录。

hexo generate (hexo g  也可以)

本地启动:

启动本地服务,进行文章预览调试,命令:

hexo server (hexo s 也可以)

浏览器输入http://localhost:4000即可查看效果

Hexo常用命令:

hexo n "我的博客" == hexo new "我的博客" #新建文章
hexo p == hexo publish
hexo g == hexo generate#生成
hexo s == hexo server #启动服务预览
hexo d == hexo deploy#部署到服务器

hexo s -g == hexo server --generate == hexo generate --server
hexo d -g == hexo generate --deploy == hexo deploy --generate

hexo clean #清除缓存 网页正常情况下可以忽略此条命令

hexo new "postName" #新建文章
hexo new page "pageName" #新建页面

报错

  • 找不到git部署

    ERROR Deployer not found: git
    

    解决方法

    npm install hexo-deployer-git --save
    
  • hexo安装问题

    { [Error: Cannot find module './build/Release/DTraceProviderBindings'] code: 'MODULE_NOT_FOUND' }
    { [Error: Cannot find module './build/default/DTraceProviderBindings'] code: 'MODULE_NOT_FOUND' }
    { [Error: Cannot find module './build/Debug/DTraceProviderBindings'] code: 'MODULE_NOT_FOUND' }
    

    解决方法

    npm install hexo --no-optional
    

部署GitHub环境

  • 首先你得有个GitHub账号(没有注册啊)
  • 建立与你用户名对应的仓库,仓库名必须为:your_user_name.github.io
  • 打开仓库Settings页面,往下拉去找到:

    Lanunch automatic page generator
    
  • 点击进去一步一步设置启用GitPage就ok了

本地静态博客与GitHub建立关联

  • 打开本地博客站点根目录配置文件./_config.yml
  • 最下面找到下面位置修改(仓库地址一定是https://github.com/your_name/your_name.github.io.git)

    deploy:
        type: git  
        repository: https://github.com/Delyer/Delyer.github.io.git  
        branch: master #部署分支,一般使用master主分支
    

部署到Github

  • cd 到本地博客目录
  • hexo s -g #本地预览 control+c退出预览
  • hexo d -g 上传到GitHub 第一次需要输入你的GitHub用户名和密码

访问博客

  • 可以使用Github用户名.github.io进行访问,如:http://Delyer.github.io
  • 设置个性域名 (查看后面博客)
  • 配置站点信息 (查看后面博客)
  • 更换Hexo主题以及主题配置 (查看后面博客)