花了1晚上的时间终于把Hexo的博客搭建好了,托管在Coding.net上,记录下成功搭建的方法。
环境安装
首先安装hexo需要的两个软件来搭建基本环境。
- git
- Node.js
官网下载对应系统版本的安装包后跟着提示完成安装即可。
调整NPM
Hexo的安装依赖于Node.js的包管理工具NPM,所以在安装之前可以先对其做些设定方便使用
更改NPM镜像地址
Node.js自带的NPM镜像地址默认是国外镜像http://registry.npmjs.org,基本是龟速,慢的都怀疑已经无响应了,最好的方法就是换成国内的镜像。
强烈推荐淘宝的NPM - https://registry.npm.taobao.org,非常稳定、快速。
更改方法:
以Windows系统为例,打开Git Bash客户端,在命令行界面中
- 通过config命令配置
npm config set registry https://registry.npm.taobao.org npm info underscore
- 命令行指定
npm --registry https://registry.npm.taobao.org info underscore
- 编辑node_modules\npm.npmrc添加
registry = https://registry.npm.taobao.org
更新NPM
Node.js自带的NPM不一定是最新版,所以需要的时候可以更新下NPM版本
npm install npm
Git仓库
Coding.net
Git仓库本来首选逼格满满的GitHub,但是身处天朝对GitHub的访问速度实在不敢恭维,搜寻了一番,选择了国内版的Coding.net,感觉相当不错,特别其中的WebIDE是个强大的特性,改天研究下。
创建项目
注册一个Coding.net帐号,创建一个新项目,项目名称随意,如hexoblog,公开私有都可以。
创建之后在Pages 服务中开启部署分支,填master。
为了方便可以添加SSH公钥到Coding.net,参考方法
使用Hexo搭建博客框架
Hexo安装
在根目录(/)下启动Git Bash,输入命令
npm install hexo-cli -g
Hexo初始化
整体初始化博客目录,从服务器clone博客框架到本地,这里的blog是博客目录名称,可以随意设置
hexo init blog
Hexo核心模块安装
进入博客目录,进行模块安装
cd blog
npm install
安装其他必要模块组件
部署到git组件
npm install hexo-deployer-git --save
建立RSS订阅组件
npm install hexo-generator-feed --save
建立站点地图组件
npm install hexo-generator-sitemap --save
插件安装后,有的需要对配置文件_config.yml进行配置,具体怎么配置,可以参考上面插件在github主页上的具体说明。
启动Hexo服务器
hexo server
启动服务,在浏览器地址栏输入 http://localhost:4000/(默认端口为4000)便可以看到Hexo初始版的博客了,之后的博客修改都可以在这里预览。在Git Bash命令行窗口中Ctrl + C,输入Y可以停止服务。
Hexo操作
生成静态页面
hexo generate
或者简写
hexo g
部署静态页面到Git仓库
第一次部署前需要修改_config.yml文件进行配置。详细配置可以看官方配置文档
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo:
coding: [email protected]:USERNAME/PROJECTNAME.git,master
USERNAME是注册的用户名,PROJECTNAME是建立的项目名,然后分支选择master
再修改下URL的配置
# URL
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://USERNAME.coding.me/PROJECTNAME
root: /PROJECTNAME/
permalink: :year/:month/:day/:title/
permalink_defaults:
同样,USERNAME是注册的用户名,PROJECTNAME是建立的项目名,如果不这样修改的话,生成的静态页的CSS、JS文件等的路径会错误。
在Git Bash里输入以下命令,创建一个Staticfile空白文件,Coding.net需要Staticfile文件来作为以静态文件部署的标志。
cd source/
touch Staticfile #名字必须是Staticfile
一切妥当后,在Git Bash里输入以下命令,部署页面到远程master分支了
hexo deploy
或者简写
hexo d
部署完成后,可以访问连接http://USERNAME.coding.me/PROJECTNAME来查看建好的博客拉。