blitztextweb

Statische Produktwebsite für Blitztext Linux, veröffentlicht über GitHub Pages unter https://timintech.github.io/blitztextweb/.

Dieses Repository enthält ausschließlich die Website. Die Desktop-App lebt im getrennten Repository TimInTech/blitztext-linux. Die Website ist eigenständig klonbar und baubar – sie hat keine Build- oder Laufzeitabhängigkeit zum App-Repository.

Stack

• Astro mit statischer Ausgabe (output: 'static')
• TypeScript (strict), reines CSS, minimales Vanilla-JS (Mobile-Navigation, Copy-Buttons)
• Keine externen CDN-Ressourcen, keine Webfonts, keine Analytics, keine Cookies

Voraussetzungen

• Node.js ≥ 22.23.4
• npm ≥ 10.8.2
• npm

Entwicklung

npm ci            # Abhängigkeiten installieren (nutzt package-lock.json)
npm run dev       # Entwicklungsserver (http://localhost:4321)
npm run check     # Astro-/TypeScript-Prüfung
npm run build     # Produktionsbuild → dist/
npm run preview   # gebauten Stand lokal ansehen

Der Produktionsbuild landet im Ordner dist/ und ist für die Auslieferung unter dem GitHub-Pages-Unterpfad /blitztextweb/ gebaut (base: '/blitztextweb' in astro.config.mjs).

Seiten

Alle Routen werden unter dem Unterpfad /blitztextweb/ ausgeliefert.

Route	Inhalt
/blitztextweb/	Deutsche Startseite
/blitztextweb/en/	Englische Startseite
/blitztextweb/impressum/	Impressum (Betreiberangaben nach § 5 DDG)
/blitztextweb/datenschutz/	Datenschutzerklärung (Deutsch)
/blitztextweb/en/privacy/	Datenschutzerklärung (Englisch)
/blitztextweb/404.html	Fehlerseite

Herkunft der Blitztext-Assets

Logo, Screenshots und Tray-Icons in public/brand/, public/screenshots/ und public/images/ stammen unverändert bzw. verlustfrei optimiert aus dem App-Repository TimInTech/blitztext-linux (Stand: Single-Panel-Widget):

• public/brand/ ← app/assets/logo-mark*.svg
• public/screenshots/ ← docs/screenshots/linux/ (identische Dateinamen)
• public/images/og-*.png ← docs/screenshots/linux/Banner-{de,en}.png

Die Screenshots werden im App-Repository mit PYTHONPATH=. QT_QPA_PLATFORM=offscreen .venv/bin/python scripts/_make_screenshots.py erzeugt und von dort hierher kopiert.

Deployment

Gehostet wird ausschließlich über GitHub Pages (Project Page) unter:

https://timintech.github.io/blitztextweb/

Es wird keine Custom Domain verwendet – es gibt keine CNAME-Datei und keine DNS-Konfiguration.

• Deployment über GitHub Actions, Workflow .github/workflows/deploy-pages.yml (Trigger: Push auf main oder manueller workflow_dispatch). Der Produktionsbuild in dist/ wird als Pages-Artefakt veröffentlicht.
• Pull Requests werden nur von .github/workflows/ci.yml geprüft (Build ohne Deploy) und deployen niemals.
• Die Schreibrechte pages: write / id-token: write gelten ausschließlich für den Deploy-Job; Build und Workflow-Ebene laufen mit contents: read.
• Die eigentliche Aktivierung von GitHub Pages (Settings → Pages → Source: GitHub Actions) erfolgt manuell und ist nicht Teil dieses Repos.