介绍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-checknpm-check,检查系统中的插件是否有升级的,可以看到自己前面都安装了那些插件。
  3. 使用npm install -g npm-upgradenpm-upgrade,升级系统中的插件。
  4. 使用npm update -gnpm 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 -dhexo d -g。两条命令作用相同,表示完成后部署。
如果最后一步部署出错,输入,

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

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