Utility library for working with YAML front matter. Works with or without Assemble.

Visit Assemble's documentation for many more examples and pointers on getting started.

npm install assemble-yaml --save

and use it as follows:

var yfm = require('assemble-yaml');

Extract YAML front matter and content from files.

var raw = yfm.extract("./file.hbs", opts);

Parameters:

• String: The file to read.
• Object: The options object to pass to js-yaml

Returns:

Object with three properties

{
 "context": {}         // Object. YAML front matter returned as a JSON object.
 "content": ""         // String. File content, stripped of YAML front matter
 "originalContent": "" // String. Both content and YAML front matter.
}

Return YAML front matter as a JSON object.

var data = yfm.extract("./file.hbs").context;

Alias:

var data = yfm.extractJSON("./file.hbs");

Return the content of a file, with YAML front matter removed.

var content = yfm.extract("./file.hbs").content;

Alias:

var data = yfm.stripYFM("./file.hbs");

• 2013-09-27   v0.1.3   Adds extractJSON and stripYFM convenience methods. Add regex to strip extraneous newlines left over after YFM is removed from a file.
• 2013-09-22   v0.1.2   Adds grunt-readme and grunt-pkg-sync
• 2013-08-11   v0.1.0   Initial setup - Migrated from main Assemble repo

• github.com/doowb
• twitter.com/doowb

Copyright (c) 2013 Brian Woodward, contributors. Released under the MIT license

This file was generated on Mon Sep 02 2013 09:44:51.