gulp-mp-markdown-docs
v1.0.0
Published
avishnyak/gulp-markdown-docs
Downloads
3
Readme
gulp-mp-markdown-docs
Parse markdown into an navigable HTML document with themed code syntax highlighting (via highlight.js), navigation menu (via yaml meta information), and flexible templating and styling.
Forked from the original gulp-markdown-docs to add Windows support.
Install
$ npm install --save-dev gulp-markdown-docs
Usage
var gulp = require('gulp');
var markdownDocs = require('gulp-markdown-docs');
gulp.task('default', function () {
return gulp.src('docs/*.md')
.pipe(markdownDocs('index.html', {
... options ...
}))
.pipe(gulp.dest('./documentation/'));
});
OPTIONS (defaults shown)
Meta Information
yamlMeta: true
Required in order to construct the navigation menu. When set to true, each document given to gulp-markdown-docs should have a YAML header providing needed information about the document.
---
label: Nav Label
id: unique_slug
categorySlug:
categoryLabel:
categoryRank:
documentRank:
# Your Content
...
Sorting (yamlMeta
must be true)
If you wanted a document or category to always be at the end you could set this to 10000, or beginning -10000.
All sorting is done on a last-in basis, so the last rank seen is the value used for the category
NOTE slugs/ids need to be unique between categories and documents TODO: !!
categorySort: 'alphabetical', // 'alphabetical' || 'rank'
documentSort: 'alphabetical', // 'alphabetical' || 'rank'
External Stylesheet
stylesheetUrl: ''
Relative or absolute URL pointing to an external CSS resource. If defined will be added to the document in a link tag.
Layout Stylesheet
layoutStylesheetUrl: __dirname + '/resources/layout.css'
gulp-markdown-docs includes a simple layout by default. false
will prevent it from including that layout
Template HTML
templatePath: __dirname + '/resources/index.html'
gulp-markdown-docs includes a simple HTML document by default. Passing a path to a different HTML file allows you to customize the resulting documentation page.
NOTE This module looks for <head>...</head>
to add stylesheets to, and .doc-nav
and .doc-content
to append the navigation items and documentation respectively.
Highlight theme
highlightTheme: 'solarized_dark'
see highlight.js for available themes
Markdown
markdown: {
highlight: function (code) {
return highlight.highlightAuto(code).value;
},
renderer: new marked.Renderer(),
gfm: true,
tables: true,
breaks: false,
pedantic: false,
sanitize: true,
smartLists: true,
smartypants: false
}
Defaults shown. See documentation for marked for additional details.
License
MIT
Forked From: Christopher Meyer