From 0ac0624ba28d0303c118ac37dfe8f9a16f792a32 Mon Sep 17 00:00:00 2001 From: torsten Date: Sun, 1 Nov 2026 13:47:06 +0100 Subject: [PATCH] fix: Dokumente-Ordner sprachunabhaengig aufloesen - neues tools/_paths.sh loest den Dokumente-Ordner zur Laufzeit auf: xdg-user-dir DOCUMENTS, sonst ~/Dokumente, sonst ~/Documents - sync_assets.sh und rotoscope.sh nutzen workbench_dir statt $HOME/Documents/workbench_rinkplanner - promote_rotoscope.py und blender/rotoscope.py loesen den Workbench-Pfad genauso auf und bevorzugen weiterhin RINKPLANNER_WORKBENCH - Doku auf den tatsaechlichen Pfad ~/Dokumente/workbench_rinkplanner umgestellt --- docs/architecture.md | 2 +- docs/assets.md | 4 +-- docs/findings-2026-10-31-arp-rig.md | 2 +- docs/rotoscoping.md | 2 +- tools/_paths.sh | 39 +++++++++++++++++++++++++++++ tools/blender/rotoscope.py | 30 +++++++++++++++++++--- tools/promote_rotoscope.py | 31 ++++++++++++++++++++--- tools/rotoscope.sh | 5 +++- tools/sync_assets.sh | 7 ++++-- 9 files changed, 108 insertions(+), 14 deletions(-) create mode 100644 tools/_paths.sh diff --git a/docs/architecture.md b/docs/architecture.md index ce1622f..ac7ae8d 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -177,7 +177,7 @@ Sprung. Der Export verwendet die zusammengesetzte Caption (`3Lz+2T`, **D13 – 3D-Assets liegen extern, das Repo hält nur das Manifest.** Die Binärdateien (GLB, `.blend`, Texturen) liegen im Workbench-Archiv unter -`~/Documents/workbench_rinkplanner`, nicht im Git-Repo. Das Repo enthält +`~/Dokumente/workbench_rinkplanner`, nicht im Git-Repo. Das Repo enthält `assets/asset_manifest.json` mit ID, Quell-/Zielpfad, SHA-256, Größe, Platzierungsdaten und Rig-Metadaten. `tools/sync_assets.sh` prüft beide Seiten gegen den Hash, kopiert nach `assets/external/` (gitignored) und stößt diff --git a/docs/assets.md b/docs/assets.md index de8fff6..e4bdd1b 100644 --- a/docs/assets.md +++ b/docs/assets.md @@ -9,7 +9,7 @@ bleiben im Workbench-Archiv. ## Verzeichnisse ``` -/home/torsten/Documents/workbench_rinkplanner/ +/home/torsten/Dokumente/workbench_rinkplanner/ ├── inbox/ # Eingang, unverändert lassen ├── library/ # kuratiert, vom Manifest referenziert │ └── characters/ @@ -112,7 +112,7 @@ Weitere Umgebungsvariablen: | Variable | Standard | Zweck | | :--- | :--- | :--- | -| `RINKPLANNER_WORKBENCH` | `~/Documents/workbench_rinkplanner` | Archivpfad | +| `RINKPLANNER_WORKBENCH` | `~/Dokumente/workbench_rinkplanner` | Archivpfad | | `RINKPLANNER_CREDENTIALS` | `/docs/credentials.txt` | FTP-Konfiguration | | `GODOT` | `/opt/godot/Godot_v4.7.2-stable_linux.x86_64` | Import-Binary | diff --git a/docs/findings-2026-10-31-arp-rig.md b/docs/findings-2026-10-31-arp-rig.md index 7b79a29..0064b45 100644 --- a/docs/findings-2026-10-31-arp-rig.md +++ b/docs/findings-2026-10-31-arp-rig.md @@ -23,7 +23,7 @@ reproduzierbar ins Projekt kommen. - ARP liegt als Blender-5.2-Extension unter `~/.config/blender/5.2/extensions/superhivemarket_com/`. -- Die AI-Marker-Dateien fehlen (`~/Documents/AutoRigPro/AI` existiert nicht). +- Die AI-Marker-Dateien fehlen (`~/Dokumente/AutoRigPro/AI` existiert nicht). Die Marker wurden deshalb skriptbasiert gesetzt: Neck, Chin, Head Tip, Root, Thigh, Knee, Foot, Shoulder, Elbow, Hand, Hand Tip. diff --git a/docs/rotoscoping.md b/docs/rotoscoping.md index c55014d..dd1593b 100644 --- a/docs/rotoscoping.md +++ b/docs/rotoscoping.md @@ -154,7 +154,7 @@ Ohne eigenes Videomaterial lässt sich die Pipeline vollständig prüfen: ```bash ./tools/rotoscope.sh test-reference ./tools/rotoscope.sh setup \ - --reference "$HOME/Documents/workbench_rinkplanner/source/characters/skater/rotoscope/references/test_reference.mp4" \ + --reference "$HOME/Dokumente/workbench_rinkplanner/source/characters/skater/rotoscope/references/test_reference.mp4" \ --out /tmp/rotoscope_test.blend --force ``` diff --git a/tools/_paths.sh b/tools/_paths.sh new file mode 100644 index 0000000..1769b60 --- /dev/null +++ b/tools/_paths.sh @@ -0,0 +1,39 @@ +#!/usr/bin/env bash +# Gemeinsame Pfad-Helfer. Wird gesourct, nicht direkt ausgeführt. + +# documents_dir +# Liefert den Dokumente-Ordner des Benutzers. Der Verzeichnisname hängt von +# der Systemsprache ab (XDG, z. B. ~/Dokumente oder ~/Documents) und wird +# deshalb zur Laufzeit aufgelöst. +documents_dir() { + local candidate="" + + if command -v xdg-user-dir >/dev/null 2>&1; then + candidate="$(xdg-user-dir DOCUMENTS 2>/dev/null || true)" + # xdg-user-dir liefert $HOME, wenn kein Dokumente-Ordner konfiguriert ist. + if [[ -n "$candidate" && "$candidate" != "$HOME" && -d "$candidate" ]]; then + printf '%s\n' "$candidate" + return 0 + fi + fi + + for candidate in "$HOME/Dokumente" "$HOME/Documents"; do + if [[ -d "$candidate" ]]; then + printf '%s\n' "$candidate" + return 0 + fi + done + + printf '%s\n' "$HOME/Documents" +} + +# workbench_dir +# Pfad zum Workbench-Archiv: RINKPLANNER_WORKBENCH oder +# /workbench_rinkplanner. +workbench_dir() { + if [[ -n "${RINKPLANNER_WORKBENCH:-}" ]]; then + printf '%s\n' "$RINKPLANNER_WORKBENCH" + else + printf '%s\n' "$(documents_dir)/workbench_rinkplanner" + fi +} diff --git a/tools/blender/rotoscope.py b/tools/blender/rotoscope.py index 535bd7b..50cfe7b 100755 --- a/tools/blender/rotoscope.py +++ b/tools/blender/rotoscope.py @@ -4,14 +4,38 @@ import json import math import os import struct +import subprocess import sys import bpy -WORKBENCH = os.environ.get( - "RINKPLANNER_WORKBENCH", - os.path.expanduser("~/Documents/workbench_rinkplanner"), +def documents_dir() -> str: + """Dokumente-Ordner des Benutzers; der Name hängt von der Sprache ab.""" + home = os.path.expanduser("~") + try: + result = subprocess.run( + ["xdg-user-dir", "DOCUMENTS"], + capture_output=True, + text=True, + check=False, + ) + except OSError: + result = None + if result is not None and result.returncode == 0: + candidate = result.stdout.strip() + # xdg-user-dir liefert $HOME, wenn kein Ordner konfiguriert ist. + if candidate and candidate != home and os.path.isdir(candidate): + return candidate + for name in ("Dokumente", "Documents"): + candidate = os.path.join(home, name) + if os.path.isdir(candidate): + return candidate + return os.path.join(home, "Documents") + + +WORKBENCH = os.environ.get("RINKPLANNER_WORKBENCH") or os.path.join( + documents_dir(), "workbench_rinkplanner" ) DEFAULT_RIG = os.path.join( WORKBENCH, "source", "characters", "skater", "skater_rig_v006.blend" diff --git a/tools/promote_rotoscope.py b/tools/promote_rotoscope.py index 9914be5..d3df314 100755 --- a/tools/promote_rotoscope.py +++ b/tools/promote_rotoscope.py @@ -15,9 +15,34 @@ import sys REPO_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) MANIFEST = os.path.join(REPO_ROOT, "rinkplanner", "assets", "asset_manifest.json") -WORKBENCH = os.environ.get( - "RINKPLANNER_WORKBENCH", - os.path.expanduser("~/Documents/workbench_rinkplanner"), + + +def documents_dir() -> str: + """Dokumente-Ordner des Benutzers; der Name hängt von der Sprache ab.""" + home = os.path.expanduser("~") + try: + result = subprocess.run( + ["xdg-user-dir", "DOCUMENTS"], + capture_output=True, + text=True, + check=False, + ) + except OSError: + result = None + if result is not None and result.returncode == 0: + candidate = result.stdout.strip() + # xdg-user-dir liefert $HOME, wenn kein Ordner konfiguriert ist. + if candidate and candidate != home and os.path.isdir(candidate): + return candidate + for name in ("Dokumente", "Documents"): + candidate = os.path.join(home, name) + if os.path.isdir(candidate): + return candidate + return os.path.join(home, "Documents") + + +WORKBENCH = os.environ.get("RINKPLANNER_WORKBENCH") or os.path.join( + documents_dir(), "workbench_rinkplanner" ) ASSET_ID = "character.skater.figure" diff --git a/tools/rotoscope.sh b/tools/rotoscope.sh index 4ca14e4..059ecf0 100755 --- a/tools/rotoscope.sh +++ b/tools/rotoscope.sh @@ -7,7 +7,9 @@ set -euo pipefail REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)" -WORKBENCH="${RINKPLANNER_WORKBENCH:-$HOME/Documents/workbench_rinkplanner}" +# shellcheck source=tools/_paths.sh +source "$REPO_ROOT/tools/_paths.sh" +WORKBENCH="$(workbench_dir)" BLENDER="${BLENDER:-$(command -v blender || true)}" SCRIPT="$REPO_ROOT/tools/blender/rotoscope.py" @@ -47,6 +49,7 @@ Aufruf: tools/rotoscope.sh [optionen] Umgebung: RINKPLANNER_WORKBENCH Workbench-Archiv + (Standard: /workbench_rinkplanner) BLENDER Blender-Binary RINKPLANNER_RIG Quell-Rig (Standard: skater_rig_v006.blend) EOF diff --git a/tools/sync_assets.sh b/tools/sync_assets.sh index d74d552..f10740a 100755 --- a/tools/sync_assets.sh +++ b/tools/sync_assets.sh @@ -11,9 +11,11 @@ set -euo pipefail REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)" +# shellcheck source=tools/_paths.sh +source "$REPO_ROOT/tools/_paths.sh" PROJECT_DIR="$REPO_ROOT/rinkplanner" MANIFEST="$PROJECT_DIR/assets/asset_manifest.json" -WORKBENCH="${RINKPLANNER_WORKBENCH:-$HOME/Documents/workbench_rinkplanner}" +WORKBENCH="$(workbench_dir)" GODOT="${GODOT:-/opt/godot/Godot_v4.7.2-stable_linux.x86_64}" if [[ ! -x "$GODOT" && -x "/Applications/Godot.app/Contents/MacOS/Godot" ]]; then GODOT="/Applications/Godot.app/Contents/MacOS/Godot" @@ -51,7 +53,8 @@ Aufruf: tools/sync_assets.sh [--check|--sync|--publish] [--force] Umgebung: RINKPLANNER_WORKBENCH Pfad zum Workbench-Archiv - (Standard: ~/Documents/workbench_rinkplanner) + (Standard: /workbench_rinkplanner, + z. B. ~/Dokumente/workbench_rinkplanner) RINKPLANNER_CREDENTIALS Pfad zur FTP-Konfiguration (Standard: /docs/credentials.txt) RINKPLANNER_FTP_HOST FTP-Host (überschreibt FTP_URL)