Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/happyplan/happyplan
UNMAINTAINED. I can only recommend you to checkout this brand new static website generator https://phenomic.io
https://github.com/happyplan/happyplan
Last synced: 3 months ago
JSON representation
UNMAINTAINED. I can only recommend you to checkout this brand new static website generator https://phenomic.io
- Host: GitHub
- URL: https://github.com/happyplan/happyplan
- Owner: happyplan
- License: mit
- Archived: true
- Created: 2013-01-23T21:11:31.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2016-03-06T07:48:20.000Z (almost 9 years ago)
- Last Synced: 2024-06-22T22:02:36.823Z (6 months ago)
- Language: JavaScript
- Homepage:
- Size: 1.52 MB
- Stars: 80
- Watchers: 3
- Forks: 10
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# UNMAINTAINED
**I can only recommend you to checkout this brand new static website generator which is far more flexible than this one.**
➡ https://github.com/MoOx/statinamic
---
# HappyPlan!
[](http://badge.fury.io/js/happyplan)
[](https://travis-ci.org/happyplan/happyplan)
> A fantastic preconfigured static website generator
HappyPlan is a static website generator based on a bundle of amazing tools.
It's just all about fun.
### What in it ?
* A task-based command line build tool: [Grunt.js](http://gruntjs.com/) & all pre-defined tasks you'll need (scripts, styles & images automatic minification & compression).
* A static website generator from html or markdown: [assemble](http://assemble.io/).
* An amazing CSS pre-processor, [Sass](http://sass-lang.com/) (via [libsass](https://github.com/hcatlin/libsass)).
* [Autoprefixer](https://github.com/ai/autoprefixer) to automatically add CSS vendor prefix to your CSS, using to [caniuse.com](http://caniuse.com/) database.
* A quick way to provide scalable icons as font thanks an awesome Grunt task [grunt-webfont](https://github.com/sapegin/grunt-webfont).
* A [Livereload](http://livereload.com/) server provided by the [grunt-contrib-watch](https://github.com/gruntjs/grunt-contrib-watch) task to make development as fast as hell.
* Support the [Bower](http://bower.io/) package manager to handle web components.
_Notice: you can change/override/add stuff very easily, thanks to grunt. [More about that in the documentation](https://github.com/happyplan/happyplan/blob/master/docs/2-Configuring-Project.md)_
Oh, by the way, why "happy plan" ? [Here is not the answer](http://www.youtube.com/watch?v=5zVVKXT8Vi0).
## Documentation
Visit the [documentation](docs) for all the things.
## TL;DR
### Requirements
According you already have Node & NPM installed you can run this commands:
```console
$ npm install -g grunt-cli happyplan-cli bower
```
[Learn more about requirements](docs/0-Requirements.md).
### Create a project using happyplan
```console
$ npm init
$ npm install happyplan --save-dev
$ happyplan
```
## Contributing
When you want to fix a bug or add a feature, just be sure to get all testing requirements installed, & run tests before making your *Pull Request*.
You can run in one command the build process & the tests.
```console
$ npm install
$ npm test
```
In case you don't know it yet, `npm {cmd}` just run the command `{cmd}` specified in the `package.json` `script` section. In our case, it run `grunt test`. And to be precise, the `test` task run the `nodeunit` one.
### Tests some features
Features are tested using a simple build & a diff.
Checkout test/features/* to find existing tested features.
By default all features are tested, but you can run just some of them using the `features` option.
```console
$ grunt test -features=feature1,feature2
```
---
## [CHANGELOG](CHANGELOG.md)
## [LICENSE](LICENSE.md)
---
## Credits
- [Catherine Please](http://www.catherineplease.com/) for the logo.