ackandClaude Fable 5.1
715d939727
- CRLF line endings are read as newlines on every system (the reader used to delete the pair, collapsing a Notepad++ file into one line on Linux and macOS); a leading UTF-8 byte-order mark is ignored; a UTF-16 or Windows-1252 source is refused with the encoding, the place and the remedy named. .gitattributes pins LF in every clone. - Windows source install: the repository path must hold no space (GNU Make), accented letters are fine (every linker input is relative now); python.org's Python is selected ahead of an MSYS2 one that poppler pulls in; TeX Live goes to its Windows default C:\texlive\2026. - The Python binding needs an ASCII installation path on Windows, and its suite says so there. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
129 lines
7.3 KiB
Bash
129 lines
7.3 KiB
Bash
# env/runtime.env — single self-configuring runtime environment for Klammertext.
|
|
#
|
|
# Source this from your shell profile (~/.bashrc etc.):
|
|
# source /path/to/klammertext/K/env/runtime.env
|
|
#
|
|
# This is the runtime counterpart of the shared env/makefile.env: one file
|
|
# for every machine, with all machine-specific values AUTO-DETECTED. There is no
|
|
# per-host runtime.env.<host> file and no HOST/OS/SITE selector.
|
|
# - KLAMMERTEXT_HOME : derived from this file's own location (self-locating)
|
|
# - KLAMMERTEXT_TEXLIVE_BIN : newest ~/external/texlive/<year>/bin/<arch>
|
|
# Machine-unique, non-committable additions (extra library paths such as NVIDIA
|
|
# iray, local tools, etc.) go in an optional, gitignored env/runtime.env.local
|
|
# sourced at the end -- NOT in this shared file, so one machine's bundled
|
|
# libraries can't shadow another's system libraries.
|
|
|
|
# --- KLAMMERTEXT_HOME: self-locate (bash sets BASH_SOURCE; zsh sets $0) --------
|
|
# This file lives at $KLAMMERTEXT_HOME/env/runtime.env, so go up one level.
|
|
_kt_self="${BASH_SOURCE[0]:-$0}"
|
|
export KLAMMERTEXT_HOME="$(cd "$(dirname "$_kt_self")/.." && pwd)"
|
|
unset _kt_self
|
|
|
|
_kt_uname="$(uname -s)"
|
|
# Windows under MSYS2: the commands are native programs and never understand
|
|
# MSYS's /c/... spelling, so KLAMMERTEXT_HOME and TMPDIR reach them in Windows
|
|
# form (C:/..., cygpath -m). bash's own PATH keeps the POSIX form -- a colon
|
|
# inside a PATH entry splits it. Python (python.org's) is the user's to put on
|
|
# PATH; an MSYS2 login shell does not inherit the Windows PATH by default.
|
|
_kt_home_posix="$KLAMMERTEXT_HOME"
|
|
case "$_kt_uname" in
|
|
MINGW*|MSYS*)
|
|
export KLAMMERTEXT_HOME="$(cygpath -m "$KLAMMERTEXT_HOME")"
|
|
export TMPDIR="$(cygpath -m "${TMPDIR:-/tmp}")"
|
|
export PYTHON="${PYTHON:-python}" # python.org installs no python3
|
|
# "python" must be python.org's interpreter: the build embeds it and
|
|
# pip installs OpenImageIO into it. But the UCRT64 shell puts
|
|
# /ucrt64/bin first on PATH, and an MSYS2 package installed as a
|
|
# dependency (poppler -> glib2 -> python) puts ITS python there, which
|
|
# then shadows python.org's for make, the suites and the tooling.
|
|
# python.org's launcher knows only python.org installs: put the
|
|
# directory of the interpreter it selects first. (Its output ends
|
|
# in CR LF, hence the tr.)
|
|
if command -v py >/dev/null 2>&1; then
|
|
_kt_py="$(py -3 -c 'import sys; print(sys.executable)' 2>/dev/null | tr -d '\r')"
|
|
if [ -n "$_kt_py" ]; then
|
|
export PATH="$(dirname "$(cygpath -u "$_kt_py")"):$PATH"
|
|
fi
|
|
unset _kt_py
|
|
fi
|
|
;;
|
|
esac
|
|
|
|
# --- KLAMMERTEXT_TEXLIVE_BIN: newest installed TeX Live under ~/external -------
|
|
# Klammertext's TeX Live installs are named by 4-digit year (2024, 2025, 2026).
|
|
# Match only those so unrelated dirs (e.g. a "texlive-2022-min" system install)
|
|
# are never selected; sort -V then picks the newest year.
|
|
if [ "$_kt_uname" = "Darwin" ]; then
|
|
_kt_arch="universal-darwin"
|
|
elif case "$_kt_uname" in MINGW*|MSYS*) true;; *) false;; esac; then
|
|
_kt_arch="windows" # TeX Live's bin/windows
|
|
else
|
|
_kt_arch="$(uname -m)-linux" # e.g. x86_64-linux
|
|
fi
|
|
# Use `find` with a -path pattern, NOT a shell glob: on macOS/zsh an unmatched
|
|
# glob (no texlive installed) is a hard "no matches found" error, whereas find
|
|
# just returns nothing. The -path pattern keeps the 4-digit-year restriction.
|
|
# Windows: a user installs under the Windows home, %USERPROFILE%\external
|
|
# (MSYS2's $HOME is C:\msys64\home\<user>, which no Windows guide would name).
|
|
# Windows also: TeX Live's own default, C:\texlive\<year> -- the place for a
|
|
# user whose profile path holds a space or an accented letter, which TeX
|
|
# Live's installer and kpathsea do not take (2026-09-26). The newest YEAR
|
|
# wins across both roots (the year is the sort key, not the path).
|
|
_kt_tlroot="$HOME/external/texlive"; _kt_tlroot2=""
|
|
case "$_kt_uname" in MINGW*|MSYS*) _kt_tlroot="$(cygpath -u "$USERPROFILE")/external/texlive"; _kt_tlroot2="/c/texlive";; esac
|
|
_kt_tl="$( { find "$_kt_tlroot" -maxdepth 3 -type d \
|
|
-path "*/[0-9][0-9][0-9][0-9]/bin/$_kt_arch" 2>/dev/null
|
|
[ -n "$_kt_tlroot2" ] && find "$_kt_tlroot2" -maxdepth 3 -type d \
|
|
-path "*/[0-9][0-9][0-9][0-9]/bin/$_kt_arch" 2>/dev/null; } \
|
|
| awk -F/ '{ print $(NF-2) " " $0 }' | sort -V | tail -1 | cut -d' ' -f2-)"
|
|
[ -n "$_kt_tl" ] && export KLAMMERTEXT_TEXLIVE_BIN="$_kt_tl"
|
|
unset _kt_tl _kt_arch _kt_tlroot _kt_tlroot2
|
|
|
|
# --- PATH (TeX Live appended only if one was found) ---------------------------
|
|
export PATH="$_kt_home_posix/bin:$_kt_home_posix/tst${KLAMMERTEXT_TEXLIVE_BIN:+:$KLAMMERTEXT_TEXLIVE_BIN}:$PATH"
|
|
unset _kt_home_posix
|
|
|
|
# --- The Python binding (kpy/) -----------------------------------------------
|
|
# "import klammertext" with no setup, as the container image already arranges
|
|
# through its own PYTHONPATH. Prepended, so a source build shadows any other
|
|
# copy; the module is bound to the Python the library was built against.
|
|
export PYTHONPATH="$KLAMMERTEXT_HOME/kpy${PYTHONPATH:+:$PYTHONPATH}"
|
|
|
|
# --- Per-platform: LSan suppressions + shared library search path -------------
|
|
# The shared library path deliberately includes ONLY Klammertext's own .so dirs,
|
|
# NOT third-party bundled-library dirs. In particular NVIDIA iray's platforms/
|
|
# ships its own libfreetype.so and Qt6; if added here they shadow the system
|
|
# libraries, and iray's freetype drags in unversioned libharfbuzz.so/libbz2.so
|
|
# (absent without -dev packages), which breaks `import OpenImageIO` (SKS @image).
|
|
# Machine-specific library paths (iray included) go in runtime.env.local.
|
|
if [ "$_kt_uname" = "Darwin" ]; then
|
|
# macOS: no LD/DYLD_LIBRARY_PATH needed — libklammertext.so is found via the
|
|
# binaries' @loader_path rpath and document.so is dlopen'd by absolute path.
|
|
# LeakSanitizer is unsupported on macOS, so LSAN_OPTIONS does not apply.
|
|
:
|
|
else
|
|
# LSan suppressions for unactionable libpython/OpenImageIO leaks (see
|
|
# lsan.supp). Real leaks in Klammertext code are still reported; no effect
|
|
# in performance builds (OPTIMIZE=1, which disables ASan).
|
|
export LSAN_OPTIONS="suppressions=$KLAMMERTEXT_HOME/env/lsan.supp:print_suppressions=0"
|
|
export LD_LIBRARY_PATH="$KLAMMERTEXT_HOME/mac:$KLAMMERTEXT_HOME/sks/kutil:$KLAMMERTEXT_HOME/sks/document:$KLAMMERTEXT_HOME/doc/handbook${LD_LIBRARY_PATH:+:$LD_LIBRARY_PATH}"
|
|
fi
|
|
unset _kt_uname
|
|
|
|
# --- The mdpdf command (Markdown -> PDF; sks/tns/mdpdf.sh) --------------------
|
|
# Sourced here rather than left to each user's profile, so the command exists
|
|
# wherever the rest of the Klammertext environment does. The file defines one
|
|
# shell function and registers completion for it: POSIX shell, no output, and
|
|
# harmless in a non-interactive shell.
|
|
if [ -f "$KLAMMERTEXT_HOME/sks/tns/mdpdf.sh" ]; then
|
|
. "$KLAMMERTEXT_HOME/sks/tns/mdpdf.sh"
|
|
fi
|
|
|
|
# --- Optional per-machine escape hatch (gitignored, absent by default) ---------
|
|
# Use an if-block (not `[ -f ] && .`) so that when the local file is absent this
|
|
# file's final exit status is 0 -- otherwise `source runtime.env` returns
|
|
# non-zero, breaking `source runtime.env && ...` and `set -e` callers.
|
|
if [ -f "$KLAMMERTEXT_HOME/env/runtime.env.local" ]; then
|
|
. "$KLAMMERTEXT_HOME/env/runtime.env.local"
|
|
fi
|