wisemapping-open-source/README.md

3.1 KiB

Project Information

The goal of this project is to provide a high quality product that can be deployed by educational and academic institutions, private and public companies and anyone who needs to have a mindmapping application. WiseMapping is based on the same code source supporting WiseMapping.com. More info: www.wisemapping.org

Compiling and Running

Prerequisites

The following products must be installed:

* Java 11 to 16 
* Maven 3.x or higher ([http://maven.apache.org/])

Compiling

WiseMapping uses Maven as packaging and project management. It's composed of 5 maven sub-modules:

* wise-react: React font-end fetcher
* wise-webapp: J2EE web application 

The full compilation of the project can be performed executing within :

export MAVEN_OPTS="--illegal-access=permit" mvn clean install

Once this command is executed, the file /wise-webapp/target/wisemapping*.war will be generated.

Local Development

The previously generated war can be deployed locally executing within the directory /wise-webapp the following command:

cd wise-webapp;mvn jetty:run-war

This will start the application on the URL: [http://localhost:8080/] using file based database.

User: test@wisemapping.org Password: test

Local Development - UI Integration

In order to reduce the life-cycle to develop UI backend testing, you can do the following hack:

Compiling and running with docker-compose

Check out the docker section

Running the JS only version

Start by creating the .zip file.

mvn assembly:assembly -Dmaven.test.skip=true

To test the javascript frontend, install a simple http-server.

npm install -g http-server

Now open a browser using the URL http://localhost:8080/wise-editor/src/main/webapp/

Troubleshooting

mvn package fails with the error java.lang.UnsatisfiedLinkError: Can't load library: /usr/lib/jvm/java-11-openjdk-amd64/lib/libawt_xawt.so in Ubuntu
Make sure you have the jdk installed: `sudo apt-get install openjdk-11-jdk`
mvn package does not generate the wisemapping.war file
Run `mvn clean install -DskipTests`

Maintenance

Members

Founders

Individual Contributors

Past Individual Contributors

License

The source code is Licensed under the WiseMapping Open License, Version 1.0 (the “License”); You may obtain a copy of the License at: [https://wisemapping.atlassian.net/wiki/display/WS/License]