Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/deepraining/lila
一个可扩展的、基于 gulp 的流式构建工具，支持多入口模式。An extensible streaming build tool of gulp, supporting multiple entries.
https://github.com/deepraining/lila
babel build cli gulp stream task teamwork tool web
Last synced: 2 months ago
JSON representation
一个可扩展的、基于 gulp 的流式构建工具，支持多入口模式。An extensible streaming build tool of gulp, supporting multiple entries.
- Host: GitHub
- URL: https://github.com/deepraining/lila
- Owner: deepraining
- License: mit
- Created: 2017-12-28T02:20:51.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2023-11-09T09:14:07.000Z (about 1 year ago)
- Last Synced: 2024-10-12T15:29:48.363Z (4 months ago)
- Topics: babel, build, cli, gulp, stream, task, teamwork, tool, web
- Language: JavaScript
- Homepage:
- Size: 1.04 MB
- Stars: 15
- Watchers: 3
- Forks: 11
- Open Issues: 0
-
Metadata Files:
- Readme: README.en.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# lila
[中文文档](./README.md)
An extensible streaming build tool of [gulp](https://github.com/gulpjs/gulp), supporting multiple entries.
## packages
- [lila-bin](./packages/lila-bin): lila command line tool
- [lila-core](./packages/lila-core): lila core library
- [lila-tasks](./packages/lila-tasks): lila built-in tasks
- [lila-webpack](./packages/lila-webpack): wrapped webpack plugin
- [lila-webpack-config](./packages/lila-webpack-config): built-in webpack config generator for lila-webpack
- [create-lila-app](./packages/create-lila-app): tool to create a lila application
## setup
It's recommended to use [create-lila-app](./packages/create-lila-app) to create a lila application, or use ready-made templates:
- [react-app-starter](https://github.com/deepraining/react-app-starter): A boilerplate for creating a React application, using Webpack and Storybook.
- [react-ts-app-starter](https://github.com/deepraining/react-ts-app-starter): A boilerplate for creating a React application, using TypeScript, Webpack and Storybook.
- [vue-app-starter](https://github.com/deepraining/vue-app-starter): A boilerplate for creating a Vue application, using Webpack and Storybook.
However, you can also customize it as you like, just follow these steps:
#### 1. install lila-bin
```
npm install lila-bin -g # global
npm install lila-bin --save-dev # local
```
If installed globally, you can run lila commands directly in terminal, like:
```
lila [options]
```
and if installed locally, you can run lila commands by [npm-scripts](https://docs.npmjs.com/misc/scripts):
```
# package.json
"scripts": {
"run": "lila [options]"
}
```
#### 2. install lila-core and lila-tasks
```
npm install lila-core lila-tasks --save-dev
```
#### 3. configure init file
Configure init file `lila.init.js`.
```
// lila-core should not be imported directly
import tasksPlugin from 'lila-tasks';
import otherPlugin from 'lila-other-plugin';
// here should export a function
// here lila object is lila-core package, and you can use all lila-core's api
export default lila => {
// do some init actions
tasksPlugin(lila);
otherPlugin(lila);
// here return a config generator
return ({ entry, argv, cmd }) => {
// make a config according to `entry, argv, cmd`
const config = { ... }
// return a config object
return config;
};
}
```
## base directory structure
```
- src/
- dev/
- build/
```
- `src`: where to place source codes, like `html, css, less, scss, js, ts, vue, ...`
- `dev`: a temporary directory, generated while developing
- `build`: where to generate production bundles
If you want custom names, you can modify them by:
```
lila.setSettings({
src: yourSrcDir,
dev: yourDevDir,
build: yourBuildDir,
})
```
## how to write plugins
```
export default lila => {
// here lila object is lila-core package, and you can do everything you want with lila api
};
```
## how to load plugins
In `lila.init.js`:
```
import plugin from 'your-lila-plugin';
export default lila => {
plugin(lila);
...
};
```
## trouble shooting
- In Windows, you must run `lila` command under the same directory with `node_modules`.