|
|
{ "name": "docpad-plugin-livereload", "version": "2.3.1", "description": "Automatically refreshes your website whenever a rengeration is performed", "homepage": "http://docpad.org/plugin/livereload", "keywords": [ "docpad", "docpad-plugin", "auto-update", "live-reload", "autoupdate", "livereload", "reload", "refresh", "sync" ], "author": { "name": "Bevry Pty Ltd", "email": "us@bevry.me", "url": "http://bevry.me" }, "maintainers": [ { "name": "Benjamin Lupton", "email": "b@lupton.cc", "url": "https://github.com/balupton" } ], "contributors": [ { "name": "Benjamin Lupton", "email": "b@lupton.cc", "url": "https://github.com/balupton" }, { "name": "Alex", "url": "https://github.com/amesarosh" } ], "bugs": { "url": "http://docpad.org/plugin/livereload/issues" }, "repository": { "type": "git", "url": "https://github.com/docpad/docpad-plugin-livereload.git" }, "engines": { "node": ">=0.4", "docpad": ">=6.3 <7" }, "dependencies": { "socket.io": "~0.9.13" }, "devDependencies": { "coffee-script": "~1.4.0" }, "main": "./out/livereload.plugin.js", "scripts": { "test": "node ./out/livereload.test.js" }, "readme": "# Live Reload Plugin for DocPad\nAutomatically refreshes your [DocPad](https://docpad.org) built website whenever a regeneration is performed\n\n\n\n## Install\n\n1. Install the Plugin\n\n ```\n npm install --save --force docpad-plugin-livereload\n ```\n\n1. Ensure your layout outputs the scripts block, using eco it will look something like this:\n\n ```\n <%- @getBlock('scripts').toHTML() %>\n ```\n\n\n## Configure\n\n### `enabled`\nBy default this plugin is disabled for all environments except the development environment. To enable on more environments set the `enabled` option to `true` inside your environments configuration.\n\n### `browserLog`\nBy default we will output a log message to the browser console if the browser was just reloaded by livereload. You can turn this off by setting the `browserLog` option to `false`. This feature requires `console.log` and `localStorage` to be available to the browser, if these aren't available then this feature will fail gracefully.\n\n### `regenerateBlock`\nBy default when a regeneration occurs we will log a message to the browser console (depending on the value of `browserLog`) and reload the browser. You can overwrite this functionality via the `regenerateBlock` option. \n\n### `inject`\nBy default we will inject the socket.io dependency if we don't automatically detect it's presence. However, sometimes this auto detection doesn't always work. If this is the case, you can disable the injection and just do the listening by setting the `inject` option to `false`.\n\n### `getSocket`\nBy default you we create a new socket.io instance for live reload, however if you are doing your own socket.io stuff you will probably want to use your existing instance instead. To do this set the `getSocket` option to a function that will return your own socket.io instance.\n\n### `channel`\nBy default we use the `/docpad-livereload` channel to listen to on our socket connection. You can change this by using the `channel` option.\n\n### `defaultLogLevel`\nBy default we use the socket.io log level of `1` (unless docpad is in debug mode in which case we will use the log level of `3`). You can change the default log level used (non-debug-mode) by setting the `defaultLogLevel` option.\n\n### `socketOptions`\nSometimes you may want to customise the options used for the [socket.io configuration](https://github.com/LearnBoost/Socket.IO/wiki/Configuring-Socket.IO). To do this set the `socketOptions` option to whatever you need.\n\n\n## History\nYou can discover the history inside the `History.md` file\n\n\n## License\nLicensed under the incredibly [permissive](http://en.wikipedia.org/wiki/Permissive_free_software_licence) [MIT License](http://creativecommons.org/licenses/MIT/)\n<br/>Copyright © 2012+ [Bevry Pty Ltd](http://bevry.me)", "readmeFilename": "README.md", "_id": "docpad-plugin-livereload@2.3.1", "_from": "docpad-plugin-livereload@"}
|
