https://github.com/assemble/grunt-assemble-contextual
Assemble middleware for generating a JSON file containing the context of each page. Basic middleware to help see what's happening in the build.
https://github.com/assemble/grunt-assemble-contextual
Last synced: 9 months ago
JSON representation
Assemble middleware for generating a JSON file containing the context of each page. Basic middleware to help see what's happening in the build.
- Host: GitHub
- URL: https://github.com/assemble/grunt-assemble-contextual
- Owner: assemble
- License: mit
- Created: 2013-10-14T14:58:28.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2015-09-25T13:17:08.000Z (over 10 years ago)
- Last Synced: 2025-08-29T21:54:32.283Z (9 months ago)
- Language: JavaScript
- Homepage:
- Size: 160 KB
- Stars: 7
- Watchers: 10
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE-MIT
Awesome Lists containing this project
README
# grunt-assemble-contextual [](http://badge.fury.io/js/grunt-assemble-contextual)
> Generates a JSON file with the context of each page. Basic plugin to help see what's happening in the build.
## Getting Started
In the command line, run:
```bash
npm install grunt-assemble-contextual --save
```
Next, to register the plugin with Assemble in your project's Gruntfile you can either specify the direct path to the plugin(s) (e.g. `./path/to/plugins/*.js`), or if installed via npm, make sure the plugin is in the `devDependencies` of your project.js package.json, and simply add the module's name to the `plugins` option:
```js
module.exports = function(grunt) {
// Project configuration.
grunt.initConfig({
assemble: {
options: {
plugins: ['grunt-assemble-contextual', 'other/plugins/*.js'],
contextual: {
dest: 'tmp/'
}
},
files: {
'dist/': ['templates/*.hbs']
}
}
});
grunt.loadNpmTasks('assemble');
grunt.registerTask('default', ['assemble']);
};
```
If everything was installed and configured correctly, after running `grunt assemble` you should see a JSON file for each page in the `dest` directory defined in the plugin's options. The basename of each page will be used as the name of each file.
_This plugin will make the build run slower!_ To disable it simple remove it from the options or remove the `dest` property.
Visit the [plugins docs](http://assemble.io/plugins/) for more info or for help getting started.
## Options
## dest
Type: `String`
Default: `assemble.dest + /tmp`
Destination of JSON context.
## Other grunt-assemble plugins
* [grunt-assemble](https://www.npmjs.com/package/grunt-assemble): Static site generator for Grunt.js, Yeoman and Node.js. Used by Zurb Foundation, Zurb Ink, H5BP/Effeckt,… [more](https://www.npmjs.com/package/grunt-assemble) | [homepage](http://assemble.io)
* [grunt-assemble-anchors](https://www.npmjs.com/package/grunt-assemble-anchors): Assemble plugin for creating anchor tags from headings in generated html using Cheerio.js. | [homepage](https://github.com/assemble/grunt-assemble-anchors)
* [grunt-assemble-decompress](https://www.npmjs.com/package/grunt-assemble-decompress): Assemble plugin for extracting zip, tar and tar.gz archives. | [homepage](https://github.com/assemble/grunt-assemble-decompress)
* [grunt-assemble-download](https://www.npmjs.com/package/grunt-assemble-download): Assemble plugin for downloading files from GitHub. | [homepage](https://github.com/assemble/grunt-assemble-download)
* [grunt-assemble-i18n](https://www.npmjs.com/package/grunt-assemble-i18n): Plugin for adding i18n support to Assemble projects. | [homepage](https://github.com/assemble/grunt-assemble-i18n)
* [grunt-assemble-lunr](https://www.npmjs.com/package/grunt-assemble-lunr): Assemble plugin for adding search capabilities to your static site, with lunr.js. | [homepage](http://assemble.io)
* [grunt-assemble-navigation](https://www.npmjs.com/package/grunt-assemble-navigation): Assemble navigation plugin. Automatically generate Bootstrap-style, multi-level side nav. See the sidenav on assemble.io for… [more](https://www.npmjs.com/package/grunt-assemble-navigation) | [homepage](https://github.com/assemble/grunt-assemble-navigation)
* [grunt-assemble-permalinks](https://www.npmjs.com/package/grunt-assemble-permalinks): Permalinks plugin for Assemble, the static site generator for Grunt.js, Yeoman and Node.js. This plugin… [more](https://www.npmjs.com/package/grunt-assemble-permalinks) | [homepage](https://github.com/assemble/grunt-assemble-permalinks)
* [grunt-assemble-sitemap](https://www.npmjs.com/package/grunt-assemble-sitemap): Sitemap plugin for Assemble | [homepage](http://assemble.io/plugins)
* [grunt-assemble-toc](https://www.npmjs.com/package/grunt-assemble-toc): Assemble middleware for adding a Table of Contents (TOC) to any HTML page. | [homepage](http://assemble.io)
* [grunt-assemble-wordcount](https://www.npmjs.com/package/grunt-assemble-wordcount): Assemble plugin for displaying wordcount and average reading time to blog posts or pages. | [homepage](https://github.com/assemble/grunt-assemble-wordcount)
## Contributing
Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](git://github.com/assemble/grunt-assemble-contextual/issues/new).
## Authors
**Jon Schlinkert**
+ [github/jonschlinkert](https://github.com/jonschlinkert)
+ [twitter/jonschlinkert](http://twitter.com/jonschlinkert)
## License
Copyright © 2015 Jon Schlinkert
Released under the MIT license.
***
_This file was generated by [verb-cli](https://github.com/assemble/verb-cli) on September 25, 2015._