forked from enviPath/enviPy
Current Dev State
This commit is contained in:
Tim Lorsbach
242
static/js/ketcher2/node_modules/gulp-hb/README.md
generated
vendored
Normal file
242
static/js/ketcher2/node_modules/gulp-hb/README.md
generated
vendored
Normal file
@ -0,0 +1,242 @@
|
||||
# `gulp-hb`
|
||||
|
||||
[![NPM version][npm-img]][npm-url] [![Downloads][downloads-img]][npm-url] [![Build Status][travis-img]][travis-url] [![Coverage Status][coveralls-img]][coveralls-url] [![Chat][gitter-img]][gitter-url] [![Tip][amazon-img]][amazon-url]
|
||||
|
||||
A sane static [Handlebars][handlebars] Gulp plugin. Useful as a static site generator. Think [Assemble][assemble], but with a lot less [Jekyll][jekyll] baggage.
|
||||
|
||||
For Grunt, see [`grunt-hb`][grunt-hb]. To precompile templates into JavaScript, see [`gulp-handlebars`][gulp-handlebars].
|
||||
|
||||
## Install
|
||||
|
||||
$ npm install --save-dev gulp-hb
|
||||
|
||||
## Usage
|
||||
|
||||
```js
|
||||
var gulp = require('gulp');
|
||||
var hb = require('gulp-hb');
|
||||
|
||||
// Basic
|
||||
|
||||
gulp.task('basic', function () {
|
||||
return gulp
|
||||
.src('./src/{,posts/}*.html')
|
||||
.pipe(hb({
|
||||
partials: './src/assets/partials/**/*.hbs',
|
||||
helpers: './src/assets/helpers/*.js',
|
||||
data: './src/assets/data/**/*.{js,json}'
|
||||
}))
|
||||
.pipe(gulp.dest('./web'));
|
||||
});
|
||||
|
||||
// Advanced
|
||||
|
||||
gulp.task('advanced', function () {
|
||||
var hbStream = hb()
|
||||
// Partials
|
||||
.partials('./partials/components/**/*.{hbs,js}')
|
||||
.partials('./partials/layouts/**/*.{hbs,js}')
|
||||
.partials({
|
||||
boo: '{{#each boo}}{{greet}}{{/each}}',
|
||||
far: '{{#each far}}{{length}}{{/each}}'
|
||||
})
|
||||
|
||||
// Helpers
|
||||
.helpers(require('handlebars-layouts'))
|
||||
.helpers('./helpers/**/*.js')
|
||||
.helpers({
|
||||
foo: function () { ... },
|
||||
bar: function () { ... }
|
||||
})
|
||||
|
||||
// Decorators
|
||||
.decorators('./decorators/**/*.js')
|
||||
.decorators({
|
||||
baz: function () { ... },
|
||||
qux: function () { ... }
|
||||
})
|
||||
|
||||
// Data
|
||||
.data('./data/**/*.{js,json}')
|
||||
.data({
|
||||
lorem: 'dolor',
|
||||
ipsum: 'sit amet'
|
||||
});
|
||||
|
||||
return gulp
|
||||
.src('./src/{,posts/}*.html')
|
||||
.pipe(hbStream)
|
||||
.pipe(gulp.dest('./web'));
|
||||
});
|
||||
```
|
||||
|
||||
### Template Context
|
||||
|
||||
The template context is constructed from pre-registered data and file-specific data. Pre-registered data is used as the root context for all templates and is set using the `.data()` method. File-specific data is used as the template context and is set via the [`file.data`](#file-specific-data-sources) property.
|
||||
|
||||
#### `@` Data Variables
|
||||
|
||||
##### @root
|
||||
|
||||
In cases where file-specific data keys collide with pre-registered data keys, you may access the pre-registered data via `@root`:
|
||||
|
||||
```handlebars
|
||||
{{ foo }}
|
||||
{{ @root.foo }}
|
||||
```
|
||||
|
||||
##### @file
|
||||
|
||||
In cases where information about the template file itself is needed, you may access the [file object][file] via `@file`:
|
||||
|
||||
```handlebars
|
||||
{{ @file.path }}
|
||||
```
|
||||
|
||||
#### File-specific Data Sources
|
||||
|
||||
File-specific data is set via the `file.data` property using other plugins such as [`gulp-data`][gulp-data], [`gulp-data-json`][gulp-data-json], or [`gulp-front-matter`][gulp-front-matter].
|
||||
|
||||
```js
|
||||
var gulp = require('gulp');
|
||||
var data = require('gulp-data');
|
||||
var frontMatter = require('gulp-front-matter');
|
||||
var hb = require('gulp-hb');
|
||||
|
||||
gulp.task('inject', function () {
|
||||
return gulp
|
||||
.src('./src/*.html')
|
||||
|
||||
// Load an associated JSON file per post.
|
||||
.pipe(data(function(file) {
|
||||
return require(file.path.replace('.html', '.json'));
|
||||
}))
|
||||
|
||||
// Parse front matter from post file.
|
||||
.pipe(frontMatter({
|
||||
property: 'data.frontMatter'
|
||||
}))
|
||||
|
||||
// Data for everyone.
|
||||
.pipe(hb().data('./data/**/*.js'))
|
||||
|
||||
.pipe(gulp.dest('./web'));
|
||||
```
|
||||
|
||||
#### Multiple Data Sources
|
||||
|
||||
Multiple data sources can be used to render the same set of templates to different directories using [`through2`][through2].
|
||||
|
||||
```js
|
||||
var gulp = require('gulp');
|
||||
var hb = require('gulp-hb');
|
||||
var through = require('through2');
|
||||
|
||||
gulp.task('i18n', function () {
|
||||
return gulp
|
||||
.src('./i18n/*.json')
|
||||
.pipe(through.obj(function (file, enc, cb) {
|
||||
var locale = file.stem;
|
||||
var data = {
|
||||
locale: locale,
|
||||
i18n: JSON.parse(file.contents.toString())
|
||||
};
|
||||
|
||||
gulp
|
||||
.src('./templates/**/*.html')
|
||||
.pipe(hb().data(data))
|
||||
.pipe(gulp.dest('./dist/' + locale))
|
||||
.on('error', cb)
|
||||
.on('end', cb);
|
||||
}));
|
||||
});
|
||||
```
|
||||
|
||||
## API
|
||||
|
||||
### `hb([options]): TransformStream`
|
||||
|
||||
- `options` `{Object}` (optional) Passed directly to [`handlebars-wax`][wax] so check there for more options.
|
||||
- `bustCache` `{Boolean}` (default: `true`) Force reload data, partials, helpers, and decorators.
|
||||
- `cwd` `{String}` (default: `process.cwd()`) Current working directory.
|
||||
- `debug` `{Number}` (default: `0`) Whether to log registered functions and data (level `1`) and glob parsing (level `2`).
|
||||
- `handlebars` `{Handlebars}` (optional) A specific instance of Handlebars, if needed.
|
||||
- `compileOptions` `{Object}` Options to use when compiling templates.
|
||||
- `templateOptions` `{Object}` Options to use when rendering templates.
|
||||
- `partials` `{String|Array.<String>|Object|Function(handlebars)}`
|
||||
- `parsePartialName` `{Function(options, file): String}`
|
||||
- `helpers` `{String|Array.<String>|Object|Function(handlebars)}`
|
||||
- `parseHelperName` `{Function(options, file): String}`
|
||||
- `decorators` `{String|Array.<String>|Object|Function(handlebars)}`
|
||||
- `parseDecoratorName` `{Function(options, file): String}`
|
||||
- `data` `{String|Array.<String>|Object}`
|
||||
- `parseDataName` `{Function(options, file): String}`
|
||||
|
||||
Returns a Gulp-compatible transform stream that compiles [Handlebars][handlebars] templates to static output.
|
||||
|
||||
### .partials(pattern [, options]): TransformStream
|
||||
|
||||
- `pattern` `{String|Array<String>|Object|Function(handlebars)}`
|
||||
- `options` `{Object}` Same options as `hb()`.
|
||||
|
||||
Loads additional partials. See [`handlebars-wax`][wax].
|
||||
|
||||
### .helpers(pattern [, options]): TransformStream
|
||||
|
||||
- `pattern` `{String|Array<String>|Object|Function(handlebars)}`
|
||||
- `options` `{Object}` Same options as `hb()`.
|
||||
|
||||
Loads additional helpers. See [`handlebars-wax`][wax].
|
||||
|
||||
### .decorators(pattern [, options]): TransformStream
|
||||
|
||||
- `pattern` `{String|Array<String>|Object|Function(handlebars)}`
|
||||
- `options` `{Object}` Same options as `hb()`.
|
||||
|
||||
Loads additional decorators. See [`handlebars-wax`][wax].
|
||||
|
||||
### .data(pattern [, options]): TransformStream
|
||||
|
||||
- `pattern` `{String|Array<String>|Object}`
|
||||
- `options` `{Object}` Same options as `hb()`.
|
||||
|
||||
Loads additional data. See [`handlebars-wax`][wax].
|
||||
|
||||
## Contribute
|
||||
|
||||
Standards for this project, including tests, code coverage, and semantics are enforced with a build tool. Pull requests must include passing tests with 100% code coverage and no linting errors.
|
||||
|
||||
### Test
|
||||
|
||||
$ npm test
|
||||
|
||||
----
|
||||
|
||||
© Shannon Moeller <me@shannonmoeller.com> (shannonmoeller.com)
|
||||
|
||||
Licensed under [MIT](http://shannonmoeller.com/mit.txt)
|
||||
|
||||
[assemble]: http://assemble.io/
|
||||
[context]: https://github.com/shannonmoeller/handlebars-wax#context-and-rendering
|
||||
[file]: https://github.com/gulpjs/vinyl#file
|
||||
[grunt-hb]: https://github.com/shannonmoeller/grunt-hb#usage
|
||||
[gulp-data]: https://github.com/colynb/gulp-data#usage
|
||||
[gulp-data-json]: https://github.com/kflorence/gulp-data-json#example
|
||||
[gulp-front-matter]: https://github.com/lmtm/gulp-front-matter#usage
|
||||
[gulp-handlebars]: https://github.com/lazd/gulp-handlebars#usage
|
||||
[handlebars]: https://github.com/wycats/handlebars.js#usage
|
||||
[jekyll]: https://jekyllrb.com/
|
||||
[through2]: https://github.com/rvagg/through2#api
|
||||
[wax]: https://github.com/shannonmoeller/handlebars-wax#usage
|
||||
|
||||
[amazon-img]: https://img.shields.io/badge/amazon-tip_jar-yellow.svg?style=flat-square
|
||||
[amazon-url]: https://www.amazon.com/gp/registry/wishlist/1VQM9ID04YPC5?sort=universal-price
|
||||
[coveralls-img]: http://img.shields.io/coveralls/shannonmoeller/gulp-hb/master.svg?style=flat-square
|
||||
[coveralls-url]: https://coveralls.io/r/shannonmoeller/gulp-hb
|
||||
[downloads-img]: http://img.shields.io/npm/dm/gulp-hb.svg?style=flat-square
|
||||
[gitter-img]: http://img.shields.io/badge/gitter-join_chat-1dce73.svg?style=flat-square
|
||||
[gitter-url]: https://gitter.im/shannonmoeller/shannonmoeller
|
||||
[npm-img]: http://img.shields.io/npm/v/gulp-hb.svg?style=flat-square
|
||||
[npm-url]: https://npmjs.org/package/gulp-hb
|
||||
[travis-img]: http://img.shields.io/travis/shannonmoeller/gulp-hb.svg?style=flat-square
|
||||
[travis-url]: https://travis-ci.org/shannonmoeller/gulp-hb
|
||||
Reference in New Issue
Block a user