介绍Hexo安装，以及Hexo将已有的文件编译到github网站，生成个人博客网页…

具体参考hexo安装文档

hexo安装前提

安装 Hexo 相当简单，只需要先安装下列应用程序即可：

  • Node.js (Node.js 版本需不低于 8.10，建议使用 Node.js 10.0 及以上版本)
  • Git

安装Hexo

1
npm install -g hexo-cli

对于熟悉 npm 的进阶用户，可以仅局部安装 hexo 包。

1
npm install hexo

安装以后，可以使用以下两种方式执行 Hexo：

  1. npx hexo <command>
  2. 将 Hexo 所在的目录下的 node_modules 添加到环境变量之中即可直接使用 hexo command： 
    1
    echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile

添加显示图像

安装：

1
npm install https://github.com/CodeFalling/hexo-asset-image --save

并且_config.yml中：

1
post_asset_folder: true

升级hexo

全局升级

  1. 全局升级hexo-cli，先hexo version查看当前版本，然后npm i hexo-cli -g，再次hexo version查看是否升级成功。
  2. 使用npm install -g npm-check和npm-check，检查系统中的插件是否有升级的，可以看到自己前面都安装了那些插件。
  3. 使用npm install -g npm-upgrade和npm-upgrade，升级系统中的插件。
  4. 使用npm update -g和npm update --save。

单独项目升级（推荐）

方法一

打开package.json, 修改 dependencies 项：

“hexo”: “^5.0.0”,

更新

1
2
npm update
hexo -v

hexo使用

安装 Hexo 完成后，请执行下列命令，Hexo 将会在指定文件夹中新建所需要的文件。

1
2
3
hexo init <folder>
cd <folder>
npm install

新建完成后，指定文件夹的目录如下：

1
2
3
4
5
6
7
8
.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

hexo写作

执行下列命令来创建一篇新文章或者新的页面。

1
hexo new [layout] <title> # hexo new post hello

您可以在命令中指定文章的布局（layout），默认为 post，可以通过修改 _config.yml 中的 default_layout参数来指定默认布局。

在终端输入：hexo server, 在打开浏览器输入：http://localhost:4000,查看生成的本地静态网页。

hexo部署到github

详细说明查看hexo文档部署。

以上生成的文件以及文件夹，可理解为原始文件，hexo需要将其build成静态网页，部署到github即可查看：

  • 在github上新建一个repository，将其命名为username.github.io。

  • 修改hexo操作的文件夹主目录下的_config.yml文件，将repository属性修改为刚才新建的repository地址，最后记得加.git（个人测试可用，不同版本地址的形式可能不同），type属性在有的版本中为github，可自行尝试。以下设置，本人测试可用；

    1
    2
    3
    4
    deploy:
      type: git
      repository: https://github.com/username/username.github.io.git
      branch: master

  • 生成文件：hexo generate。简化命令hexo g。或者使用监视文件变动命令：hexo generate --watch，Hexo 能够监视文件变动并立即重新生成静态文件，在生成时会比对文件的 SHA1 checksum，只有变动的文件才会写入。

  • hexo deploy(简写hexo d)，deploy到github仓库

提示：最后两条指令可以使用hexo g -d或hexo d -g。两条命令作用相同，表示完成后部署。
如果最后一步部署出错，输入，

1
2
3
4
npm install hexo-deployer-git --save
hexo clean
hexo generate
hexo deploy

部署完成后，可以在github的仓库中看到上传的文件。新开网页，地址栏输入：username.github.io可以看到自己的网站。