https://github.com/geostyler/geostyler-geoserver-plugin
GeoStyler UI for the GeoServer
https://github.com/geostyler/geostyler-geoserver-plugin
geoserver geostyler react sld
Last synced: 2 months ago
JSON representation
GeoStyler UI for the GeoServer
- Host: GitHub
- URL: https://github.com/geostyler/geostyler-geoserver-plugin
- Owner: geostyler
- License: gpl-2.0
- Created: 2022-06-07T17:09:39.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-12-09T14:23:22.000Z (11 months ago)
- Last Synced: 2024-12-09T15:28:40.968Z (11 months ago)
- Topics: geoserver, geostyler, react, sld
- Language: Java
- Homepage:
- Size: 2.28 MB
- Stars: 9
- Watchers: 13
- Forks: 5
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# GeoStyler GeoServer extension
This extension integrates the GeoStyler UI into the GeoServer styles tab.
## Installation 🥳
To install the extension to your GeoServer just proceed as follows:
1. Download the **matching jar** from [this Nexus repository](https://nexus.terrestris.de/#browse/browse:geoserver-extras:org%2Fgeoserver%2Fcommunity%2Fgs-geostyler).
2. Copy the jar into the `WEB-INF/lib` directory of your GeoServer installation.
3. Restart GeoServer
How to find the matching jar? [click to show/hide]
- The link will lead you to the list of all published artefacts of the plugin, organized in a directory
structure - below
org/geoserver/community/gs-geostyleryou will find packages for several versions of GeoStyler, e.g.1.2.0,1.2.1or1.2.2
- Choose the highest version, e.g.
1.2.2, and click on the version. A subfolder will be shown - You will need to download a version that is compatible to your GeoServer version, e.g.
2.22.2 - The jars are named according to the following scheme:
gs-geostyler-[[GeoStyler-version]]-[[GeoServer-version]].jar - So for the example versions above, the matching jar would be
gs-geostyler-1.2.2-2.22.2.jar, since
the needed[[GeoStyler-version]]is1.2.2and the target[[GeoServer-version]]is2.22.2
## Development 🏗️
Basically the plugin just includes the JavaScript resources of the GeoStyler into
a Wicket page which in turn will be rendered by the GeoServer. The lib files aren't
part of the repository and need to be packed into the plugin during build. To build
the plugin (including the JS sources), just execute:
```
mvn clean package
```
This will create a `gs-geostyler--.jar` file inside the `target` directory
which can be copied to the GeoServer's lib directory. For testing purposes this
repository contains a dockerized GeoServer:
1. Copy the freshly created jar into the lib directory:
```
cp ./target/gs-geostyler-.jar ./docker/geoserver/additional_libs
```
2. Run GeoServer:
```
cd docker
docker compose up --build --force-recreate --remove-orphans
```
## Release 📰
Uses the [@terrestris/maven-semantic-release](https://github.com/terrestris/maven-semantic-release) plugin to create new releases automatically.
## Funding & financial sponsorship
Maintenance and further development of this code can be funded through the
[GeoStyler Open Collective](https://opencollective.com/geostyler). All contributions and
expenses can transparently be reviewed by anyone; you see what we use the donated money for.
Thank you for any financial support you give the GeoStyler project 💞