Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

metalsmith-sharp

2.1.1 • Public • Published

metalsmith-sharp

A fully flexible sharp implementation for Metalsmith

MIT License js-standard-style Build Status CodeCov Badge David David semantic-release Commitizen friendly

Install

npm install --save metalsmith-sharp

Usage

Just use it as regular Metalsmith plugin. If your environment does not support the import syntax, see further below.

import Metalsmith from 'metalsmith'
import sharp from 'metalsmith-sharp'
 
Metalsmith('/path/to/project')
  .use(sharp({
    methods: [
      {
        name: 'resize',
        args: [ 200, 200 ]
      },
      { name: 'max' },
      {
        name: 'toFormat',
        args: [ 'jpeg' ]
      }
    ]
  }))
  .build()

Node 6

const sharp = require('metalsmith-sharp')

Node 4

A version for the LTS version of node is also supplied. You can require it like this:

const sharp = require('metalsmith-sharp/dist/node4')

For further examples can be found in the test directory.

Options

Default options:

{
  src: '**/*.jpg',
  namingPattern: '{dir}{base}',
  methods: [],
  moveFile: false
}

methods

Array of method objects that will trigger the corresponding sharp method. They will be called with the passed arguments and in the given order.

Check the sharp API documentation for a full list of supported methods.

{
  methods: [
    {
      name: 'anySharpMethod',
      args: [ 400, 300 ]
    }
  ]
}

src

Glob for matching source files. All minimatch features are supported.

{
  src: '**/*.jpg'
}

namingPattern

Renaming pattern for the resulting file. By default, the input file will be overwritten.

Supported placeholders:

  • {dir}: Directory of file followed by slash
  • {base}: Full filename with extension
  • {name}: Filename without extension
  • {ext}: File extension with leading dot
{
  namingPattern: '{dir}/{name}-thumb{ext}'
}

moveFile

If the resulting file has a different name, the default behavior is to create a new file and keep the input file. Set this option to true to delete the input file.

{
  moveFile: true
}

Development

This project follows the standard coding and the conventional changelog commit message style. Also it is configured to never decrease the code coverage of its tests.

Also make sure you check out all available npm scripts via npm run.

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue. But before doing anything, please read the CONTRIBUTING.md guidelines.

install

npm i metalsmith-sharp

Downloadsweekly downloads

1

version

2.1.1

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability