Gulp plugin for html-toc, for generating a HTML table of contents.

Install with npm:

$ npm install --save gulp-html-toc

Install with yarn:

$ yarn add gulp-html-toc

var toc = require('gulp-html-toc');

gulp.task('toc', function() {
  return gulp.src('foo/*.html')
    .pipe(toc())
    .pipe(gulp.dest('bar'));
});

Type: string

Default: #toc (usage: <div id="toc"></div>)

Specify the id for where the table of contents should be injected.

Example

toc({id: '#navigation'});

In your HTML, add the following:

<div id="navigation"></div>

Type: boolean

Default: undefined

Set to false to disable anchors.

Example

toc({anchors: false});

Customize the template for creating anchors.

Type: function

Default

<a href="#${id}" name="${id}" class="anchor">
  <span class="anchor-target" id="${id}"></span>
  <span class="glyphicon glyphicon-link"></span>
</a>

Example

toc({
  anchorTemplate: function(id) {
    return `<a class="anchor" href="${id}" id="${id}"></a>`;
  }
});

Heading selectors to use for generating the table of contents.

Type: string

Default: h1,h2

Example

Generate a table of contents for all headings h1-h4.

toc({selectors: 'h1,h2,h3,h4'});

• gulp-htmlmin: gulp plugin to minify HTML. | homepage
• gulp-prettify: Prettify, format, beautify HTML. | homepage
• html-toc: Generate a HTML table of contents using cheerio. | homepage

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

Please read the contributing guide for advice on opening issues, pull requests, and coding standards.

(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 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

Jon Schlinkert

• github/jonschlinkert
• twitter/jonschlinkert

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

This file was generated by verb-generate-readme, v0.5.0, on April 17, 2017.