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/
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
On a Alpine Linux edge system the build environment can be prepared this way:
apk add ruby texlive make librsvg hugo texmf-dist-fontsextra poppler-utils
wget https://github.com/jgm/pandoc/releases/download/2.18/pandoc-2.18-linux-amd64.tar.gz
cp pandoc-2.18/bin/pandoc /usr/local/bin/
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
.
License
The text, all markdown sources and PDF artifacts of the Open-Data-Leitfaden Schleswig-Holstien 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.