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

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

The community mailing list is a place where users can share experiences, it is not a professional support mailing list. For professional support, users should sign a support contract with a professional services company, and use their appropriate channel.

Prerequisites

Building mapfish-print requires make and Docker.

Build

Execute the following command():

> make 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: https://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 test (part of the build) requires the 'Liberation Sans' font, which can be downloaded here.

Create new stabilisation branch

Create a new branch name x.y from master.
Create a new label names 'backport x.y'.
On the master branch update the .github/workflows/rebuild.yaml file by adding the new branch name.
On the master branch update the .github/workflows/audit.yaml file by adding the new branch name.

Run from commandline

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/src/test/resources/examples/simple/config.yaml -spec ../examples/src/test/resources/examples/simple/requestData.json -output ./output.pdf"

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

> ./gradlew print --debug-jvm -PprintArgs="-config ../examples/src/test/resources/examples/simple/config.yaml -spec ../examples/src/test/resources/examples/simple/requestData.json -output ./output.pdf"

To use in Eclipse

Create Eclipse project metadata:

> ./gradlew eclipse

Import project into Eclipse

Run in Eclipse

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

Contributor License Agreement

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.

Credits

target

: https://www.yourkit.com/java/profiler/index.jsp

Thanks to YourKit for letting us use their Java profiler!

Published artifacts

Docker

War and jar from version 3.23

War and jar before version 3.23

seabilwe/mapfish-print