Hexo是一款基于 Node.js 的静态博客框架, 目前在 GitHub 上已有 9133 star 和 1499 fork。Hexo 生成的静态页面可以部署在 Github 或 Coding 上,并且能够免费绑定自己的域名,可以用来很方便地搭建个人博客。
一、安装 Git
搭建博客需要用到 git,下面这条命令可查看本机是否已安装 git,若未安装可参考这篇博文进行安装。
git --version
二、安装 Node.js
安装 Node.js 的最佳方式是使用 nvm。
cURL:
$ curl https://raw.github.com/creationix/nvm/v0.33.11/install.sh | sh
Wget:
$ wget -qO- https://raw.github.com/creationix/nvm/v0.33.11/install.sh | sh
安装完成后,重启终端并执行下列命令即可安装 Node.js。
$ nvm install stable
或者您也可以下载 安装程序 来安装。
三、安装 Hexo
所有必备的应用程序安装完成后,即可使用 npm 安装 Hexo。
$ npm install -g hexo-cli
以上安装配置如有问题请参考官方文档
四、本地建立博客
安装完成后,新建一个目录如 blog 用于存放博客,切换到该目录下执行以下指令,Hexo 即会在目标文件夹初步生成博客所需要的所有文件
hexo init
然后切换到该目录下执行如下命令,安装所需要的依赖
sudo npm install
生成静态页面
hexo g
启动本地服务
hexo s
生成静态页面与启动本地服务可以结合成以下指令
hexo s -g
打开浏览器,输入 http://localhost:4000/ ,看到页面说明hexo环境安装成功。
四、NexT主题配置
- 安装
将它的 Git 仓库 Clone 以后放到博客目录下的 themes 文件夹中即可
git clone https://github.com/iissnan/hexo-theme-next themes/next
- 启用
与所有Hexo主题一样,把主题源码导入themes目录后,打开根目录配置文件_config.yml
, 找到 theme 字段,并将其值更改为 next 就完成了主题的切换。
theme: next
四、部署到Coding Pages
在 Coding 新建一个项目,假设为 blog,然后修改本地博客目录下的 _config.yml 文件,根据官方文档的描述,修改以下几个参数,这些参数一般在文件底部:
deploy:
type: git #部署方式,这里我们用的是Coding的Git
repo: <repository url> #仓库地址,例如我的是git@git.coding.net:xxx/blog.git
branch: [branch] #分支名,可任意填写,我填写的是master
message: [message] #可不填,这是显示在提交记录里的描述信息,默认为日期
参数修改完成后,我们需要在终端中切换到博客所在目录安装 deploy 组建,执行以下命令将生成的博客静态页面 push 到我们上面在 Coding 创建的 blog 仓库中:
sudo npm install hexo-deployer-git --save
然后执行依次执行清理命令
hexo clean
生成命令:
hexo g
部署命令:
hexo d
如果在 _config.yml 的 repo 处填写的仓库地址是 https 形式的,在部署时可能需要输入你的 Coding 账号和密码。
然后切换到该项目的 Pages 标签,开启 pages 服务,分支名填写为我们在_config.yml 文件中设定的分支,我的是 master。
五、效果预览
pages 服务开启完成后,Coding 会提供一个类似 {user_name}.coding.me/{project_name} 的链接用于访问,例如用户名为 xxx 项目名为 blog 的链接应该是:
http://xxx.coding.me/blog
若资源加载失败,主题没有显示出来,查看根目录配置文件_config.yml
url: http://xxx.coding.me/blog/ #项目地址
root: /blog #项目名称
六、绑定域名
默认提供的链接可能过长或者不便于日常使用,我们也可以绑定自己的域名。首先,需要提前准备一个域名,然后打开自己的域名控制面板,新建一个 CNAME 解析到 {user_name}.coding.me,例如我的是将 www.xxx.com 解析到 xxx.coding.me; 然后,打开 Coding 项目页面切换到 pages 项,填入刚才的设置解析的域名 www.xxx.com,点击“添加域名绑定”按钮即可,在浏览器中直接访问 www.xxx.com 就能成功打开。 有时可能由于缓存或者解析时间的问题,稍等片刻即可。
七、撰写博客
hexo new "postName" #新建文章
hexo new page"pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
hexo deploy #将.deploy目录部署到指定空间
hexo help # 查看帮助
hexo version #查看Hexo的版本
- 使用命令直接创建一篇文章
hexo new "Hello Word"
成功后我们会在source文件夹下的_posts文件夹中找到我们刚刚创建的文件Hello Word.md,编写格式为markdown, 打开文件即可直接编写
- 手动在_posts文件夹下创建*.md文件的博客,但是我们自己要把头信息给补上
部署博客
hexo d -g