metalsmith-sharp

    3.1.0 • Public • Published

    metalsmith-sharp

    A fully flexible sharp implementation for Metalsmith

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

    Install

    npm install metalsmith-sharp

    Usage

    Just use it as regular Metalsmith plugin. An ES-Modules version is exposed as well, ready to be used with import sharp from 'metalsmith-sharp'

    const Metalsmith = require('metalsmith')
    const sharp = require('metalsmith-sharp')
    
    Metalsmith(__dirname)
      .use(
        sharp({
          methods: [
            {
              name: 'resize',
              args: [200, 200],
            },
            {
              name: 'resize',
              args: { fit: 'inside' },
            },
            {
              name: 'toFormat',
              args: ['jpeg'],
            },
          ],
        })
      )
      .build((err) => {
        if (err) return console.error(err)
        console.log('Build successfully finished! It is 🥙 time!')
      })

    You can also do multiple image manipulations in one call:

    const Metalsmith = require('metalsmith')
    const sharp = require('metalsmith-sharp')
    
    Metalsmith(__dirname)
      .use(
        sharp([
          {
            namingPattern: '{dir}{name}-version-1{ext}',
            methods: [
              { name: 'normalize' },
              { name: 'flop' },
              {
                name: 'trim',
                args: 15,
              },
            ],
          },
          {
            namingPattern: '{dir}{name}-version-2{ext}',
            methods: [
              { name: 'normalize' },
              {
                name: 'trim',
                args: 30,
              },
            ],
          },
        ])
      )
      .build((err) => {
        if (err) return console.error(err)
        console.log('Build successfully finished! It is 🥙 time!')
      })

    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],
        },
      ]
    }

    args

    args can be specified as an array that will be passed directly into the method or as a callback function.

    The callback function will be provided with the image metadata and should return an array.

    {
      method: [
        {
          name: 'resize',
          args: (metadata) => [
            Math.round(metadata.width * 0.5),
            Math.round(metadata.height * 0.5),
          ],
        },
      ]
    }

    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

    4

    Version

    3.1.0

    License

    MIT

    Unpacked Size

    12 kB

    Total Files

    4

    Last publish

    Collaborators

    • axe312