Skip to content

Utility for extracting and converting YAML Front Matter from files.

License

Notifications You must be signed in to change notification settings

assemble/assemble-yaml

Repository files navigation

assemble-yaml NPM version Build Status

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.

Getting Started

npm install assemble-yaml --save

and use it as follows:

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

Methods

extract

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.
}

context

Return YAML front matter as a JSON object.

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

Alias:

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

content

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");

Release History

  • 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

Author

License

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


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

About

Utility for extracting and converting YAML Front Matter from files.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

  •  
  •  

Packages

No packages published