对archer进行二次开发前请阅读本文档。
docs
: 文档目录layout
: 模板目录source
: html模板文件,供Hexo加载src
: 源代码目录,会编译到source目录js
: js源代码scss
: scss源代码
如果需要修改页面结构,请修改 layout
中的ejs模板文件;如果需要修改样式,请修改 src/scss
中的scss文件;如果需要修改脚本,请修改 src/js
中的js文件。对scss和js的修改需要编译才能生成到 source
中,请参照下面的开发步骤。
提示:如果 hexo s
或 hexo g
很慢,在Hexo目录下的配置文件中加入以下字段忽略modules和.git文件。
ignore: ['**/themes/**/node_modules/**', '**/themes/**/node_modules', '**/themes/**/.git', '**/themes/**/.git/**']
- 安装依赖:在archer目录下执行
npm i
安装所需依赖(速度过慢的话请使用淘宝镜像)。
后续步骤开发分为本地开发,及编译发布两个过程。本地开发时在修改源代码时可以实时自动编译并刷新预览,编译发布在本地开发完成后编译压缩发布资源。(当然也可以跳过本地开发步骤直接修改源代码然后执行编译发布)。
注意:在开发时请先删除Hexo目录下的 public
文件夹避免造成干扰。
- 在Hexo目录下执行
hexo s
启动本地服务器。 - 在archer目录下执行
gulp dev
进入本地开发模式。
该模式会监视 src
和 layout
下的文件修改,实时进行编译,然后通过BrowserSync在 localhost:3000
(默认)下自动刷新页面(其他位置的文件修改并不会自动刷新页面,需手动刷新)。
- 在archer目录下执行
gulp build
即可编译到source
文件夹下。
编译完成后便可生成重新生成blog。