node package manager
Orgs are free. Discover, share, and reuse code in your team. Create a free org »

metalsmith-better-excerpts

metalsmith-better-excerpts

A Metalsmith plugin to extract/generate an excerpt from file content or metadata with multiple options.

npm Package Version MIT License Dependencies Status devDependencies Status Travis Build Status Code Climate GPA Code Climate Test Coverage

About

metalsmith-better-excerpts will generate an excerpt for each file object either from frontmatter/metadata, from content until the first more tag or from the first paragraph in content. So generated excerpt content can be additionally parsed by underscore.string's stripTags and prune functions, although prune can only be used together with stripTags.

Installation

$ npm install metalsmith-better-excerpts

CLI Usage

Install via npm and then add the metalsmith-better-excerpts key to your metalsmith.json with any options you want, like so:

{
  "plugins": {
    "metalsmith-better-excerpts": {
      "pruneLength": 80
    }
  }
}

Javascript Usage

Pass options to the plugin and pass it to Metalsmith with the use method:

var excerpts = require('metalsmith-better-excerpts');
 
metalsmith.use(excerpts({
    pruneLength: 80
}));

Options

All options are optional...

Defaults

var defaultOptions = {
        moreRegExp: /\s*<!--\s*more\s*-->/i,
        stripTags: true,
        pruneLength: 140,
        pruneString: ''
    };