112 lines
3.6 KiB
Plaintext
112 lines
3.6 KiB
Plaintext
= 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.
|