Please don't edit files in the dist
subdirectory as they are generated via Grunt. You'll find source code in the src
subdirectory! Not currently using unit tests as PhantomJS doesn't have SpeechSynthesis so there isn't much to test.
Regarding code style like indentation and whitespace, follow the conventions you see used in the source already.
PhantomJS
doesn't support window.speechSynthesis
, so there isn't much automation to do regarding testing speakable.jquery.js
. Tests are in tests/**/*.html
. For example speak.html
has a list of headers that can be clicked to be tested. Each should read the correct transcript aloud.
First, ensure that you have the latest Node.js and npm installed.
Test that Grunt's CLI is installed by running grunt --version
. If the command isn't found, run npm install -g grunt-cli
. For more information about installing Grunt, see the getting started guide.
- Fork and clone the repo.
- Run
npm install
to install all dependencies (including Grunt). - Run
grunt build && grunt
to grunt this project. - Run
grunt watch
to watch for changes.
Assuming that you don't see any red, you're ready to go. Just be sure to run grunt
after making any changes, to ensure that nothing is broken.
- Create a new branch, please don't work in your
master
branch directly. - Update the documentation to reflect any changes.
- Push to your fork and submit a pull request.