Added course's notes
This commit is contained in:
1 parent
e07993262c
commit
dcd2c072ae
191 files changed
+42866
-12
No files matched your search
Executable
+85
@@ -0,0 +1,85 @@
|
||||
#!/usr/bin/env bash
|
||||
# handin.sh — extract exercises and their solutions into a PDF to hand back
|
||||
#
|
||||
# _extensions/notes/handin.sh [options] SELECTION...
|
||||
#
|
||||
# SELECTION (any mix):
|
||||
# 1.3 an exercise, numbered as in the notes
|
||||
# 2 every exercise of chapter 2
|
||||
# 2.Light.qmd every exercise of that chapter file
|
||||
# '#my-id' the exercise written ::::{.exo #my-id}
|
||||
# all every exercise of the book
|
||||
#
|
||||
# Options:
|
||||
# -o, --output FILE where to write it (default: _handin/solutions-<selection>.pdf)
|
||||
# --no-statement only the solutions, not the exercise statements
|
||||
# --hints keep the hints (dropped by default)
|
||||
# --subtitle TEXT title page subtitle (default: "Solutions — Exercise 1.3, ...")
|
||||
# --profile NAME Quarto profile, e.g. the language of a multilingual book
|
||||
# --to pdf|docx output format (default: pdf)
|
||||
#
|
||||
# The whole book is rendered as usual (same config, figures, glossary,
|
||||
# language), into a temporary folder: _book/ is not touched. Only the selected
|
||||
# exercises are kept, statements with solutions in place, one part after the
|
||||
# other. The console lists every extracted exercise and flags empty solutions.
|
||||
#
|
||||
# Example: _extensions/notes/handin.sh 1.3 1.5 --subtitle "Series 2"
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
usage() { sed -n '2,/^$/{s/^# \{0,1\}//;p}' "$0"; }
|
||||
|
||||
project="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
|
||||
[ -f "$project/_quarto.yml" ] || { echo "handin: no _quarto.yml in $project" >&2; exit 1; }
|
||||
|
||||
output="" statement=true hints=false subtitle="" profile="" to=pdf
|
||||
selection=()
|
||||
while [ $# -gt 0 ]; do
|
||||
case "$1" in
|
||||
-h|--help) usage; exit 0 ;;
|
||||
-o|--output) output="$2"; shift ;;
|
||||
--no-statement) statement=false ;;
|
||||
--hints) hints=true ;;
|
||||
--subtitle) subtitle="$2"; shift ;;
|
||||
--profile) profile="$2"; shift ;;
|
||||
--to) to="$2"; shift ;;
|
||||
-*) echo "handin: unknown option $1 (see --help)" >&2; exit 1 ;;
|
||||
*) selection+=("$1") ;;
|
||||
esac
|
||||
shift
|
||||
done
|
||||
[ ${#selection[@]} -gt 0 ] || { usage; exit 1; }
|
||||
case "$to" in pdf|docx) ;; *) echo "handin: --to must be pdf or docx" >&2; exit 1 ;; esac
|
||||
|
||||
if [ -z "$output" ]; then
|
||||
name="$(printf '%s_' "${selection[@]}" | tr -c 'A-Za-z0-9._-' '_' | sed 's/_*$//')"
|
||||
output="$project/_handin/solutions-$name.$to"
|
||||
fi
|
||||
case "$output" in /*) ;; *) output="$PWD/$output" ;; esac
|
||||
|
||||
tmp="$(mktemp -d)"
|
||||
trap 'rm -rf "$tmp"' EXIT
|
||||
|
||||
# YAML double-quoted string
|
||||
yq() { local s="${1//\\/\\\\}"; s="${s//\"/\\\"}"; printf '"%s"' "$s"; }
|
||||
{
|
||||
echo "exo-handin: $(yq "${selection[*]}")"
|
||||
echo "exo-handin-statement: $statement"
|
||||
echo "exo-handin-hints: $hints"
|
||||
[ -n "$subtitle" ] && echo "exo-handin-subtitle: $(yq "$subtitle")"
|
||||
echo "toc: false"
|
||||
echo "lof: false"
|
||||
echo "lot: false"
|
||||
} > "$tmp/handin.yml"
|
||||
|
||||
cd "$project"
|
||||
args=(render --to "$to" --no-clean --metadata-file "$tmp/handin.yml" --output-dir "$tmp/out")
|
||||
[ -n "$profile" ] && args+=(--profile "$profile")
|
||||
quarto "${args[@]}"
|
||||
|
||||
result="$(find "$tmp/out" -maxdepth 1 -name "*.$to" | head -n 1)"
|
||||
[ -n "$result" ] || { echo "handin: quarto produced no .$to file" >&2; exit 1; }
|
||||
mkdir -p "$(dirname "$output")"
|
||||
cp "$result" "$output"
|
||||
echo
|
||||
echo "handin: wrote $output"
|
||||
Reference in new issue
Block a user