个人博客搭建（一）

之前，尝试离线软件、动态网站搭建工作博客的尝试都失败了，无用功能太多，关键功能设置又太繁琐。而后不断尝试、兜兜转转，发现还是静态博客最方便，使用建站框架的话就更加简单。本博客使用比较流行的 Hexo 框架辅助博客搭建，同时将页面托管到码云。

工具选择

使用 Hexo 的理由很简单：

• Hexo 是比较成熟、稳定 —— 我不想花费太多时间再去为博客框架 debug
• 文档明白 —— 毕竟是湾湾友人写的，主页可选中文，中文文档再清晰不过，不懂编程也可以流畅使用

  

• 流行 —— 只要不是太奇葩的问题，总能在网上碰到现成的答案
• 主题很多，而且自主性很大 —— 既有官方主题库，也可在 GitHub 上搜索
• 命令简捷、明白

而后，就是要解决静态页面的托管工具，GitHub 的 pages 功能自然十分好用，可惜的是国内访问不够稳定，让我很抓狂。而后尝试改用码云，设置一样的简单，上传和访问速度都很快，目前很满意。

网站结构构建

本地环境搭建

前置需求：

• Hexo 需要 Node.js 的支持
• 托管服务要用到 Git

这两项安装都按照默认的设置进行即可。

注意：要在操作系统当前 Shell 的 PATH 变量中加入 node.js 和 git 的路径，保证可以以 CLI 方式使用它们。

npm 的默认源地址国内访问太看人品，最好改成淘宝的镜像：

1

npm config set registry http://registry.cnpmjs.org

软件下载与配置

1. 下载 Hexo 的 CLI 主体程序：

1

npm install -g hexo-cli

> 注意：下载及安装正常后，运行 hexo 命令，应该得到它的帮助界面：

2. 下载 Hexo 的 git 插件：

1

npm install hexo-deployer-git --save

3. 确定某个文件夹为 hexo 工作目录（或者新建一个），然后在 CLI 中进入这个文件夹，初始化 hexo 框架

1

hexo init

> 也可以用 `hexo init "directory"` 将指定目录划定为 hexo 工作目录，而后再切换目录

4. 生成项目所需文件：

1
2

npm install
hexo generate

这样就会自动生成网站的静态内容。

> `npm generate` 也可以简写为 `npm g`

5. 本地运行测试

1

hexo server

> 注意：如果 `hexo server` 命令运行有错，可以尝试先运行 `npm insatll`

而后，访问本地 http 服务器的 4000 端口，即：http://localhost:4000 会看到 hexo 框架自带的 hello world 页面：

> 注意：如果浏览器一直在载入过程中但不显示页面，或者无法打开网页，可能是端口被占用，尝试使用指定的新端口，如：`hexo server -p 5000`，相应浏览器地址也要更改为 http://localhost:5000

托管博客内容

创建码云项目

在码云上新建账号，此处步骤省略。 而后，为博客内容申请 pages 服务：

1. 先创建一个项目

   

2. 而后，将项目语言设定为 HTML，名称随意

   

hexo 配置

1. 获取项目的 https 地址

   

2. 用文本编辑器打开 hexo 工作目录中的 _config.yml 文件

3. 找到 deploy 选项，将子项 type 设置为 git

4. 将子项 repo 设为步骤 1 中获得的 https 地址，最后的结果为

1
2
3
4

deploy:
  type: git
  repo: https://git.oschina.net/cielsk43/example.git
  branch: master

5. 在 CLI 界面切换到 hexo 工作目录，使用部署命令

1

hexo deploy

6. 而后，会弹出登录对话框，输入码云的相应账号和密码即可

启动 pages 服务

1. 项目页面选择 pages 功能

   

2. 选择 master 分支，启动服务

   

总结

大功告成！ 这样，博客的页面就全部托管到了码云上。而后，码云会给出网站地址，就是个人博客的访问地址。 对于没有接触过类似服务的使用者来说，设置的步骤确实较长，好在一次设置好后就再也不用这么麻烦了。

后续文章

个人博客搭建（二）