update-sections
![Build Status](https://camo.githubusercontent.com/57c8b2a330c2679c04c240eb9ea0f7da55405c15b465e096cf37a7295731ec19/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f6a6f6e7363686c696e6b6572742f7570646174652d73656374696f6e732e7376673f7374796c653d666c6174)
Easily prepend, append, inject or replace 'sections' in a markdown string.
Install
Install with npm:
$ npm install --save update-sections
Usage
var fs = require('fs');
var update = require('update-sections');
var readme = fs.readFileSync('README.md', 'utf8');
var snippet = fs.readFileSync('contributing.md', 'utf8');
// Inject the `contributing.md` string before the "License" section
var str = update(readme, 'License', snippet, 'before');
API
update
Re-write a layout with "sections" defined in a declarative configuration. The sections
property must be an array of section object, and each object must have all params defined: contents
, heading
and placement
.
Supported placement
values are:
inner
(or aliases:inside
andbetween
): inject the content directly after the heading, before the content of a sectionbefore
(or aliasprepend
): inject the content before the specified section's headingafter
(or aliasappend
): inject the content after the specified section's heading
Params
contents
{String}: the string with sections to updateheading
{String}: the heading of the existing section to match for placementvalue
{String}: the "snippet" to inject for the sectionplacement
{String}: where to place the new content, relative to the specified heading.returns
{String}
About
Contributing
Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
Building docs
(This document was generated by verb-generate-readme (a verb generator), please don't edit the readme directly. Any changes to the readme must be made in .verb.md.)
To generate the readme and API documentation with verb:
$ npm install -g verb verb-generate-readme && verb
Running tests
Install dev dependencies:
$ npm install -d && npm test
Author
Jon Schlinkert
License
Copyright © 2016, Jon Schlinkert. Released under the MIT license.
This file was generated by verb, v0.9.0, on July 27, 2016.