{"id":16254217,"url":"https://github.com/indieisaconcept/grunt-styleguide","last_synced_at":"2025-05-16T19:03:26.297Z","repository":{"id":57255791,"uuid":"6277156","full_name":"indieisaconcept/grunt-styleguide","owner":"indieisaconcept","description":"Universal CSS styleguide generator for grunt. Easily integrate Styledocco or KSS styleguide generation into your development workflow.","archived":false,"fork":false,"pushed_at":"2022-11-20T08:57:23.000Z","size":1074,"stargazers_count":532,"open_issues_count":2,"forks_count":49,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-05-13T08:48:46.508Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/indieisaconcept.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-MIT","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-10-18T11:06:57.000Z","updated_at":"2024-11-05T11:03:31.000Z","dependencies_parsed_at":"2022-09-04T23:01:05.613Z","dependency_job_id":null,"html_url":"https://github.com/indieisaconcept/grunt-styleguide","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/indieisaconcept%2Fgrunt-styleguide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/indieisaconcept%2Fgrunt-styleguide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/indieisaconcept%2Fgrunt-styleguide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/indieisaconcept%2Fgrunt-styleguide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/indieisaconcept","download_url":"https://codeload.github.com/indieisaconcept/grunt-styleguide/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254592367,"owners_count":22097010,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-10T15:20:40.660Z","updated_at":"2025-05-16T19:03:26.235Z","avatar_url":"https://github.com/indieisaconcept.png","language":"HTML","funding_links":[],"categories":["📦 Legacy \u0026 Inactive Projects"],"sub_categories":[],"readme":"## Please note grunt-styleguide is no longer actively maintained. If you would like to maintain please raise an issue. \n\nIf you are looking for a replacement and are using kss or styledocco see below.\n\n- https://www.npmjs.com/package/grunt-kss\n- https://www.npmjs.com/package/grunt-styledocco\n\n# grunt-styleguide [![build status](https://secure.travis-ci.org/indieisaconcept/grunt-styleguide.png)](http://travis-ci.org/indieisaconcept/grunt-styleguide) [![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/indieisaconcept/grunt-styleguide/trend.png)](https://bitdeli.com/free \"Bitdeli Badge\") [![Views in the last 24 hours](https://sourcegraph.com/api/repos/github.com/indieisaconcept/grunt-styleguide/counters/views-24h.png)](https://sourcegraph.com/github.com/indieisaconcept/grunt-styleguide)\n\n[![NPM](https://nodei.co/npm/grunt-styleguide.png?downloads=true\u0026stars=true)](https://nodei.co/npm/grunt-styleguide/)\n\n\u003e Universal CSS styleguide generator for grunt. Easily integrate Styledocco or KSS styleguide generation into your development workflow.\n\n## Frameworks\n\n[styledocco]: http://jacobrask.github.com/styledocco/\n[kss-node]: https://github.com/hughsk/kss-node\n[jss-styles]: https://github.com/jesseditson/jss\n[extending grunt-styleguide]: /grunt-styleguide/blob/master/docs/extending_grunt-styleguide.md\n\n### Supported\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003cth\u003eFramework\u003c/th\u003e\n    \u003cth\u003ePreprocessor\u003c/th\u003e\n\t\u003cth\u003eTemplates\u003c/th\u003e\n  \u003c/tr\u003e\u003ctr\u003e\n    \u003ctd\u003e\u003ca href=\"http://jacobrask.github.com/styledocco/\"\u003estyledocco\u003c/a\u003e\u003c/td\u003e\n    \u003ctd\u003eLess, Sass\u003c/td\u003e\n    \u003ctd\u003eDefault template provided by styledocco is used\u003c/td\u003e\n  \u003c/tr\u003e\u003ctr\u003e\n    \u003ctd\u003e\u003ca href=\"https://github.com/hughsk/kss-node\"\u003ekss-node\u003c/a\u003e\u003c/td\u003e\n    \u003ctd\u003eLess\u003c/td\u003e\n    \u003ctd\u003eCustom templates can be used\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## Getting Started\n_If you haven't used [grunt][] before, be sure to check out the [Getting Started][] guide._\n\nFrom the same directory as your project's [Gruntfile][Getting Started] and [package.json][], install this plugin with the following command:\n\n```bash\nnpm install grunt-styleguide --save-dev\n```\n\nOnce that's done, add this line to your project's Gruntfile:\n\n```js\ngrunt.loadNpmTasks('grunt-styleguide');\n```\n\nIf the plugin has been installed correctly, running `grunt --help` at the command line should list the newly-installed plugin's task or tasks. In addition, the plugin should be listed in package.json as a `devDependency`, which ensures that it will be installed whenever the `npm install` command is run.\n\n[grunt]: http://gruntjs.com/\n[Getting Started]: https://github.com/gruntjs/grunt-docs/blob/master/Getting-started.md\n[package.json]: https://npmjs.org/doc/json.html\n\n## The \"styleguide\" task\n\n### Overview\nIn your project's Gruntfile, add a section named `styleguide` to the data object passed into `grunt.initConfig()`.\n\n```\ngrunt.initConfig({\n\n  styleguide: {\n\n    options: {\n      // global options\n    },\n\n    your_target: {\n\n    \toptions: {\n    \t\t// task options\n    \t},\n\n\t    files: {\n\t        // files to process\n\t    }\n\n    }\n\n  }\n\n})\n```\nAn example configuration can be viewed [here](https://gist.github.com/3932026)\n\n#### Options\n\nBy default **grunt-styleguide** will attempt to rationalize options for each of the styleguide frameworks supported depending upon the features available to the framework in use.\n\n##### Defaults\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003cth\u003eKey\u003c/th\u003e\n    \u003cth\u003eType\u003c/th\u003e\n    \u003cth\u003eDefault\u003c/th\u003e\n\t\u003cth\u003eRequired\u003c/th\u003e\n    \u003cth\u003eDescription\u003c/th\u003e\n  \u003c/tr\u003e\u003ctr\u003e\n    \u003ctd\u003eframework\u003c/td\u003e\n    \u003ctd\u003eString, object, function (*)\u003c/td\u003e\n    \u003ctd\u003estyledocco\u003c/td\u003e\n    \u003ctd\u003eNo\u003c/td\u003e\n    \u003ctd\u003eDetails about the styleguide framework\u003c/td\u003e\n  \u003c/tr\u003e\u003ctr\u003e\n    \u003ctd\u003ename\u003c/td\u003e\n    \u003ctd\u003eString\u003c/td\u003e\n\t\u003ctd\u003eundefined\u003c/td\u003e\n    \u003ctd\u003eNo\u003c/td\u003e\n    \u003ctd\u003eTitle of the styleguide\u003c/td\u003e\n  \u003c/tr\u003e\u003ctr\u003e\n    \u003ctd\u003etemplate\u003c/td\u003e\n    \u003ctd\u003eObject\u003c/td\u003e\n\t\u003ctd\u003eTemplate bundled with framework\u003c/td\u003e\n    \u003ctd\u003eNo\u003c/td\u003e\n    \u003ctd\u003eDetails of the templates to use for rendering if supported\u003c/td\u003e\n  \u003c/tr\u003e\u003ctr\u003e\n    \u003ctd\u003efiles\u003c/td\u003e\n    \u003ctd\u003eObject, String, Array\u003c/td\u003e\n    \u003ctd\u003eundefined\u003c/td\u003e\n    \u003ctd\u003eYes\u003c/td\u003e\n    \u003ctd\u003eDetails of the templates to use for rendering if supported\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003e \\* See [extending grunt-styleguide]()\n\n#### Framework Options\n\nShould you wish to pass additional options which are supported by a framework then these can be passed as an options as part of the framework object.\n\n```\nstyleguide: {\n\n\tdist: {\n\n\t\toptions: {\n\n\t\t\tframework: {\n\t\t\t\tname: 'framework_name',\n\t\t\t\toptions: {\n\t\t\t\t\t'somearg': 'somevalue',\n\t\t\t\t\t'someflag: true\n\t\t\t\t}\n\t\t\t}\n\n\t\t},\n\n\t\tfiles: {\n\t\t\t'path/to/dest': 'path/to/source'\n\t\t}\n\n\t}\n\n}\n```\n\n#### Template Options\n\nDepending upon the framework, it may be possible to also pass templates to use for rending a styleguide.\n\n```\nstyleguide: {\n\n\tdist: {\n\n\t\toptions: {\n\n\t\t\ttemplate: {\n\t\t\t\tsrc: 'path/to/templates',\n\t\t\t\tinclude: ['path/of/resources/to/include']\n\t\t\t}\n\n\t\t},\n\n\t\tfiles: {\n\t\t\t'path/to/dest': 'path/to/source'\n\t\t}\n\n\t}\n\n}\n```\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003cth\u003eKey\u003c/th\u003e\n    \u003cth\u003eType\u003c/th\u003e\n\t\u003cth\u003eRequired\u003c/th\u003e\n    \u003cth\u003eDescription\u003c/th\u003e\n  \u003c/tr\u003e\u003ctr\u003e\n    \u003ctd\u003esrc\u003c/td\u003e\n    \u003ctd\u003eString\u003c/td\u003e\n    \u003ctd\u003eNo\u003c/td\u003e\n    \u003ctd\u003eLocation of the template to use\u003c/td\u003e\n  \u003c/tr\u003e\u003ctr\u003e\n    \u003ctd\u003einclude\u003c/td\u003e\n    \u003ctd\u003eString, Array\u003c/td\u003e\n    \u003ctd\u003eNo\u003c/td\u003e\n    \u003ctd\u003eResources to include\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\nDepending upon the framework you wish to use example templates can be found in:\n\n`node_modules/grunt-styleguide/templates/\u003cframwork.name\u003e/templates`\n\nA generic template is provide also:\n\n`node_modules/grunt-styleguide/templates/generic`\n\nCopy these to a location which is part of your project and modify your gruntfile to support your individual requirements.\n\n\n#### CSS Preprocessors\n\nBy default **grunt-styleguide** will determine the CSS preprocessor to use by evaluating the selected source files. This value will be passed as an option to framework and if supported will be used by it.\n\n### Usage Examples\n\n#### Default Options\nIn this example a styleguide will be generated using the default generator, `styledocco`. Guides will be created for css/scss located within the **core** and **plugins** directory and output them to the appropriate destination specified.\n\n```\ngrunt.initConfig({\n\n  styleguide: {\n\n  \tdist: {\n\n\t    files: {\n\t      'docs/core': 'stylesheets/sass/core/*.scss',\n\t      'docs/plugins': 'stylesheets/sass/plugins/*.scss'\n\t    }\n\n  \t}\n\n  }\n\n});\n```\n\n## Contributing\nIn lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using [grunt][].\n\n## Release History\n\n- 0.2.17\n\n  - Fix KssStateGenerator ( @stickel )\n\n- 0.2.16\n\n  - Remove direct dependency upon grunt-lib-contrib\n  - Readme fix ( @firehist )\n  - Readme fix ( @ryanmargheriti )\n  - Readme fix ( @andrew-luhring )\n\n- 0.2.15\n\n\t- Dependencies updates ( @shinnn )\n\t- Move helper out of tasks directory to avoid \"No tasks were registered or unregistered.\" warning ( @princed )\n\t- Config example error fixes ( @levito  )\n\n- 0.2.14\n\n    - Lock version of styledocco ( @jreading )\n\n- 0.2.13\n\n    - Relativize absolute paths\n    - Rewrite findBasePath function ( @mikedingjan )\n    - Update Grunt getting started docs url ( @iamblue )\n    - It's Sass, not SASS ( @kaelig )\n\n- 0.2.12\n\n    - Cleanup release history\n    - Use inherited version of LESS ( @pokornyr )\n    - Small documentation typo ( @simonwjackson )\n\n- 0.2.11 | Updated styledocco dependency (#16)\n- 0.2.10 | KSS fix (#15)\n- 0.2.9  | Simplify styledocco plugin\n\n- 0.2.8\n\n    - Updated styledocco dependencies\n    - Added Stylus\n\n- 0.2.7 | Cumulative fixes (Issues #18, #14, #11) [ sorry for the delay ]\n- 0.2.6 | Minor code tweaks to resolve some user issues\n- 0.2.5 | Node.js ~0.10.0 compatibility\n- 0.2.4 | Pass local less path to styledocco\n- 0.2.3 | Styleguide nolonger uses custom node-kss fork (includes nolonger supported for KSS beware)\n- 0.2.2 | Grunt 0.4.0 support (~0.3.0 no longer supported)\n- 0.2.1 | Minor bug fix\n\n- 0.2.0\n\n    - Revised documentation\n    - Revised options structure\n    - Introduced template options\n    - Introduced node-kss\n\n- 0.1.1\n\n    - Travis support\n    - Grunt compatibility tweaks\n\n- 0.1.0 | Initial Release\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Findieisaconcept%2Fgrunt-styleguide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Findieisaconcept%2Fgrunt-styleguide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Findieisaconcept%2Fgrunt-styleguide/lists"}