Skip to content

kalamuna/metalsmith-env

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Metalsmith Enviromental Variables Plugin npm version

Build Status Dependency Status Greenkeeper badge

Metalsmith plugin to register all environmental variables as metadata.

Installation

npm install --save metalsmith-env

CLI

If you are using the command-line version of Metalsmith, you can install via npm, and then add the metalsmith-env key to your metalsmith.json file:

{
  "plugins": {
    "metalsmith-env": {}
  }
}

JavaScript

If you are using the JS Api for Metalsmith, then you can require the module and add it to your .use() directives:

var env = require('metalsmith-env');

metalsmith.use(env());

Usage

Once installed, all environment variables, from process.env, become available as Metalsmith metadata.

Options

opts.variables

An array of default variables that will be available. Environmental variables will then override the default set.

opts.overrides

An array of variables that will completely override the given set of environmental variables.

opts.env

The assumed environmental variables, defaults to process.env.

opts.metadatakey

Store the environmental variables under a metadata[metadatakey] instead of merging into metadata.

Example

The following example uses Jade and Metalsmith JSTransformer:

index.pug

---
title: Environmental Variables
---
doctype html
html(lang="en")
  head
    title= title
  body
    h1= title
    p This is the environmental variable "NODE_ENV":
    code
      pre= NODE_ENV

Build

$ NODE_ENV=production node_modules/.bin/metalsmith

Result

<!DOCTYPE html>
<html lang="en">
  <head>
    <title>Environmental Variables</title>
  </head>
  <body>
    <h1>Environmental Variables</h1>
    <p>This is the environmental variable "NODE_ENV":</p>
    <code><pre>production</pre></code>
  </body>
</html>

License

MIT

About

Metalsmith Environmental Variables Plugin

Resources

License

Stars

Watchers

Forks

Packages

No packages published