= 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 (extern)

Mit der Gitlab Ci kann ein beliebiges Dokumnet als Master in einem beliebigen Verzeiniss, gilt dann als Root Dir, die vier (fünf) ausgabeformate erzeuten. Zur Zeit mit festen Theming das nicht einheitlich über die Formate ist

* HTML ein Verzeichniss mit der index.html und allen CSS/Image Dateien
* PDF mit asciidoctor-pdf und einem Theming
* ePub mit asciidoctor-epub und dem PDF Teming
* mobi ist ein ePub falloff
* LaTex ist noch defekt und es fehlt ein workflow

link: https://git.exta.de/dexta/chbuilder[computerHistory world Builder]

== 4.1 Der Build Test (lokal)

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

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

. *Ablauf:*