feat: bin/build_html - HTML-Build-Wrapper analog zu build_pdf

Bisher gab es nur bin/build_pdf.* fuer den PDF-Build; der HTML-Build lief
nur als manueller sphinx-build-Aufruf ohne Wrapper-Skript.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Michael Stangl
2026-09-23 15:25:17 +02:00
co-authored by Claude Sonnet 5
parent 982879d9f0
commit 6757996704
2 changed files with 60 additions and 0 deletions
+31
View File
@@ -0,0 +1,31 @@
@echo off
REM ================================================================
REM HTML-Build der Fortna-Dokumentation (DE)
REM
REM Ablauf:
REM 1. index.rst aus vorhandenen chapters/**/*.de.rst generieren
REM 2. sphinx-build -b html -> _build/html/index.html
REM
REM Voraussetzung: chapters/ ist befuellt (fortna_convert_chapters.bat --apply)
REM ================================================================
call "%~dp0setenv.bat"
if not exist "%PROJECT%\.venv" (
echo FEHLER: .venv nicht gefunden. Bitte zuerst install_py.bat ausfuehren.
exit /b 1
)
call "%PROJECT%\.venv\Scripts\activate.bat"
echo.
echo [1/2] index.rst generieren ...
python "%PV_LIB%\build_index.py"
echo.
echo [2/2] HTML erzeugen (sphinx-build -b html) ...
python -m sphinx -b html "%PROJECT%" "%PROJECT%\_build\html"
echo.
echo Fertig. HTML: %PROJECT%\_build\html\index.html
deactivate
+29
View File
@@ -0,0 +1,29 @@
#!/usr/bin/env bash
# ================================================================
# HTML-Build der Fortna-Dokumentation (DE)
# 1. index.rst generieren
# 2. sphinx-build -b html
# Voraussetzung: chapters/ ist befuellt (fortna_convert_chapters.sh --apply)
# ================================================================
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
source "$SCRIPT_DIR/setenv.sh"
if [ ! -d "$PROJECT/.venv" ]; then
echo "FEHLER: .venv nicht gefunden. Bitte zuerst install_py.sh ausfuehren."
exit 1
fi
source "$PROJECT/.venv/bin/activate" 2>/dev/null || source "$PROJECT/.venv/Scripts/activate"
echo ""
echo "[1/2] index.rst generieren ..."
python "$PV_LIB/build_index.py"
echo ""
echo "[2/2] HTML erzeugen (sphinx-build -b html) ..."
python -m sphinx -b html "$PROJECT" "$PROJECT/_build/html"
echo ""
echo "Fertig. HTML: $PROJECT/_build/html/index.html"
deactivate