0.1.1 • Published 3 years ago

@codepan/kiwi-gitbook-cli v0.1.1

Weekly downloads
-
License
MIT
Repository
-
Last release
3 years ago

介绍

该脚手架默会为您创建一个集成gitbook来构建静态电子书,集成gulp对静态资源进行压缩混淆,并集成了ftp和scp两种方式自动化部署到服务器上的一个脚手架工具

非常适合喜欢使用markdown语法来写技术文章、笔记总结等人群。

安装

yarn global add @codepan/kiwi-gitbook-cli

OR

npm i -g @codepan/kiwi-gitbook-cli

配置文件

使用脚手架初始化的项目,项目根路径下会有两个配置文件,文件必须存在,且文件位置和名字不能改动:

  • gitbook.config.js 项目配置文件,这个文件需要你使用commonjs规范导出一个对象进行配置
  • gulpfile.js gulp配置文件,一般情况下无需做变动

gitbook.config.js文件配置项

mode

类型:string

释义:部署到服务器上的模式,默认为scp,也可以不传

取值:ftpscp

entry

类型:string

释义:项目打包的入口,默认为./src

output

类型:string

释义:产出目录,默认为./dist

deploy

类型:object

释义:配置部署相关的参数

取值:

{
  projectName,
  rootPath,
  connectOptions
}

deploy.projectName

类型:string

释义:项目名称,即项目将来部署到服务器上的文件夹名字

deploy.rootPath

类型:string

释义:指定项目要部署到服务器上根路径

deploy.connectOptions

类型:object

释义:配置连接ftp服务器,或ssh连接服务器时所需的配置参数

取值:

{
  host,
  user,
  password
}

deploy.connectOptions.host

类型:string

释义:主机,填写IP地址

deploy.connectOptions.user

类型:string

释义:用户名

deploy.connectOptions.password

类型:string

释义:密码

deploy.devServer

类型:object

释义:配置开发服务器

取值:

{
  port,
  open,
  watch
}

deploy.devServer.port

类型:number

释义:端口号,默认为4000

deploy.devServer.open

类型:boolean

释义:是否自动打开浏览器,默认false

deploy.devServer.watch

类型:boolean

释义:是否开启监测模式,默认true

命令

查看版本

kiwi-gitbook -V|--version

使用帮助

kiwi-gitbook -h|--help

查看所有预设模板

kiwi-gitbook list

创建项目

kiwi-gitbook create <project>

启动web服务器,进行本地开发预览

kiwi-gitbook dev

构建项目

kiwi-gitbook build

部署项目

kiwi-gitbook deploy