regexper-static/README.md

39 lines
1.6 KiB
Markdown
Raw Normal View History

2014-11-23 16:41:53 +00:00
# Regexper
2014-11-24 00:05:39 +00:00
Code for the http://regexper.com/ site.
2014-11-23 16:41:53 +00:00
## Contributing
I greatly appreciate any contributions that you may have for the site. Feel free to fork the project and work on any of the reported issues, or let me know about any improvements you think would be beneficial.
When sending pull requests, please keep them focused on a single issue. I would rather deal with a dozen pull requests for a dozen issues with one change each over one pull request fixing a dozen issues. Also, I appreciate tests to be included with feature development, but for minor changes I will probably not put up much of a fuss if they're missing.
### Working with the code
2014-11-24 00:04:47 +00:00
Node and Ruby are required for working with this site. It is recommended to use rbenv or rvm to manage your Ruby installation, and configuration files are included to set the Ruby version and gemset.
To start with, install the necessary dependencies for Node and Ruby:
$ bundle install
$ npm install
There are several gulp tasks available to build various parts of the site, but to get started you only need:
$ gulp
This will build the site into the ./build directory, start a local start on port 8080, and begin watching the source files for modifications. The site will automatically be rebuilt when files are changed. Also, if you browser has the LiveReload extension, then the page will be reloaded.
To automatically run Karma test, run the following:
$ gulp karma
2014-11-24 00:04:47 +00:00
2014-11-25 02:46:51 +00:00
To build the site for deployment, run the following:
2014-11-24 00:04:47 +00:00
2014-11-25 02:46:51 +00:00
$ gulp build
2014-11-24 00:04:47 +00:00
2014-11-25 02:46:51 +00:00
The site will be built into the "build" directory.
2014-11-23 16:41:53 +00:00
## License
2014-11-25 02:47:23 +00:00
See LICENSE.txt file for licensing details.