Gloups is a tool that uses the gulp ecosystem and provides services like compression of scripts (CSS and JS), compilation/processing LESS, SASS, STYLUS, TS, JS, CoffeeScript. The difference between Gloups and simply using gulp is that Gloups is set globally from a root path like C:\ folder on Windows systems or Home folder on Unix systems once and watches for multiple projects.
-
Get the gloups folder
$ git clone https://github.com/ManuUseGitHub/gloups.git -
Make sure gulp is updated and install npm dependencies
$ npm i -g gulp $ cd gloups $ npm install -
Check default configuration by running bellow command ... bad news should be printed out to catch your attention and guide you in order to show you how you have to configure gloups
$ gulp serviceMapping -
Once gloups is configured, generate custom configuration files by running the command :
$ gulp scanprojectsThe effect of that command is to create a config.mzg.json file in project root folders you specified in the custom/config.json file.
Config.mzg.json files are not blank and have instructions. In these files, uncomment what services you want to enable. Enable sourcemapping for services you want by switching sourcemaps fields to true.
-
Follow the paths you gave in the configuration, open the config.mzg.json file. Configure it by following instructions and examples.
-
Open a terminal into gloups folder and make Gloups serve you (watch over your projects)
$ gulp serve --all [--transitivity]Shorter :
$ gulp serve -a [-tr]
-
Get the dist folder
$ mkdir gloups $ cd gloups $ git init $ git remote add origin -f https://github.com/ManuUseGitHub/gloups.git $ git config core.sparsecheckout true $ echo dist/* >> .git/info/sparse-checkout $ git pull origin master -
Make sure gulp is updated and install npm dependencies
$ npm i -g gulp $ npm install -
Follow same steps as the installation for devs in End user installation (dev) section from step 3.
Once everything is set run gulp task 'serve' with options you want. The simplest way is to run all services via the preset --all with the transitive option :
$ gulp serve --sass --less --stylus --mincss --ts --coffeescript --minjs --transitive
Shorter (with --all option) :
$ gulp serve -a -tr
For every possibility, refer to the help.md file or with command run
$ gulp helpMe. Some of them can make the experience better such as the--essentialoption if Gloups is too much verbose for you. Just run$ gulp task --option(s) --essentialor shorter:$ gulp task -aliases -es
Go check help.md !
More fun stuffs ! The Gloups project aims to be scalable in terms of implementing the solution but also in user experience. This section covers what Gloups can offer to improve its utilization. Be aware without further ado. We've been creative to make you saving time!
Go check Extras.md !