介绍Hexo安装,以及Hexo将已有的文件编译到github网站,生成个人博客网页…
具体参考hexo安装文档
hexo安装前提
安装 Hexo 相当简单,只需要先安装下列应用程序即可:
安装Hexo
1 | npm install -g hexo-cli |
对于熟悉 npm 的进阶用户,可以仅局部安装 hexo 包。
1 | npm install hexo |
安装以后,可以使用以下两种方式执行 Hexo:
npx hexo <command>
- 将 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
全局升级
- 全局升级
hexo-cli
,先hexo version
查看当前版本,然后npm i hexo-cli -g
,再次hexo version
查看是否升级成功。 - 使用
npm install -g npm-check
和npm-check
,检查系统中的插件是否有升级的,可以看到自己前面都安装了那些插件。 - 使用
npm install -g npm-upgrade
和npm-upgrade
,升级系统中的插件。 - 使用
npm update -g
和npm update --save
。
单独项目升级(推荐)
方法一
打开package.json, 修改 dependencies 项:
“hexo”: “^5.0.0”,
更新
1 | npm update |
hexo使用
安装 Hexo 完成后,请执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。
1 | hexo init <folder> |
新建完成后,指定文件夹的目录如下:
1 | . |
hexo写作
执行下列命令来创建一篇新文章或者新的页面。
1 | hexo new [layout] <title> |
您可以在命令中指定文章的布局(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
4deploy:
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 | npm install hexo-deployer-git --save |
部署完成后,可以在github的仓库中看到上传的文件。新开网页,地址栏输入:username.github.io可以看到自己的网站。