halo-init

halo 应用初始化工具，所有 halo 应用开发必须安装。

Install

npm i halo-init -g
halo-init -h

创建 simple 类型的应用

halo-init --type simple [dest]

不输入类型可以选择

$ halo-init dest
? Please select a boilerplate type (Use arrow keys)
❯ simple - Simple egg app
  plugin - egg plugin

支持的参数

Usage: halo-init [dir] --type=simple

Options:
  --type          boilerplate type                                                [string]
  --dir           target directory                                                [string]
  --force, -f     force to override directory                                     [boolean]
  --template      local path to boilerplate                                       [string]
  --package       boilerplate package name                                        [string]
  --registry, -r  npm registry, support china/npm/custom, default to auto detect  [string]
  --silent        don't ask, just use default value                               [boolean]
  --version       Show version number                                             [boolean]
  -h, --help      Show help                                                       [boolean]

自定义模板

自定义模板采用 npm 包的形式管理

• 新建仓库如 egg-boilerplate-plugin
• boilerplate 目录下存放所有的初始化文件
• 可以使用 halo-init --template=PATH 本地检查生成效果
• index.js 文件可以声明要替换的变量，在 boilerplate 文件夹中写模板的时候，可以通过 {{name}} 占位符的方式进行替换

module.exports = {
  name: {
    desc: '插件名',
  },
  description: {
    desc: '插件描述',
  },
  author: {
    desc: '作者',
  },
};

• 更新依赖关系，只需要指定你的包名，更新到 egg-init-config 这个模块的 package.json 中 config.boilerplate 字段
• 发布模板（和配置）到 npm

License

MIT