Browse Source

Update README.md

Former-commit-id: 5c2d5f7f0f
Former-commit-id: 31995f07f6
pull/258/head
Jack Lukic 11 years ago
parent
commit
0d0afcb31a
1 changed files with 2 additions and 54 deletions
  1. 56
      node/README.md

56
node/README.md

@ -1,55 +1,3 @@
# [HTML5 Boilerplate](http://html5boilerplate.com/) skeleton for [DocPad](https://github.com/bevry/docpad)
Bare essentials for building a modern website with best practices
# Semantic Docs
## Why the fork?
This fork adds [Grunt](http://gruntjs.com/) to show an example of taking the HTMLBP and minifying and concatenating all the JS and CSS assets into single files and including those in the layout.
## What is different?
### `grunt-config.json`
- This file is contains the object passed to `grunt.initConfig` in `grunt.js`. It has been put into its own file since it is used in `docpad.coffee` to build file lists for inclusion in the layout and deleting unused files.
### `grunt.js`
- This is the Grunt file. It runs `initConfig` with the `grunt-config.json` object. It also registers a `default` task with all the keys from the config file.
### `docpad.coffee`
- I added the helper functions [`getGruntedStyles`]() and [`getGruntedScripts`](). These functions will return all the compiled assets that contain `.min.(css|js)` with the correct base path.
- A [`writeAfter`]() DocPad event. It is based on [this gist](https://gist.github.com/3898915), with some additional functionality. It will run the `default` grunt command. Then it will use your `grunt-config.json` to delete the `src` files since they are no longer needed. It will also delete any empty directories in the 'out/' directory.
### `layouts/default.html.eco`
- The script and style blocks have been replaced with calls to the helper functions described above.
## Getting Started
1. [Install DocPad](https://github.com/bevry/docpad)
1. Clone the project and run the server
``` bash
git clone git://github.com/lukekarrys/html5-boilerplate.docpad.git
cd html5-boilerplate.docpad
npm install
docpad run
```
1. [Open http://localhost:9778/](http://localhost:9778/)
1. Start hacking away by modifying the `src` directory
## License
This skeleton is made ["public domain"](http://en.wikipedia.org/wiki/Public_domain) using the [Creative Commons Zero](http://creativecommons.org/publicdomain/zero/1.0/), as such before you publish your website you should place your desired license here and within the `LICENSE.md` file.
If you are wanting to open-source your website, we suggest using the [Creative Commons Attribution License](http://creativecommons.org/licenses/by/3.0/) for content and the [MIT License](http://creativecommons.org/licenses/MIT/) for code. In which case you'd probably want to use the following as your license:
Unless stated otherwise, all content is licensed under the [Creative Commons Attribution License](http://creativecommons.org/licenses/by/3.0/) and code licensed under the [MIT License](http://creativecommons.org/licenses/MIT/), © [Your Name](http://your.website)
If you are wanting to close-source your website, we'd suggest using the following:
Copyright [Your Name](http://your.website). All rights reserved.
Other included things such as themes and libraries are likely already licensed by their own invidual licenses, so be sure to respect their licenses too.
Thanks, the DocPad team loves you.
This node project uses docpad to generate the static documentation files for Semantic UI.
Loading…
Cancel
Save