Skip to content

mapfish/mapfish-print

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

3af5a71 · Mar 1, 2023
Feb 28, 2023
Feb 1, 2023
Feb 28, 2023
Feb 1, 2023
Dec 19, 2022
Mar 1, 2023
Jul 13, 2021
Oct 24, 2022
Nov 6, 2020
Dec 4, 2022
Jun 22, 2020
Sep 8, 2022
Oct 25, 2021
Oct 24, 2022
Sep 28, 2020
Dec 4, 2022
Feb 24, 2023
Oct 22, 2022
Mar 17, 2016
Dec 19, 2022
Oct 31, 2022
Feb 27, 2023
Mar 1, 2023
Feb 23, 2023
May 5, 2017
Jan 28, 2021
Dec 23, 2020
Oct 24, 2022
Oct 22, 2022
May 5, 2017
May 5, 2017
Mar 31, 2022
Oct 24, 2022
Nov 13, 2020
Mar 6, 2019
Sep 23, 2022

Repository files navigation

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

Camptocamp is providing professional assistance services, open source software maintenance and new feature development for MapFish Print. Please reach us if you have any inquiry, we'd be glad to help. Every income helps float this project.

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.

Auto-reload mode

To be able to quickly test modifications in the print you should:

  • Copy the file docker-compose.override.sample.yaml to docker-compose.override.yaml.
  • Run docker compose up -d, The print will be available on port 8080 and on code modification will be built and trigger a restart.

Create new stabilisation branch

  • Update CHANGELOG.md
  • Create a new branch name x.y from master.
  • Create a new label names backport x.y in the right color (GitHub: Issues->Labels->New Label).
  • Create a tag x.y.0.
  • On the master branch: Update the SECURITY.md file, add a policy for the new and old version.
  • 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 command line

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

To list all the command line options then execute (the current directory 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"

For the examples that use GeoServer you should run it in the composition, then build and start the composition:

make build
cp docker-compose.override.sample.yaml docker-compose.override.yaml
make acceptance-tests-up

Run the example:

docker-compose exec builder gradle print -PprintArgs="-config /src/examples/src/test/resources/examples/simple/config.yaml -spec /src/examples/src/test/resources/examples/simple/requestData.json -output /src/examples/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

image

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

Releases, including various assets