Please read the documentation available here: http://mapfish.github.io/mapfish-print/

For support or questions post on the mailing list: https://groups.google.com/forum/#!forum/mapfish-print-users

Execute the following command():

> ./gradlew build

This will build three artifacts: print-servlet-xxx.war, print-lib.jar, print-standalone.jar

The build also builds the documentation in the docs/build/site folder. To deploy the documentation it should simply be copied to the gh-pages branch and then committed GitHub will automatically build the updated site at: http://mapfish.github.io/mapfish-print/

If you only want to build the docs simply run

> ./gradlew docs:build

or run build in the docs directory

The following command will build and upload all artifacts to the maven central repository.

> ./gradlew uploadArchives -DsshPassphrase=...

You can as well generate a docker image using this command:

> ./gradlew createDocker

If you want to force the version to something custom, you can define the DOCKER_VERSION environment variable.

Create Eclipse project metadata:

> ./gradlew eclipse

Import project into Eclipse

The following command will run the mapfish printer. The arguments must be supplied to the -PprintArgs="..." parameter.

To list all the commandline options then execute (the current direstory is ./core):

> ./gradlew print -PprintArgs="-help"

> ./gradlew print -PprintArgs="-config ../examples/config.yaml -spec ../examples/spec.json -output ./output.pdf"

If you want to run in debug mode you can do the following:

The following command will run mapfish print using gretty/jetty. The default port is 8080, but can be changed using -PhttpPort="..." parameter.

> ./gradlew jettyRun -PhttpPort=8090

• Create new Java Run Configuration
• Main class is org.mapfish.print.cli.Main
• Program arguments: -config samples/config.yaml -spec samples/spec.json -output $HOME/print.pdf

Before accepting a contribution, we ask that you provide us a Contributor License Agreement. If you are making your contribution as part of work for your employer, please follow the guidelines on submitting a Corporate Contributor License Agreement. If you are making your contribution as an individual, you can submit a digital Individual Contributor License Agreement.

Thanks to YourKit for letting us use their Java profiler!