Handbuch auf MkDocs-Basis, mit Bildschirmfotos aus dem Programm

26 Kapitel in vier Teilen, in der Reihenfolge, in der man sie braucht:
erst sichern, dann Dateien holen, dann ganze Maschinen wiederherstellen,
dahinter der Nachschlagteil.

Gebaut wird mit MkDocs + Material. Bewusst ohne Netzabhaengigkeiten:
keine Schriften vom CDN (font: false), Volltextsuche mit deutschem
Stemming liegt neben den Seiten. Im Notfall steht vielleicht das halbe
Netz - dann nuetzt eine Doku im Internet nichts.

  handbuch/bauen.sh              baut handbuch/site/
  handbuch/bauen.sh ansehen      Vorschau auf 127.0.0.1:8000

install.sh nimmt das gebaute Handbuch mit nach
/usr/share/doc/pvesnap/handbuch/ - falls es vorliegt. Auf dem Host selbst
wird nichts gebaut, mkdocs gehoert nicht auf einen Hypervisor.

Die 28 Bildschirmfotos sind nicht abfotografiert, sondern erzeugt: Der
echte Programmcode laeuft in einem Pseudo-Terminal gegen einen erfundenen
Proxmox-Host (Attrappen fuer pvesh, perl und rbd), pyte baut den Bildschirm
nach, heraus faellt ein SVG. Damit stimmen sie garantiert mit dem Programm
ueberein, sind reproduzierbar und enthalten keine echten Daten. Die
Werkstatt dafuer liegt unter handbuch/werkstatt/ samt LIESMICH.md.

Nebenbei: die Schlussmeldung von install.sh warb noch mit --exchange,
das mit dem eingebauten Austauschlaufwerk weggefallen ist.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

handbuch/docs/nachschlagen/tasten.md

@@ -0,0 +1,148 @@
+# Tastenkürzel
+
+Alle Oberflächen auf einer Seite. Zum Ausdrucken und Danebenlegen.
+
+---
+
+## `pvesnap config` — Gruppenliste
+
+| Taste | |
+|---|---|
+| ++enter++ | Gruppe bearbeiten |
+| ++space++ | Gruppe ein- oder ausschalten |
+| ++n++ | neue Gruppe |
+| ++c++ | Gruppe kopieren |
+| ++d++ | Gruppe löschen |
+| ++g++ | globale Einstellungen |
+| ++v++ | Übersicht: welche VM in welcher Gruppe |
+| ++s++ | speichern |
+| ++r++ | Dienst neu laden |
+| ++q++ | Ende |
+
+### Gruppenmaske
+
+| Taste | |
+|---|---|
+| ++up++ ++down++ | Feld wählen |
+| ++page-up++ ++page-down++ | zehn Felder weiter |
+| ++enter++ ++space++ | Feld ändern bzw. umschalten |
+| ++v++ | VM-Auswahl öffnen |
+| ++q++ ++esc++ | zurück |
+
+### VM-Auswahl
+
+| Taste | |
+|---|---|
+| ++space++ | Gast an- oder abwählen |
+| ++a++ | alle |
+| ++n++ | keine |
+| ++i++ | Auswahl umkehren |
+| ++slash++ | filtern |
+| ++enter++ | übernehmen |
+| ++esc++ | abbrechen |
+
+---
+
+## `pvesnap-explorer`
+
+| Taste | |
+|---|---|
+| ++tab++ | Fenster wechseln |
+| ++up++ ++down++ | bewegen |
+| ++enter++ | Verzeichnis öffnen oder Datei ansehen |
+| ++backspace++ ++left++ | ein Verzeichnis hoch |
+| ++home++ ++end++ | Anfang / Ende |
+| ++page-up++ ++page-down++ | seitenweise |
+| ++space++ | markieren |
+| ++asterisk++ | Markierung umkehren |
+| ++a++ | alle markieren |
+| ++u++ | Markierung aufheben |
+| ++f5++ ++c++ | Markiertes ins andere Fenster kopieren |
+| ++f3++ ++v++ | Datei ansehen (Text oder Hex) |
+| ++f7++ ++n++ | neues Verzeichnis (nur lokal) |
+| ++f6++ ++g++ | Verzeichnis direkt eingeben |
+| ++f2++ ++m++ | anderes Dateisystem des Snapshots wählen |
+| ++r++ | neu einlesen |
+| ++f1++ ++question++ | Hilfe |
+| ++f10++ ++q++ | eine Ebene zurück |
+
+Während des Kopierens bricht ++esc++ ab.
+
+---
+
+## `pvesnap-recovery` — Übersicht
+
+| Taste | |
+|---|---|
+| ++enter++ | Detailansicht |
+| ++n++ | neue Wiederherstellung |
+| ++s++ | starten |
+| ++h++ | herunterfahren |
+| ++x++ | verwerfen |
+| ++v++ | Austauschlaufwerke |
+| ++r++ | neu einlesen |
+| ++q++ | Ende |
+
+### Detailansicht
+
+| Taste | |
+|---|---|
+| ++s++ | starten |
+| ++h++ | herunterfahren |
+| ++e++ | Austauschlaufwerk auswerfen / einklinken |
+| ++v++ | Austauschlaufwerke verwalten |
+| ++p++ | SPICE und USB |
+| ++f++ | vom Quell-Snapshot lösen |
+| ++x++ | verwerfen |
+| ++q++ | zurück |
+
+### Optionsmaske
+
+| Taste | |
+|---|---|
+| ++up++ ++down++ | Feld wählen |
+| ++enter++ ++space++ | Feld ändern |
+| ++v++ | Austauschlaufwerke verwalten |
+| ++f10++ | anlegen |
+| ++q++ | abbrechen |
+
+### Zusammenfassung
+
+| Taste | |
+|---|---|
+| ++j++ | anlegen |
+| ++n++ ++q++ | abbrechen |
+| beliebige Taste | weiterblättern, wenn der Text länger ist als der Bildschirm |
+
+---
+
+## Austauschlaufwerke
+
+| Taste | |
+|---|---|
+| ++enter++ | am Host einhängen und im Commander öffnen |
+| ++n++ | neues Laufwerk anlegen |
+| ++u++ | am Host aushängen |
+| ++l++ | löschen |
+| ++r++ | neu einlesen |
+| ++q++ | zurück |
+
+### Mehrfachauswahl beim Anlegen einer Maschine
+
+| Taste | |
+|---|---|
+| ++space++ | aus- oder abwählen |
+| ++enter++ | übernehmen |
+| ++q++ | abbrechen |
+
+---
+
+## Überall gleich
+
+| Taste | |
+|---|---|
+| ++up++ ++down++ oder ++k++ ++j++ | in Auswahlfenstern bewegen |
+| ++enter++ | bestätigen |
+| ++esc++ ++q++ | abbrechen / zurück |
+| ++j++ ++n++ | Ja/Nein-Rückfragen |
+| ++ctrl+u++ | Eingabezeile leeren |