metalsmith-static-files

A Metalsmith plugin to copy a directory to the build directory


Keywords
metalsmith-static-files, metalsmith-plugin, metalsmith, static-site
License
MIT
Install
npm install metalsmith-static-files@0.4.0

Documentation

metalsmith-static-files

A Metalsmith plugin to copy a directory to the build directory

metalsmith:plugin npm: version license: MIT

Installation

NPM:

npm install metalsmith-static-files

Yarn:

yarn add metalsmith-static-files

Usage

Pass metalsmith-static-files to metalsmith.use. The source directory path is resolved to metalsmith.directory(). The destination path is resolved to metalsmith.destination().

const add = require('metalsmith-static-files')

metalsmith.use(add({
  source: 'src/assets/',
  destination: 'assets/',
}))

Plugin order

Typically, you want to use this plugin somewhere at the start of the chain, before any asset plugins are run, like @metalsmith/sass.

Debug

To enable debug logs, set the DEBUG environment variable to metalsmith-static-files:

Linux/Mac:

DEBUG=metalsmith-static-files

Windows:

set "DEBUG=metalsmith-static-files"

CLI usage

To use this plugin with the Metalsmith CLI, add metalsmith-static-files to the plugins key in your metalsmith.json file:

{
  "plugins": [
    {
      "metalsmith-static-files": {}
    }
  ]
}

License

MIT