The EMU-webApp is an online and offline web application for labeling, visualizing and correcting speech and derived speech data.
JavaScript HTML CSS Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.idea
app
dist
docs/develDocs
exampleServers
scripts
test
validators
.bowerrc
.coveralls.yml
.gitignore
.jscsrc
.jshintrc
.travis.yml
.yo-rc.json
Gruntfile.js
LICENSE
README.md
bower.json
karma-e2e.conf.js
package-lock.json
package.json
protractor.conf.js

README.md

EMU-webApp

Build Status Coverage Status

The EMU-webApp is an online and offline web application for labeling, visualizing and correcting speech and derived speech data. To get an idea of what it looks like please visit this URL. General information about the next iteration of the EMU speech database management system can be found here.

Quick start

Visit this URL and click the open demo DB button in the top menu to load one of the three small example databases.

Tools for development

  • install nodejs and npm
  • install bower with npm install -g bower
  • install grunt with npm install -g grunt
  • install compass and sass with gem install sass and gem install compass
  • clone this repo with git clone https://github.com/IPS-LMU/EMU-webApp.git
  • navigate to the freshly cloned repo (the folder is usually named EMU-webApp) and install dependencies with the commands bower install and npm install
  • run static file server at http://localhost:9000 with grunt serve
  • for livereload use the livereload browser plugin
  • a small websocket data provider server can be found under exampleServers/nodeEmuProtocolWsServer.js

If grunt serve is not working make sure to install the latest dependencies by

  • updating bower by rerunning bower install
  • updating npm by rerunning npm install
  • updating sass and compass by running gem update sass and gem update compass

Tests

  • unit tests: run grunt test
  • end-to-end tests using protractor: run grunt e2e

Create and deploy new release

These are the steps necessary to create and deploy a new release on https://ips-lmu.github.io/EMU-webApp/ (push privileges to GitHub repo required)

  • prerequisite: make sure all unit tests and end-to-end test pass (grunt test and grunt e2e)
  • prerequisite: also run end-to-end tests on dist build (grunt serve:dist followed by grunt e2e) & manually inspect the release version (just in case)
  • update version numbers in NEWS.md, package.json, bower.json
  • update NEWS.md to reflect changes (== changelog)
  • grunt serve:dist also runs grunt's build task so explicitly calling grunt build is unnecessary
  • this will have created a new release in the dist folder in the root directory of this repo
  • change <base href="/"> entry in dist/index.html to <base href="/EMU-webApp/">
  • push changes made to repo by build process to GitHub: git push origin master
  • deploy the dist directory by running the subtree push command: git subtree push --prefix dist origin gh-pages from the root directory of this repo (see http://yeoman.io/learning/deployment.html for further details)
  • create new release on GitHub

Main authors

Raphael Winkelmann

Georg Raess

Markus Jochim

Affiliations

INSTITUTE OF PHONETICS AND SPEECH PROCESSING