HEXO搭建个人博客基础——建站发布

HEXO搭建属于你的个性化博客网站

HEXO搭建个人博客基础——建站发布

一、 HEXO 使用环境基础

HEXO博客搭建环境必须包括 nodejs-NodeJS 与 git -Git，从对应的官网进行对应的安装；

二、 本地建立HEXO项目（测试生成静态文件并本地运行）

执行下面的代码：

$ cd D:hexo/    #换成你的目录
$ npm install -g hexo-cli  #安装hexo脚手架
$ hexo init     #Hexo自动在当前文件夹下下载搭建网站所需的所有文件
$ npm install   #安装依赖包

$ hexo g        #完整命令为hexo generate，生成静态文件
$ hexo s        #完整命令为hexo server，启动服务器，用来本地预览
$ hexo d        #完整命令为hexo deploy，部署网站到GitHub或者gitee上（配置见下方）

三、页面部署到 Github Page 或者 Gitee page

3.1. Github Page

1. 在github上面创建仓库， 仓库名为：<Github账号名称>.github.io；
2. 添加SSH key，本地Hexo博客推送到GithubPages：
   • 配置下SSH，具体方法如下：
   • 先创建一个 SSH key 。在命令行（即Git Bash）输入以下命令， 回车三下即可：$ ssh-keygen -t rsa -C "邮箱地址"；
   • 复制密钥文件内容（路径形如 C:\Users\Administrator\.ssh\id_rsa.pub），粘贴到Github：setting–>SSH and GPG keys–>New SSH key 即可；
3. 修改HEXO 网站配置文件 _config.yml 的 deploy 字段，改为：

   deploy:
     type: git
     repo: git@github.com:<Github账号名称>/<Github账号名称>.github.io.git
     branch: master

4. 修改HEXO 网站配置文件 _config.yml 的 deploy 字段，改为：

   url: https://<Github账号名称>.gitee.io #填写自己的账号名称
   root: /

5. 执行命令进行网站静态文件上传：

   $ hexo clean
   $ hexo g --d

6. 在浏览器访问网址查看您的HEXO博客： https://<Github账号名称>.github.io

3.2. Gitee page

1. 在gitee上面创建一个空的仓库用于博客网站的发布；
2. 在hexo建立的本地博客目录下进入git bash，输入下面的命令后，打开生成的 id_rsa.pub 文件，复制公钥到gitee的 ssh key：

   ssh-keygen -t rsa -C "username"  #(注：username为你gitee上的用户名)

3. 修改hexo的完整根目录下的 _config.yml文件，增加 gitee 部署的相关信息：

   deploy:
     type: git
     repository: git@gitee.com:<Gitee账号名称>/<仓库名称>.git     #发布到gitee
     branch: master

4. 修改hexo的完整根目录下的 _config.yml文件，增加生成的文件的资源路径地址的相关信息（防止css等资源出错）：

   url: https://<Gitee账号名称>.gitee.io/<仓库名称>  #这个是gitee 上的博客仓库地址
   root: /<仓库名称>  #这个是博客项目的名字

5. 将博客内容提交到gitee后，开启 gitee pages 服务，可以看到部署的网站的页面，打开浏览器访问网址查看您的HEXO博客： https://<Gitee账号名称>.gitee.io/<仓库名称>/；

四、在GithubPages的基础上，添加自定义域名（您购买的域名）

4.1 域名配置

4.1.1 域名购买

这里我选择的是腾讯云购买的域名，购买成功后可以在控制台查看自己购买的域名，查看购买的域名的 服务状态显示为正常 ；

4.1.2 域名解析

方式1:（测试成功）

1. 点击域名的操作中的解析，进入域名的解析页面；
2. 点击 快速添加网站/ 邮箱解析，选择 网站解析，
3. 在网站解析中设置 ip 地址为 github 的IP地址，Github 的IP地址为 192.30.252.153；
4. 检验你的网站是否能够正确解析到 Github 的ip地址：DNS查询
   • 输入您购买的域名地址，选择为 A 类（默认的），进行检测，正确进行DNS解析表示域名ok了；

方式2:

1. 点击域名的操作中的解析，进入域名的解析页面；
2. 手动添加解析的相关类容：
   • 类型选择为 CNAME；
   • 主机记录即域名前缀，填写为www；
   • 记录值填写为自定义域名；（此处在配置中需要注意，容易出问题）
   • 解析线路，TTL 默认即可。
3. 检验你的网站是否能够正确解析:DNS查询
   • 输入您购买的域名地址，选择为 CNAME 类（默认的），进行检测，正确进行DNS解析表示域名ok了；

4.2 域名绑定 Github 的 Page 服务

1. 打开博客仓库设置：https://github.com/<Github账号名称>/<Github账号名称>.github.io/settings；
2. 其中的 Custom domain 允许您从<Github账号名称>.github.io以外的域服务您的站点，在输入框中填写您购买的域名，点击save；
3. 在HEXO站点目录的 source 文件夹下，新建文件 CNAME，写入你的域名（如www.geekleng.xyz）并保存；
4. 在HEXO的站点配置文件 _config.yml 文件中修改 skip_render字段，如下所示：

   skip_render: #跳过指定文件的渲染，可使用 glob 表达式来匹配路径，这里可以写README文件和保存你的域名
     - README.md
     - CNAME

5. 在浏览器中访问自定义的域名查看，同时 https://<Github账号名称>.github.io 也可用；