Hexo安装使用
安装
安装 Hexo 只需几分钟时间。
安装前提
安装 Hexo 相当简单,只需要先安装下列应用程序即可:
如果您的电脑中尚未安装所需要的程序,请根据以下安装指示完成安装。
安装 Git
- Windows:下载并安装 git .
安装 Node.js
Node.js 为大多数平台提供了官方的 安装程序 。使用 Node.js 官方安装程序时,请确保勾选 Add to PATH 选项(默认已勾选)。
安装 Hexo
所有必备的应用程序安装完成后,即可使用 npm 安装 Hexo。
1 | $ npm install -g hexo-cli |
安装 Hexo 完成后,请执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。
1 | $ hexo init <folder> |
可以直接建立blog文件夹,在文件夹使用git bash操作命令
1 | $ hexo init |
新建完成后,指定文件夹的目录如下:
1 | . |
_config.yml
网站的 配置 信息,您可以在此配置大部分的参数。
服务器
hexo-server
Hexo 3.0 把服务器独立成了个别模块,您必须先安装 hexo-server 才能使用。
1 | $ npm install hexo-server --save |
安装完成后,输入以下命令以启动服务器,您的网站会在 http://localhost:4000
下启动。在服务器启动期间,Hexo 会监视文件变动并自动更新,您无须重启服务器。
1 | $ hexo server |
如果您想要更改端口,或是在执行时遇到了 EADDRINUSE
错误,可以在执行时使用 -p
选项指定其他端口,如下:
1 | $ hexo server -p 5000 |
静态模式
在静态模式下,服务器只处理 public
文件夹内的文件,而不会处理文件变动,在执行时,您应该先自行执行 hexo generate
,此模式通常用于生产环境(production mode)下。
1 | $ hexo server -s |
生成文件
使用 Hexo 生成静态文件快速而且简单。
1 | $ hexo generate |
监视文件变动
Hexo 能够监视文件变动并立即重新生成静态文件,在生成时会比对文件的 SHA1 checksum,只有变动的文件才会写入。
1 | $ hexo generate --watch |
完成后部署
您可执行下列的其中一个命令,让 Hexo 在生成完毕后自动部署网站,两个命令的作用是相同的。
1 | $ hexo generate --deploy |
GitHub Pages 一键部署
以下教学改编自 一键部署 。
安装 hexo-deployer-git 。Installation
1
$ npm install hexo-deployer-git --save
在
_config.yml
中添加以下配置(如果配置已经存在,请将其替换为如下):
1 | deploy: |
此部分需要前期工作先设置github的SHH登录,生成SHH密钥,添加到github后方可使用。具体设置可以参考GitHub帮助文档。
执行 hexo clean && hexo deploy
。
浏览 <GitHub 用户名>.github.io
检查你的网站能否运作。