From c2a0b763261dd89b5b2dc45ca97b03a795e124a9 Mon Sep 17 00:00:00 2001 From: Andrew Riddlestone Date: Sat, 1 Feb 2020 18:12:32 +0000 Subject: [PATCH] feat(docs): Added README Fixes #1 --- README.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..89fab69 --- /dev/null +++ b/README.md @@ -0,0 +1,55 @@ +# Riddlestone Brokkr-Gulpfile + +A [Laminas](https://github.com/laminas) module for creating [Gulp](https://gulpjs.com) config files + +## Installation + +Installation of this module uses composer. For composer documentation, please refer to +[getcomposer.org](http://getcomposer.org/). + +```sh +composer require riddlestone/brokkr-gulpfile +``` + +## Usage + +To include your js/sass files in the gulpfile, add them in portals to your module or site's config file: + +```php + [ + 'portals' => [ + 'main' => [ + 'css' => [ + realpath(__DIR__ . '/../resources/css/**/*.scss'), + ], + 'js' => [ + realpath(__DIR__ . '/../resources/js/**/*.js'), + ], + ], + ], + ], +]; +``` + +A gulpfile can now be created using the brokkr command `gulpfile`: +```sh +vendor/bin/brokkr gulpfile +``` + +## Changing the template + +To change the template for your gulpfile, just copy view/gulpfile.js.php somewhere, change it, and add the new path to your module/site's config: +```php + [ + 'template' => realpath(__DIR__ . '/../view/gulpfile.js.php'), + ], +]; +``` + +## Get Involved + +File issues at https://github.com/riddlestone/brokkr-gulpfile/issues