Tlin Blog > 运用码云搭建hexo博客（详细）

运用码云搭建hexo博客（详细）

2019-03-05

hexo

前言

Hexo是一个轻量级的Node.js博客框架
hexo部署在码云跟部署在github差不多，选择码云不仅仅因为“码云”与“马云”同音；
轻量级，国内的仓库，运营速度快；
中文直观，对于个人来说很方便，同时也可同步仓库。

一、准备工作

  • 1、首先你得有码云的账号。没有的点进去注册： https://gitee.com/
  • 2、你还要安装Git 链接：https://www.git-scm.com/downloads
  • 3、安装node.js 链接：https://nodejs.org/en/
  • 4、在CMD或右键Git Bash Here输入命令全局安装hexo：npm install -g hexo-cli
  • 5、安装好Git后建议：
    1
    2
    3
    4
    5
    全局配置用户名:git config --global user.name "用户名，最好跟github上的一致"
    全局配置邮箱:git config --global user.email "邮箱如：123456@qq.com，要跟github上的一致"

    查看用户名：git config user.name
    查看邮箱：git config user.email

二、下载模板、预览

tips：最好新建一个文件夹，依次执行以下命令把模板下载里面

  • 1、hexo init 项目名称
    （初始化hexo。项目名称可不要，不要的话不生成项目的文件夹，要的话就生成一个项目文件夹，文件夹名就是项目名称）
  • 2、进入下载模板的那个文件夹，右键git bash here，输入命令：hexo g (generate的缩写，生成，在根目录下生成一个public文件夹)
  • 3、启动服务进行本地预览：hexo s (s即server)
  • 4、在浏览器中输入：localhost:4000即可预览你的hexo，记住，千万别用IE打开，一个优秀的开发者就用优秀的浏览器打开（假装自己很优秀）
  • 具体步骤如下图

三、部署到码云

  • 1、创建。如图所示
  • 2、注意看图
    此处注意：最好创建一个首页访问地址不带二级目录的 pages，这样可以避免很多hexo路径等等带来的问题。
    码云官方文档：http://git.mydoc.io/?t=154714
  • 3、修改配置文件：_config.yml （注意：该全局配置文件是在根目录下，不是主题里面的！）
    在最后加上以下代码(注意type、repo后有一个空格)：
1
2
3
deploy:
    type: git
    repo: https://gitee.com/tilin/tilin.git
安装一个包，右键git bash here：npm i hexo-deployer-git --save
repo后的链接就是你码云的链接，就是前面创建的那个仓库链接，如图：
  • 4、上传项目：右键输入命令：hexo d (d即deploy，部署)
    部署成功后返回：
    部署的过程中可能要输入你的账号密码

四、开启pages

  • 如图所示：

五、重新部署及一些问题

  • 1、重新部署时建议输入指令，建议每次都这样（清除、生成、部署）：hexo clean && hexo g && hexo d
  • 2、配置文件要严格按照书写规范(type、repo后要跟一个空格，其它的最好也这样)：
    1
    2
    3
    deploy:
        type: git
        repo: https://gitee.com/tilin/tilin.git
  • 3、部署命令hexo s 后报错：ERROR Deployer not found: git

    这是因为你还没有安装hexo-deployer-git插件（Hexo 3.0以上版本默认是未安装的）。因此你需要手动安装：

    1
    2
    npm install hexo-deployer-git --save  # 安装此插件
    hexo d  # 安装完成后重新输入部署命令，则成功部署
  • 4、修改好了之后，hexo s 没有变化：执行一遍命令 hexo clean && hexo g && hexo s，若清除缓存等还不行，直接 hexo clean && hexo g && hexo d 是有点麻烦，通常都是好的，hexo s 会监视文件变动并自动更新，无须重启服务器。
  • 此外，另附Hexo之NexT主题的配置及遇到的问题，希望解决你的问题

以上就是简单的hexo部署到gitee,若你的hexo博客搭建失败、报错等等请静下心来找问题和解答的方案吧，我也是折腾了好久！

要是觉得不够，请看下一篇：hexo切换主题及其配置

附：

Thank you~