Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 1,000,000+ packages pre-installed, including metalsmith-if with all npm packages installed. Try it out:

var metalsmithIf = require("metalsmith-if")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

metalsmith-if v0.1.1

A Metalsmith plugin that allows you to execute another plugin conditionally.

metalsmith-if

A metalsmith plugin for adding conditional steps to your build process.

This is very useful when paired with metalsmith-watch and metalsmith-serve for skipping those plugins based on command-line flags or when in a non-interactive environment, for instance.

Installation

$ npm install metalsmith-if --save

Usage

Pass the plugin to Metalsmith#use:

var msIf = require('metalsmith-if');

metalsmith
  .use(msIf(
    true,
    plugin() // this plugin will run
  ))
  .use(msIf(
    false,
    plugin() // this plugin will not
  ));

The conditional can be any truthy or falsy statement; the plugin will run as if it had been called directly inside the use().

One 'gotcha': when using metalsmith-watch or other plugins that perform some immediate action upon instantiating (i.e. the livereload functionality), you may need to use the same conditional inside the options object to disable that. For example:

opts.watch = false;

metalsmith
  .use(msIf(
    opts.watch,
    watch({
      livereload: opts.watch
    })
  ))

License

MIT

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free