Generate a PDF and online documentation for the schemas on CI run

This was decided in a CCT1 meeting on 02.09.2022.

It should be fairly simple to do:

possible ways:

1. https://github.com/adobe/jsonschema2md (schemas -> md -> pdf) the md can be displayed directly on gitlab pages/docs page for this repo, or on a website/information portal or where ever. For the MD to pdf one could use the HMC workflow from data commons which exists.

2. https://github.com/bootprint/bootprint-json-schema (schemas -> html), there one could use a custom css style cheat or what ever. the html result can then be exported to x (pdf and co) through a usual static side generator (example sphinx or jekyl)

This should be done with each CI run on each change, to check this this is properly build. The PDF, html, md can then be downloaded as a pipeline artifact.

assigned to @markus.kubin

changed the description

@markus.kubin since you wanted to make this a student project, this repo has to be moved into a public space prior that. Or can they get access to this repo otherwise?

Also the chapter introductions and comments which probably will still be edited in markdown need to be woven dynamically into the final document, right?

assigned to @markus-kubin and unassigned @markus.kubin

added Backlog label

added CCT1 label

would close https://codebase.helmholtz.cloud/hmc/hmc/cct-1-mapping/schema-specification-document/-/issues/4 and eventually also make the legacy schema specefication pipeline obsolete prop.