title: Hexo博客 新手安装及使用教程
date: 2017-10-07 14:46:55
tags: 教程
这是一篇基于Github搭建Hexo博客的基础教程，内容有：资源下载、安装步骤、发布更新文章、更换主题
资源下载
node.js
- node.js ，官网下载地址,下载完成，双击打开，选择下一步安装即可。注：尽量下载最新版本，避免报错。
Git
- Xcode自带Git
安装步骤
更换npm源
Node Package Manager 是node.js的模块依赖管理工具，由于国内有墙，使用时多有不便，国内有很多优秀的npm镜像。例如：
淘宝npm
registry地址：http://registry.npm.taobao.org/
cnpmjs
搜索地址：http://cnpmjs.org/
registry地址：http://r.cnpmjs.org/
配置npm
1 . 临时使用
* npm --registry https://registry.npm.taobao.org install express
2 . 持久使用
* npm config set registry https://registry.npm.taobao.org
// 配置后可通过下面方式来验证是否成功
* npm config get registry
// 或npm info express
3 . 使用cnpm
* npm install -g cnpm --registry=https://registry.npm.taobao.org
// 使用cnpm install expresstall express
安装Hexo
1 . 终端执行
$ sudo npm install -g hexo
输入管理员密码（Mac登录密码）即开始安装 (sudo:linux系统管理指令 -g:全局安装)
2 . 创建博客文件夹
这里可以选择一个固定的位置建立一个文件夹，例如我在‘文档’下建立一个‘MyselfBlog’的文件，以后所有操作都在这个文件下进行。
cd 到选择的目录，执行：
$ hexo init MyselfBlog
cd 到MyselfBlog，安装npm，执行：
$ npm install
开启hexo 服务器，执行：
$ hexo s
浏览器中打开http://localhost:4000
没有问题就会显示如下页面：
如果，页面打开显示为空，4000端口被占用，终端执行：
$ hexo server -p 5000
如果是其他类型的错误，到官网排查。
关联Git
- 登录github，新建仓库，注意命名规则‘用户名.github.io’,例如我的仓库名字就是‘SunShiLong.github.io’。仓库建立成功如下图：
- cd 回到‘MyselfBlog’目录，打开_config.yml文件，找到下面这段代码:
deploy:
type: git
repository: https://github.com/XXX/XXX.github.io.git
branch: master
注意：冒号后面有一个空格，把“XXX”换成自己仓库的名字。
- 生成静态页面，执行：
$ hexo generate 或者：hexo g
// 此时若出现如下报错：
ERROR Local hexo not found in ~/blog
ERROR Try runing: 'npm install hexo --save'
// 则执行命令：
$ npm install hexo --save
// 若无报错，自行忽略此步骤。
- 配置页面，执行：
$ hexo deploy 或者：hexo d
注意：若执行命令hexo deploy报错：无法连接git或找不到git，则执行如下命令来安装hexo-deployer-git：
$ npm install hexo-deployer-git --save
- 输入git账号和密码
打开网页地址
浏览器打开网址http://SunShiLong.github.io
本地打开http://localhost:4000 页面一致
发布文章
- cd 到‘MyselfBlog’目录，新建文章，执行
$ hexo new "NewBlog"
- 可以看到新建一个名为“NewBlog.md”的文件目录在MyselfBlog/source/_posts下，这里推荐使用markdown编辑博客，Mac端好用的编辑器有Mou和MacDown，但是Mou目前最高支持MacOS10.11，我的电脑系统是10.12，所有只好用MacDown。当然喜欢Vim的不受影响啦。
还不错吧，可以边码字边预览。
- 文章编辑完成，接下来就可以发布了，还是执行下面两句：
$ hexo generate //生成静态页面
$ hexo deploy //部署到Github
NOW, Hexo博客搭建教程就告一段落了
更换主题
所有基于github建立的hexo博客，默认主题都是landscape，可以自定义的，到主题官网选好自己喜欢的主题，例如主题Ada
cd 到‘MyselfBlog‘目录，执行：
$ git clone https://github.com/shuiRong/hexo-theme-Ada.git themes/Ada
// 将MyselfBlog目录下_config.yml里theme的名称landscape修改为Ada
$ hexo clean //清除缓存文件 (db.json) 和静态文件 (public)
$ hexo g //生成缓存和静态文件
$ hexo d //重新部署到服务器
每个主题都有详细的介绍，包括使用方法和内容修改，可以替换，名字、标题、图片、网址等。
