Open-Data-Leitfaden Schleswig-Holstein

This is the source for the "Open-Data-Leitfaden Schleswig-Holstein". From the source, different targets can be generated. See the Makefile for details. The workflow is based on the procedure used for the Berliner Open-Data-Handbuch.

The following versions exist:

• A PDF document generated directly from the source via pandoc (and additional processing - see Makefile for details).
• An HTML version generated directly from the source via the static website generator Hugo - available online here: https://opendata.zitsh.de/leitfaden/

The main content file is leitfaden-opendata.md.

Building

You need a few prerequisites to build the Open-Data-Leitfaden Schleswig-Holstein.

On a Ubuntu 20.04 LTS system the following packages have to be installed:

sudo apt install make librsvg2-bin poppler-utils pandoc pdflatex hugo texlive-latex-recommended texlive-lang-german

On a Alpine Linux 3.18.4 system the build environment can be prepared this way:

apk add ruby texlive make librsvg hugo font-liberation poppler-utils rsvg-convert pandoc texmf-dist-latexrecommended texmf-dist-fontsrecommended texmf-dist-langgerman

You can create the PDF document:

git clone https://code.schleswig-holstein.de/opendata/leitfaden.git
cd leitfaden
make pdf

The resulting PDF document will be placed at public/leitfaden-opendata.pdf.

To generate the HTML version:

git clone https://code.schleswig-holstein.de/opendata/leitfaden.git
cd leitfaden
make web

The resulting HTML files can be found in the public/ directory.

You can also run Hugo in live mode and serve the content at http://localhost:1313/leitfaden/ by using the command make serve-web.

Commons errors

File template/listings-setup.tex not found in resource path

License

The text, all markdown sources and PDF artifacts of the Open-Data-Leitfaden Schleswig-Holstein are published under Creative Commons Namensnennung 4.0 International Lizenz (CC BY 4.0).

For the licenses to the images contained in the Open-Data-Leitfaden Schleswig-Holstein, please refer to the Bildverzeichnis.

All code, including the Makefile and the source code in /bin is published under the MIT License.