From 95dd415de023375f84827514ae01f318ef3863ab Mon Sep 17 00:00:00 2001 From: Valentin Date: Wed, 15 Oct 2025 17:03:48 +0200 Subject: =?UTF-8?q?Dokumentation=20f=C3=BCr=20Handhabung=20der=20Website?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- www/README.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 www/README.md diff --git a/www/README.md b/www/README.md new file mode 100644 index 0000000..fbae74e --- /dev/null +++ b/www/README.md @@ -0,0 +1,31 @@ +# Website `heimfeld.hamburg` + +Hier sind alle Komponenten untergebracht, um die Website auf dem Server darzustellen: Inhalte und Konfiguration. + +## Abläufe + +### Lokale Vorschau + +```bash +nix run .#preview +``` + +Es öffnet sich ein Browserfenster und aktualisiert sich selbst, sobald an den Inhalten etwas geändert wird. + +### Website veröffentlichen + +```bash +nix run .#publish +``` + +Die Inhalte der Website werden auf den Server kopiert. + +Bestehende Daten werden überschrieben. +Zur Wiederherstellung die Versionsgeschichte nutzen. + +## Architektur + +Dieses Verzeichnis ist im Sinne des Änderungsverlauf von der Infrastruktur isoliert, sodass man es bei Bedarf mit `git filter-repo` (um Platz im Hauptverzeichnis zu sparen) oder `git subtree split` (für eine separate Darstellung) komplett heraustrennen kann. + +Der [`html`](./html) Unterorder kann ebenfalls für sich stehen, wenn man nur die Versionsgeschichte der Inhalte gesondert betrachten will. +Daher sind alle Hilfswerkzeuge und Infrastruktur-Konfiguration außerhalb untergebracht. -- cgit v1.2.3