section-matter

Like front-matter, but supports multiple sections in a document.

Please consider following this project's author, Jon Schlinkert, and consider starring the project to show your :heart: and support.

Install

Install with npm:

1$ npm install --save section-matter

Usage

Params

• input {String|Buffer|Object}: If input is an object, it's content property must be a string or buffer.
• {Object}: options
• returns {Object}: Returns an object with a content string and an array of sections objects.

Example

1var sections = require('{%= name %}');
2var result = sections(input, options);
3// { content: 'Content before sections', sections: [] }

See available options.

Example

With the exception of front-matter, which must be the very first thing in the string, the opening delimiter of all other sections must be followed by a string to be used as the key for the section.

Given the following string:

Content before the sections.

---

More content.

---one
title: One
---

This is the first section.

The following code:

1console.log(sections(input));

Results in:

1{ 
2  content: 'Content before the sections.\n\n---\n\nMore content.\n',
3  sections: [
4    { 
5      key: 'one',
6      data: 'title: One',
7      content: '\nThis is the first section.' 
8    } 
9  ] 
10}

Options

options.section_parse

Type: function

Default: undefined

Function to be called on each section after it's parsed from the string.

Example

Given the following string (foo.md):

This is content before the sections.

---one
title: First section
---

This is section one.

---two
title: Second section
---

This is section two.

Using the following custom section_parse function:

1var fs = require('fs');
2var path = require('path');
3var yaml = require('js-yaml');
4var sections = require('section-matter');
5
6var str = fs.readFileSync('foo.md');
7var options = {
8  section_parse: function(section) {
9    console.log(section)
10    section.key = 'section-' + section.key;
11    section.data = yaml.safeLoad(section.data);
12  }
13};
14
15var result = sections(str, options);
16console.log(result);

Results in:

1{
2  content: 'This is content before the sections.\n',
3  sections: [
4    {
5      key: 'section-one',
6      data: { title: 'First section' },
7      content: '\nThis is section one.\n'
8    },
9    {
10      key: 'section-two',
11      data: { title: 'Second section' },
12      content: '\nThis is section two.\n'
13    }
14  ]
15}

options.section_delimiter

Type: string

Default: ---

Delimiter to use as the separator for sections. With the exception of front-matter, which must be the very first thing in the string, the opening delimiter of all other sections must be followed by a string to be used as the key for the section.

Example

1var input = '~~~\ntitle: bar\n~~~\n\nfoo\n~~~one\ntitle: One\n~~~\nThis is one';
2console.log(sections(input, {section_delimiter: '~~~'}));

Results in:

1{
2  content: '',
3  sections: [
4    {
5      key: '',
6      data: 'title: bar',
7      content: '\nfoo'
8    },
9    {
10      key: 'one',
11      data: 'title: One',
12      content: 'This is one'
13    }
14  ]
15}

About

1$ npm install && npm test

1$ npm install -g verbose/verb#dev verb-generate-readme && verb

Related projects

You might also be interested in these projects:

• assemble: Get the rocks out of your socks! Assemble makes you fast at creating web projects… more | homepage
• gray-matter: Parse front-matter from a string or file. Fast, reliable and easy to use. Parses YAML… more | homepage
• verb: Documentation generator for GitHub projects. Verb is extremely powerful, easy to use, and is used… more | homepage

Contributors

Author

Jon Schlinkert

• github/jonschlinkert
• twitter/jonschlinkert

License

Copyright © 2017, Jon Schlinkert. Released under the MIT License.

This file was generated by verb-generate-readme, v0.6.0, on October 23, 2017.