Merge remote-tracking branch 'tutorial/main'

Author: N-Coder

docs/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+.cache/
+.venv/
+archive/
+.ipynb_checkpoints/
+tutorial.pdf
+tutorial.zip
+*.ipynb
+*.gml
+*.svg
+tutorial/dfs_step.h
+examples/more

docs/build-ogdf.sh

@@ -0,0 +1,39 @@
+git clone https://github.com/ogdf/ogdf.git ogdf
+cd ogdf
+git checkout foxglove-202510 # latest release
+mkdir build-debug build-release
+
+# this already sets most confinguration options to sensible values for ease of development
+# alternatively, change them via `ccmake .`
+cmake -B build-debug -S . \
+  -DBUILD_SHARED_LIBS=ON -DCMAKE_BUILD_TYPE=Debug \
+  -DOGDF_MEMORY_MANAGER=POOL_NTS -DOGDF_SEPARATE_TESTS=ON \
+  -DOGDF_USE_ASSERT_EXCEPTIONS=ON \
+  -DOGDF_USE_ASSERT_EXCEPTIONS_WITH_STACK_TRACE=ON_LIBUNWIND
+# if libunwind is not found, install it first or remove the last flag
+# https://pkgs.org/search/?q=libunwind-dev
+cmake --build build-debug --parallel
+
+# the performance-oriented version of the above configuration
+cmake -B build-release -S . \
+  -DBUILD_SHARED_LIBS=OFF -DCMAKE_BUILD_TYPE=RelWithDebInfo \
+  -DOGDF_MEMORY_MANAGER=POOL_NTS -DOGDF_USE_ASSERT_EXCEPTIONS=OFF \
+  -DCMAKE_INTERPROCEDURAL_OPTIMIZATION=TRUE -DCMAKE_POLICY_DEFAULT_CMP0069=NEW
+cmake --build build-release --parallel
+
+cd ..
+mkdir example-project
+# copy the example project
+cp -r ogdf/doc/examples/special/* example-project/
+cd example-project/
+mkdir build-debug build-release
+
+# we need to tell cmake the absolute path where our matching ogdf build is located via OGDF_DIR
+cmake -B build-debug -S . \
+  -DCMAKE_BUILD_TYPE=Debug -DOGDF_DIR=$(realpath ../../ogdf/build-debug)
+cmake --build build-debug --parallel
+
+cmake -B build-release -S . \
+  -DCMAKE_BUILD_TYPE=RelWithDebInfo -DOGDF_DIR=$(realpath ../../ogdf/build-release) \
+  -DCMAKE_INTERPROCEDURAL_OPTIMIZATION=TRUE -DCMAKE_POLICY_DEFAULT_CMP0069=NEW
+cmake --build build-release --parallel

docs/build-tutorial-zip.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+
+set -e
+
+if ! command -v jupytext &> /dev/null; then
+    echo "Error: jupytext not found." >&2
+    exit 1
+fi
+
+rm -f tutorial.zip
+latexmk tutorial
+
+for f in {examples,exercises,tutorial}/*.py; do
+	jupytext -o "${f%.*}.ipynb" "$f"
+done
+
+zip -r tutorial.zip data examples/*.ipynb exercises/*.ipynb tutorial/*.ipynb tutorial/img build-ogdf.sh tutorial.pdf
+
+rm -f {examples,exercises,tutorial}/*.ipynb