= COMPUTER HISTORYZ: System-Handbuch & Infrastruktur
:toc: left
:toclevels: 3
:icons: font

[IMPORTANT]
====
*Worldbuilding-Zentrum:*

Die inhaltliche Strukturierung deiner Lore findest du in:

* link:darkCenter.adoc[darkCenter.adoc] (modulare Includes)
* link:index.adoc[index.adoc] (vollständiger kanonischer Abriss)
====

Dieses Handbuch dokumentiert das technische Setup deines ablenkungsfreien Schreibdecks auf dem Linux-Client (Acer Spin 5 / Lenovo X220) unter Window Maker mit Neovim, Syncthing und Git.

== 1. Das Synchronisations- & Git-Konzept

Dieses System ist so konzipiert, dass der lokale Schreib-Client (Terminal) absolut flüchtig ist und bei Hardwaredefekt innerhalb von Minuten ersetzt werden kann.

. *Single Source of Truth:*
  Ein privates Git-Repository (Gitea) auf Uberspace.
  Hier liegen alle stabilen, versionierten Stände.

. *Lokaler Workspace-Buffer:*
  Ein Proxmox-Server (NAS) hält die aktuellen Arbeitsdateien vor.

. *Synchronisation (Syncthing):*
  Syncthing spiegelt die Dokumente in Echtzeit zwischen deinem lokalen Client, dem NAS-Server und mobilen Android-Geräten.

. *Git-Sicherung:*
  Nach einer Schreibsession werden die Änderungen direkt aus dem Terminal per Git-Commit gepusht.

== 2. Mobiles Schreiben (Android-Integration)

Um Geistesblitze unterwegs ohne Laptop festzuhalten, ist ein nahtloser mobiler Workflow eingerichtet:

. *Editor:*
  _Markor_ (FOSS-Markdown-/AsciiDoc-Editor via F-Droid).

. *Synchronisation:*
  Die Android-App von _Syncthing_ spiegelt das Verzeichnis `99_Inbox` im Hintergrund auf dein Mobiltelefon.

. *Diktier-Feature:*
  Neovim- oder Markor-Dokumente im Zug öffnen, Tastatur-Mikrofon aktivieren und Text einsprechen (Audio-to-Text).

  Zu Hause synchronisiert Syncthing die Datei augenblicklich zurück auf den Hauptrechner.

== 3. Editor-Setup (Neovim in Window Maker)

Da standardmäßig aus Sicherheitsgründen lokale Konfigurationen gesperrt sind, nutzen wir das projektspezifische `exrc`-Feature.

=== Startbefehl im Terminal

Boote den Editor im Hauptordner immer mit aktiviertem lokalen Profil:

[source,bash]
----
nvim .
----

Dadurch wird die im Repository getrackte `.nvim.lua` geladen, welche projektspezifische Tastenkürzel freischaltet.

=== Wichtige Tastaturkurzbefehle (Leader = Leertaste)

[cols="1,3",options="header"]
|===
|Kürzel
|Aktion

|`<Leertaste> + b`
|Startet `build.sh` (kompiliert das gesamte Projekt via Docker)

|`<Leertaste> + g + s`
|Öffnet das Git-Status-Fenster (vim-fugitive) für schnelles Committen

|`:vsp`
|Teilt den Bildschirm vertikal (ideal für Lore links, Skizze rechts)

|`:sp`
|Teilt den Bildschirm horizontal

|`Ctrl+w` gefolgt von `h/j/k/l`
|Wechselt den Fokus zwischen den geteilten Fenstern

|`:term`
|Öffnet ein integriertes Terminal in Neovim

|`Ctrl+\` dann `Ctrl+n`
|Verlässt den Terminal-Eingabemodus und kehrt in den Normal Mode zurück
|===

== 4. Die Build-Pipeline (`build.sh`)

Um deine AsciiDoc-Fragmente in ansprechende Retro-HTML-Dokumente zu gießen, nutzt das System einen flüchtigen Docker-Container.

. *Abhängigkeiten auf dem Host:*
  Lediglich `docker` und `bash` müssen installiert sein.

  Keine Java-, Ruby- oder Haskell-Laufzeitumgebungen belasten deinen Debian-Client.

. *Ablauf:*
  .. Das Skript `build.sh` prüft das Vorhandensein des lokalen Images `lore-builder`.
     Es basiert auf Alpine und enthält `asciidoctor` sowie `pandoc`.

  .. Das lokale Projektverzeichnis wird in den Container gemountet.

  .. Im Ordner `export/` werden die HTML-Dokumente inklusive des Retro-Dark-Themes (`retro-dark.css`) erzeugt.

  .. Die `index.html` wird als interaktives Terminal-Dashboard vollautomatisch neu aufgebaut.