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

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

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.

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

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

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