1.0.4 • Published 5 years ago
@nonsugarless/webp-converter v1.0.4
@nonsugarless/webp-converter
"@nonsugarless/webp-converter" is the wrapper of webp-converter that allows you convert and delete WebP Images more easily.
Features
You can convert images to WebP Images and delete unnecessary WebP Images automatically.
Installation
yarn add -D @nonsugarless/webp-converteror
npm install --save-dev @nonsugarless/webp-converterUsage
Convert all images
$ webp-cli convertStart to watch images directory
$ webp-cli watchWebP Images will be converted automatically when images are added, changed and deleted.
Delete converted WebP Images
$ webp-cli cleanDelete converted WebP Images whose original one no longer exists in originalDir
$ webp-cli clean --allDelete all WebP Images from destDir
Default configuration
| Prop | Default | Description |
|---|---|---|
destDir | "./htdocs/img/" | Path to output images directory from project root |
originalDir | "./htdocs/img/" | Path to input images directory from project root |
targetExt | ".+(jpg|jpeg|png|gif)" | Extension of convert files |
excludeFileNames | "apple-touch-icon.png" | Array of filenames that you don't want to convert |
excludeDirNames | [] | Array of relative path from originalDir that you don't want to convert |
webpConverterOption | "-q 85" | WebP convert options |
webpConverterGifOption | "-q 85" | Gif WebP convert options |
Optional configuration
You can use an optional configuration .webpconverterrc file in JSON or YAML format or webpconverter.config.js file exporting a JS object by setting it project root directory. See cosmiconfig docs for more details.
{
"destDir": "./dest/img/",
"originalDir": "./src/img/",
"targetExt": ".+(jpg|png|gif)",
"excludeFileNames": ["apple-touch-icon.png", "og-image.png"],
"excludeDirNames": ["foo/bar"], // ignore all files below ./dest/img/foo/bar/
"webpConverterOption": "-q 75 -sharp_yuv -m 5 -mt",
"webpConverterGifOption": "-q 90 -m 5 -mt"
}API
Also you can use this as Node.js functions.
import { convertAll, watch, clean, cleanAll } from '@nonsugarless/webp-converter';
convertAll();It will be applied your configuration.