sections

2019-01-13 admin

sections是什么

什么是sections,Manipulate sections in a markdown string. A 'section' is a block of content preceded by a valid markdown ATX heading.

sections使用教程帮助文档

sections NPM version NPM monthly downloads NPM total downloads Linux Build Status

Manipulate sections in a markdown string. A ‘section’ is a block of content preceded by a valid markdown ATX heading.

Install

Install with npm:

$ npm install --save sections

Install with yarn:

$ yarn add sections

Usage

This is meant to be fast and opinionated, and only works with ATX headings.

var sections = require('sections');
var obj = sections.parse(str);

API

<details><summary>.parse</summary>

.parse

Parses sections in a string of markdown and returns an object with two properties:

  • sections: an array of markdown “sections”, delimited by ATX headings,
  • result: the cumulative result of whatever is returned by the (optional) function that is passed as the second argument. Returns an object that looks something like this

Params

  • string {String}
  • fn {Function}
  • returns {Object}

Example

var fs = require('fs');
var readme = fs.readFileSync('readme.md', 'utf8');
var sections = require('sections');
console.log(sections.parse(readme));
```</details> <details><summary>**.format**</summary>

### [.format](https://github.com/jonschlinkert/sections/blob/master/index.js#L72)

Format sections. By default, if no filter function is passed, this filters out empty sections fixes whitespace between sections.

**Params**

*   `str` **{String}**: Markdown string
*   `fn` **{Function}**: optional filter function
*   `returns` **{String}**</details> <details><summary>**.sortBy**</summary>

### [.sortBy](https://github.com/jonschlinkert/sections/blob/master/index.js#L117)

Sort the sections in a parsed sections object, by the given `prop` and array of `values`.

**Params**

*   `obj` **{Object}**: Object returned from .parse
*   `prop` **{String|Array}**: Defaults to `title`. The property to sort by, or the array of values to sort by.
*   `values` **{Array}**: Array of values to sort by.
*   `returns` **{Object}**</details> <details><summary>**.render**</summary>

### [.render](https://github.com/jonschlinkert/sections/blob/master/index.js#L152)

Renders the array of `sections` from .parse.

**Params**

*   `obj` **{Object}**: Sections object returned from .parse
*   `values` **{Array}**: (optional) To sort the array of sections by `title`, pass an array of values to sort by.
*   `returns` **{String}**

**Example**

```source-js
var fs = require('fs');
var readme = fs.readFileSync('readme.md', 'utf8');
var sections = require('sections');
var obj = sections.parse(readme);
var str = sections.render(obj);
console.log(str);
```</details> 

### Example object

The parsed object that is returned looks something like this:

```source-js
{ sections:
   [ Section {
       pos: 12,
       count: 0,
       string: '# sections \n',
       heading: '# sections',
       level: 1,
       title: 'sections',
       body: '' },
     Section {
       pos: 32,
       count: 1,
       string: '\n## Foo\nThis is foo\n',
       heading: '## Foo',
       level: 2,
       title: 'Foo',
       body: 'This is foo' },
     Section {
       pos: 52,
       count: 2,
       string: '\n## Bar\nThis is bar\n',
       heading: '## Bar',
       level: 2,
       title: 'Bar',
       body: 'This is bar' },
     Section {
       pos: 72,
       count: 3,
       string: '\n## Baz\nThis is baz\n',
       heading: '## Baz',
       level: 2,
       title: 'Baz',
       body: 'This is baz' } ],
  result: '',
  headings: [ 'sections', 'Foo', 'Bar', 'Baz' ] }

About

Related projects

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Building docs

(This project’s readme.md is generated by verb, please don’t edit the readme directly. Any changes to the readme must be made in the .verb.md readme template.)

To generate the readme, run the following command:

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

Running tests

Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:

$ npm install && npm test

Author

Jon Schlinkert

License

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


This file was generated by verb-generate-readme, v0.6.0, on April 27, 2017.

你可能感兴趣的文章:

本站文章除注明转载外,均为本站原创或编译。欢迎任何形式的转载,但请务必注明出处。

转载请注明:文章转载自 JavaScript中文网 [https://www.javascriptcn.com]

本文地址:https://www.javascriptcn.com/read-50887.html

文章标题:sections

回到顶部