[Geoserver-devel] Willing to write some docs, but where?

GeoServer GeoServer Developer
,
1

Hi,

It took me considerable time to find out how 'paramatrized'-svg icons work. Best resource is actually a blog post:

http://blog.geoserver.org/2016/10/31/geoserver-2-10-0-released/
(the part about Improved QGIS style compatibility)

But it lacked some info about for example what to do when you want several params to be used etc.

I want to put this info to in the Styling docs of Geoserver. So my question: what would be the best place to put this.

I was thinking about:

SLD points part:
https://docs.geoserver.org/latest/en/user/styling/sld/cookbook/points.html

A paragraph in the QGIS-export:
https://docs.geoserver.org/latest/en/user/styling/qgis/index.html#exporting-vector-symbology

In the workbook:
https://docs.geoserver.org/latest/en/user/styling/workshop/css/point.html

Or just propose someghing else

I only used sld... not sure if this is also possible in other styling languages Geoserver does: CSS, YSLD MBSTYLE?
IS it possible? Should I try and add that also?

Regards,

Richard Duivenvoorde

2

I would think that the cookbook or the PointSymbolizer / ExternalGraphic docs at https://docs.geoserver.org/latest/en/user/styling/sld/reference/pointsymbolizer.html#externalgraphic is a good place.
Or perhaps https://docs.geoserver.org/latest/en/user/styling/sld/extensions/pointsymbols.html#external-graphics
so many options…

  • M
···

Disclaimer;
This message is just a reflection of what I thought at the time of sending. The message may contain information that is not intended for you or that you don’t understand.

3

Thanks for digging into this!

The functionality is an “extension” to GeoServer SLD (specific to GeoServer) so it should be documented here: https://docs.geoserver.org/latest/en/user/styling/sld/extensions/pointsymbols.html

It would also be great to include it in the workbook.

  • The functionality should be accessible in YLD (which is a direct mirror of SLD just in plain text yet-another-markup-language).
  • I am not sure about CSS but I expect so
  • MBStyle only uses sprites (not SVG) so it will have to miss out.
···

–
Jody Garnett

4

Thanks Jody,

On 8/14/20 6:47 PM, Jody Garnett wrote:

Thanks for digging into this!

The functionality is an "extension" to GeoServer SLD (specific to GeoServer) so it should be documented here: https://docs.geoserver.org/latest/en/user/styling/sld/extensions/pointsymbols.html

See: https://github.com/geoserver/geoserver/pull/4453

It would also be great to include it in the workbook.
- The functionality should be accessible in YLD (which is a direct mirror of SLD just in plain text yet-another-markup-language).
- I am not sure about CSS but I expect so
- MBStyle only uses sprites (not SVG) so it will have to miss out.

I'm no so familiar with CSS and YLD in Geoserver, sorry.

Regards,

Richard

5

Thanks for the PR!

As for YSLD, if you wish to become familiar try out rest api endpoint to convert between SLD and YSLD and back again.

···

–
Jody Garnett