73 lines
2.2 KiB
Markdown
73 lines
2.2 KiB
Markdown
|
# Extending webpack in the SharePoint Framework toolchain
|
||
|
|
|
||
|
|
## Summary
|
||
|
|
SharePoint client-side development tools use gulp as the build process task runner to:
|
||
|
|
|
||
|
|
- Bundle and minify JavaScript and CSS files.
|
||
|
|
- Run tools to call the bundling and minification tasks before each build.
|
||
|
|
- Compile LESS or SASS files to CSS.
|
||
|
|
- Compile TypeScript files to JavaScript.
|
||
|
|
|
||
|
|
One common task you would want add to the SharePoint Framework toolchain is to integrate your custom gulp tasks and execute them.
|
||
|
|
|
||
|
|
This sample shows how to integrate custom gulp tasks using the [gulp-image-resize](https://www.npmjs.com/package/gulp-image-resize) task that resizes images.
|
||
|
|
|
||
|
|
Read the following documentation for detailed information on integrating gulp tasks in SharePoint Framework:
|
||
|
|
|
||
|
|
- [Integrate custom gulp tasks in the SharePoint Framework toolchain](https://aka.ms/spfx-extend-gulp)
|
||
|
|
|
||
|
|
## Applies to
|
||
|
|
|
||
|
|
* [SharePoint Framework Developer Preview](http://dev.office.com/sharepoint/docs/spfx/sharepoint-framework-overview)
|
||
|
|
* [Office 365 First Release Tenants](http://dev.office.com/sharepoint/docs/spfx/set-up-your-developer-tenant)
|
||
|
|
|
||
|
|
## Pre-requisites
|
||
|
|
|
||
|
|
### GraphicsMagick or ImageMagick
|
||
|
|
Make sure GraphicsMagick or ImageMagick is installed on your system and properly set up in your PATH.
|
||
|
|
|
||
|
|
#### Ubuntu:
|
||
|
|
|
||
|
|
```
|
||
|
|
apt-get install imagemagick
|
||
|
|
apt-get install graphicsmagick
|
||
|
|
```
|
||
|
|
|
||
|
|
#### Mac OS X (using Homebrew):
|
||
|
|
|
||
|
|
```
|
||
|
|
brew install imagemagick
|
||
|
|
brew install graphicsmagick
|
||
|
|
```
|
||
|
|
|
||
|
|
#### Windows & others:
|
||
|
|
|
||
|
|
http://www.imagemagick.org/script/binary-releases.php
|
||
|
|
|
||
|
|
Confirm that ImageMagick is properly set up by executing convert -help in a terminal.
|
||
|
|
|
||
|
|
## Solution
|
||
|
|
|
||
|
|
Solution|Author(s)
|
||
|
|
--------|---------
|
||
|
|
js-extend-gulp | Chakkaradeep Chandran (@chakkaradeep)
|
||
|
|
|
||
|
|
## Version history
|
||
|
|
|
||
|
|
Version|Date|Comments
|
||
|
|
-------|----|--------
|
||
|
|
1.0|January 25th, 2017|Initial release
|
||
|
|
|
||
|
|
## Disclaimer
|
||
|
|
**THIS CODE IS PROVIDED *AS IS* WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.**
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Minimal Path to Awesome
|
||
|
|
|
||
|
|
- Clone this repository
|
||
|
|
- in the command line run:
|
||
|
|
- `npm install`
|
||
|
|
- `gulp serve`
|
||
|
|
|
||
|
|
<img src="https://telemetry.sharepointpnp.com/sp-dev-fx-webparts/samples/js-extend-gulp" />
|