metalsmith-elevate

A metalsmith plugin for bumping files up one or more directories.

Similar to metalsmith-flatten, but omits chunks of the filepath entirely. Useful for organizing elements in the source but not in the build.

Currently a 0.0.0 release. Use at your own risk!

Installation

$ npm install metalsmith-elevate

Usage

Basic Example

var Metalsmith = require('metalsmith');
var elevate = require('metalsmith-elevate');

var metalsmith = new Metalsmith(__dirname)
  .use(elevate('blog/*/*.html'));

This will move all files matched by blog/*/*.html up one directory.

Before:

blog/
├── 2014/
|   ├── one.html
|   └── two.html
└── 2015/
    ├── three.html
    └── four.html

After:

blog/
├── one.html
├── two.html
├── three.html
└── four.html

Options

You can pass a pattern to the plugin directly or an object specifying one or more of these options.

Option	Default	Description
pattern	'*/**/*'	One or more globs for multimatch.
depth	-1	Negative numbers slice the file path relative to the number of segments it has. Positive numbers slice to that length.