IPS WikiSpeech 
--------------

WikiSpeech is a web-application for speech recording over the internet.

The web-application is written in Java to run on a Tomcat server.
The HTML5 Angular speech recording client is included by Maven build.

Licensing:
----------

WikiSpech server: GNU LESSER GENERAL PUBLIC LICENSE Version 3
WikiSpeech SpeechRecorder browser client: MIT (https://opensource.org/licenses/MIT)

The license file and a third-party license list will be generated with Maven command 'mvn package'.
The files will be located in target/generated-sources/license/ .

Build:
------

- Download and install Maven (or use Eclipse)
- Create a local save directory to store configuration data. In this manual referenced with [wikiSpeechConfigDir].
- Create Maven settings.xml file
For example in your home directory ~/.m2/settings.xml :

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
        https://maven.apache.org/xsd/settings-1.0.0.xsd">
 <profiles>
  <profile>
   <id>wikispeech</id>
   <activation>
     <activeByDefault>true</activeByDefault>
   </activation>
   <properties>
    <settings.wikiSpeechConfigDir>/homes/klaus.jaensch/TEST/WikiSpeech/config</settings.wikiSpeechConfigDir>
   </properties>
  </profile>
 </profiles>
</settings>


- Create config file for productive build target [wikiSpeechConfigDir]/wikispeech.properties .

Replace this tokens with your own in the following example config file:
[wikiSpeechDataDir]: Directory for data, mainly the speech recordings
[postgresDbServerHost]: Hostname of the PostgreSQL database server
[wikispeechDbPassword]: The password to the Postgres wikispeech database

wikispeech.properties
-------------------------------------------------------------------------

# Context path
# (application URL is http(s)://hostname/wikispeech.context.path 
wikispeech.context.path=/wikispeech

# JPA DDL generation
# WARNING! drop-and-create deletes database contents
#speechdb.ddl.generation=none
#speechdb.ddl.generation=create-tables
speechdb.ddl.generation=create-or-extend-tables

# Log level 
speechdb.log.level=INFO

# Project name
projectname=wikispeech

# Host name
hostname=webapp.phonetik.uni-muenchen.de
server.scheme=https
server.hostname=webapp.phonetik.uni-muenchen.de
server.port=443

# Base directory
wikispeech.filespace.base.dir=[wikiSpeechDataDir]
# Upload directory
wikispeech.recs.dir=[wikiSpeechDataDir]

# Debug mode
debug=false

# Speech DB connection config
speechdb.url=jdbc:postgresql://[postgresDbServerHost]/wikispeech?ssl=true
speechdb.username=wikispeech
speechdb.password=[wikispeechDbPassword]

# Web transport guarantee (NONE: HTTP or CONFIDENTIAL:HTTPS)
wikispeech.transport-guarantee=CONFIDENTIAL

------------------------------------------------------------------------------


- Run "mvn -P WikiSpeech-Productive clean package"

The command should build the WAR file target/wikispeech.war for deployment on the Tomcat server.

- Deploy wikispeech.war to Tomcat server

- Call URL http(s)://[tomcatHostname]/wikispeech in your browser.




