Skip to content

Latest commit

 

History

History
41 lines (25 loc) · 1.93 KB

develop-guide-zh.md

File metadata and controls

41 lines (25 loc) · 1.93 KB

hexo-theme-archer 二次开发文档

对archer进行二次开发前请阅读本文档。

目录结构

  • docs : 文档目录
  • layout : 模板目录
  • source : html模板文件,供Hexo加载
  • src : 源代码目录,会编译到source目录
    • js : js源代码
    • scss : scss源代码

如果需要修改页面结构,请修改 layout 中的ejs模板文件;如果需要修改样式,请修改 src/scss 中的scss文件;如果需要修改脚本,请修改 src/js 中的js文件。对scss和js的修改需要编译才能生成到 source 中,请参照下面的开发步骤。

提示:如果 hexo shexo g 很慢,在Hexo目录下的配置文件中加入以下字段忽略modules和.git文件。

ignore: ['**/themes/**/node_modules/**', '**/themes/**/node_modules', '**/themes/**/.git', '**/themes/**/.git/**']

开发步骤

  1. 安装依赖:在archer目录下执行 npm i 安装所需依赖(速度过慢的话请使用淘宝镜像)。

后续步骤开发分为本地开发,及编译发布两个过程。本地开发时在修改源代码时可以实时自动编译并刷新预览,编译发布本地开发完成后编译压缩发布资源。(当然也可以跳过本地开发步骤直接修改源代码然后执行编译发布)。

注意:在开发时请先删除Hexo目录下的 public 文件夹避免造成干扰。

本地开发

  1. 在Hexo目录下执行 hexo s 启动本地服务器。
  2. 在archer目录下执行 gulp dev 进入本地开发模式。

该模式会监视 srclayout 下的文件修改,实时进行编译,然后通过BrowserSync在 localhost:3000 (默认)下自动刷新页面(其他位置的文件修改并不会自动刷新页面,需手动刷新)。

编译发布

  1. 在archer目录下执行 gulp build 即可编译到 source 文件夹下。

编译完成后便可生成重新生成blog。