201 lines
8.4 KiB
Markdown
201 lines
8.4 KiB
Markdown
Die Weboberfläche ist der Zugang für Menschen. Sie zeigt dasselbe Wissen, das
|
|
auch die Agenten sehen.
|
|
|
|
## Anmelden
|
|
|
|
Angemeldet wird mit dem API-Key des Projekts, also demselben, den auch das
|
|
KI-Werkzeug benutzt. Einen Benutzernamen gibt es nicht: Der Key bestimmt, wer
|
|
du bist, in welchem Projekt du arbeitest und was du darfst. Wird der Key
|
|
zurückgezogen, endet auch die Sitzung im Browser sofort.
|
|
|
|
## Finden
|
|
|
|
- **Suchen:** Das Suchfeld über der Eintragsliste durchsucht Titel,
|
|
Schlagworte und Inhalt. Titel zählen am stärksten. Umlaute sind egal:
|
|
„Uberblick“ findet auch „Überblick“. Ein Wortanfang reicht, „deploy“ findet
|
|
auch „Deployment“.
|
|
- **Nach Schlagwort filtern:** In der Seitenleiste stehen die zehn häufigsten
|
|
Schlagworte des Projekts. Ein Klick filtert die Liste. Gibt es mehr, führt
|
|
*Alle Schlagworte…* zu einer Seite mit der vollständigen Liste, nach
|
|
Häufigkeit oder alphabetisch sortiert und mit einem Filterfeld.
|
|
- **Verweisen folgen:** Unter jedem Eintrag steht, welche anderen Einträge auf
|
|
ihn verweisen.
|
|
- **Graph:** Unter *Graph* in der Seitenleiste zeigt Munin, wie die Einträge
|
|
über Verweise zusammenhängen. Gestrichelte Knoten sind Verweisziele, zu denen
|
|
es noch keinen Eintrag gibt. Mausrad zoomt, Ziehen verschiebt, ein Klick
|
|
öffnet den Eintrag. Beschriftet sind zunächst nur die wichtigsten Knoten;
|
|
beim Hineinzoomen rücken die Knoten auseinander und weitere Namen
|
|
erscheinen. Zeigt die Maus auf einen Knoten, treten er und seine direkten
|
|
Nachbarn hervor. Bei sehr großen Projekten zeigt der Graph nur die 150 am
|
|
stärksten verknüpften Einträge.
|
|
|
|
## Schreiben
|
|
|
|
Mit der Rolle `write` oder `admin` gibt es über der Liste den Knopf
|
|
**Neuer Eintrag** und in jedem Eintrag **Bearbeiten**.
|
|
|
|
| Feld | Bedeutung |
|
|
|---|---|
|
|
| Titel | Worum es geht, am besten als Frage oder klares Thema |
|
|
| Bezeichner | Der dauerhafte Name, siehe [Begriffe](/hilfe/begriffe). Leer lassen, dann wird er aus dem Titel abgeleitet. |
|
|
| Schlagworte | Durch Komma getrennt. Möglichst vorhandene wiederverwenden. |
|
|
| Inhalt | Markdown (siehe unten) |
|
|
| Kuratiert | Haken setzen, wenn der Inhalt geprüft und verlässlich ist |
|
|
|
|
**Bevor du einen neuen Eintrag anlegst**, such kurz, ob es das Thema schon gibt.
|
|
Ergänzen ist fast immer besser als ein zweiter Eintrag.
|
|
|
|
### Markdown im Inhalt
|
|
|
|
Unterstützt werden die üblichen Auszeichnungen:
|
|
|
|
```markdown
|
|
## Zwischenüberschrift
|
|
|
|
Normaler Text mit **fett**, *kursiv* und `Code`.
|
|
|
|
- Aufzählung
|
|
- noch ein Punkt
|
|
|
|
1. Nummerierte Schritte
|
|
2. zweiter Schritt
|
|
|
|
[Ein Link](https://example.org)
|
|
|
|
Siehe auch [[anderer-eintrag]].
|
|
```
|
|
|
|
Dazu kommen die Erweiterungen, die man von GitHub oder GitLab kennt:
|
|
|
|
```markdown
|
|
| Umgebung | Adresse |
|
|
|----------|----------------|
|
|
| Test | test.intern |
|
|
| Prod | prod.intern |
|
|
|
|
- [x] erledigt
|
|
- [ ] noch offen
|
|
|
|
~~veraltet~~ — durchgestrichen
|
|
|
|
https://example.org wird ohne Klammern zum Link.
|
|
```
|
|
|
|
Codeblöcke stehen zwischen drei Backticks. Eingebettetes HTML wird aus
|
|
Sicherheitsgründen nicht ausgeführt.
|
|
|
|
### Verweise mit Autovervollständigung
|
|
|
|
Tippe `[[` in das Inhaltsfeld. Munin schlägt passende Einträge vor. Mit den
|
|
Pfeiltasten auswählen und mit Enter oder Tab übernehmen, oder einfach anklicken.
|
|
Eingefügt wird der Bezeichner, nicht der Titel.
|
|
|
|
### Vorschau
|
|
|
|
Über dem Inhaltsfeld wechselst du zwischen **Schreiben** und **Vorschau**. Die
|
|
Vorschau zeigt den Eintrag genau so, wie er nach dem Speichern aussehen wird.
|
|
|
|
### Wenn jemand gleichzeitig ändert
|
|
|
|
Hat jemand anderes (ein Mensch oder ein Agent) den Eintrag geändert, während du
|
|
ihn bearbeitet hast, meldet Munin beim Speichern einen Konflikt, statt die
|
|
fremde Änderung zu überschreiben. Dein Text bleibt im Formular erhalten. Öffne
|
|
den Eintrag in einem zweiten Tab, übernimm dort deine Änderungen in den
|
|
aktuellen Stand und speichere dann dort.
|
|
|
|
## Verlauf und Vergleich
|
|
|
|
In jedem Eintrag führt **Fassung n, Verlauf ansehen** zu allen früheren
|
|
Fassungen. Bei jeder Fassung zeigt **Änderungen ansehen** Zeile für Zeile, was
|
|
sich zur nächsten Fassung geändert hat. So lässt sich nachvollziehen, was ein
|
|
Agent geändert hat.
|
|
|
|
Mit Schreibrecht holt **Wiederherstellen** (im Verlauf oder auf der
|
|
Vergleichsseite) eine alte Fassung mit einem Klick zurück: Titel, Inhalt und
|
|
Schlagworte. Dabei geht nichts verloren — der bisherige Stand wird selbst zu
|
|
einer Fassung im Verlauf, und das Protokoll vermerkt, welche Fassung
|
|
zurückgeholt wurde. Hat jemand den Eintrag geändert, während du den Verlauf
|
|
angesehen hast, wird nichts überschrieben; prüfe dann den neuen Stand und
|
|
versuche es erneut.
|
|
|
|
## Papierkorb
|
|
|
|
**Löschen** legt einen Eintrag in den Papierkorb, egal ob ein Mensch in der
|
|
Oberfläche löscht oder ein Agent über `forget`. Der Eintrag verschwindet sofort
|
|
aus Liste, Suche, Graph und allen Antworten an Agenten. Mit Verlauf und
|
|
Schlagworten bleibt er aber 30 Tage erhalten; danach entfernt Munin ihn
|
|
endgültig.
|
|
|
|
Den Papierkorb findest du mit Schreibrecht in der Seitenleiste. Dort steht zu
|
|
jedem Eintrag, wer ihn wann gelöscht hat:
|
|
|
|
- **Wiederherstellen** holt einen Eintrag unverändert zurück.
|
|
- **Endgültig löschen** entfernt ihn sofort, samt Verlauf. Das ist gedacht für
|
|
Inhalte, die nicht 30 Tage liegen bleiben sollen, etwa ein versehentlich
|
|
abgelegtes Passwort. Rückgängig machen lässt sich das nicht.
|
|
- Ein Klick auf den **Namen eines Zugangs** zeigt nur, was dieser gelöscht hat.
|
|
Hat ein Agent zu gründlich aufgeräumt, holt *Alle … wiederherstellen* alles
|
|
auf einmal zurück.
|
|
|
|
Wer mit Leserecht angemeldet ist, sieht den Papierkorb nicht. Oft wird ein
|
|
Eintrag ja gerade deshalb gelöscht, weil nicht jeder ihn sehen soll.
|
|
|
|
Legst du einen Eintrag mit einem Bezeichner an, der noch im Papierkorb liegt,
|
|
holt Munin den alten Eintrag zurück und überschreibt ihn. Der gelöschte Stand
|
|
steht dann im Verlauf, und ein Hinweis sagt dir, dass das passiert ist.
|
|
|
|
Veraltetes trotzdem lieber überarbeiten als löschen: Überarbeitetes bleibt
|
|
auffindbar, und der Verlauf zeigt, was sich geändert hat.
|
|
|
|
## Viele Einträge auf einmal
|
|
|
|
Mit Schreibrecht hat die Eintragsliste vor jedem Eintrag ein Auswahlkästchen.
|
|
Unter der Liste lassen sich für alle ausgewählten Einträge Schlagworte
|
|
hinzufügen oder entfernen, mehrere durch Komma getrennt. Praktisch, um ein
|
|
Schlagwort umzubenennen: das neue hinzufügen, das alte entfernen.
|
|
|
|
## Import
|
|
|
|
Mit der Rolle `admin` gibt es in der Seitenleiste den Punkt *Import*. Dort
|
|
lässt sich ein ZIP-Archiv mit Markdown-Dateien hochladen. Jede Datei wird ein
|
|
Eintrag. Das passt für drei Fälle:
|
|
|
|
- **Wiederherstellen** aus dem Markdown-Export: das ZIP aus *Als ZIP herunterladen*
|
|
direkt hochladen, oder den Ordner eines Projekts aus dem Exportverzeichnis
|
|
des Servers packen und hochladen. Schlagworte, Autor, Herkunft, Prüfvermerk und
|
|
Änderungsdatum bleiben erhalten.
|
|
- **Umzug** eines Projekts auf einen anderen Server oder in einen anderen
|
|
Workspace, auf demselben Weg.
|
|
- **Vorhandene Dokumentation** übernehmen. Der Bezeichner kommt aus dem
|
|
Dateinamen, der Titel aus der ersten Überschrift `# …`. Unterordner sind
|
|
erlaubt, im Projekt stehen die Einträge danach aber nebeneinander.
|
|
|
|
Gibt es einen Bezeichner schon, wird die Datei entweder **übersprungen**
|
|
(Standard) oder sie **überschreibt** den Eintrag. Beim Überschreiben wandert
|
|
der bisherige Stand in den Verlauf, verloren geht also nichts. Dateien, die
|
|
nichts ändern würden, werden in beiden Fällen nicht geschrieben. Derselbe
|
|
Import lässt sich deshalb gefahrlos wiederholen.
|
|
|
|
**Nur Vorschau** ist beim ersten Hochladen angehakt. Die Tabelle zeigt dann
|
|
für jede Datei, was passieren würde, ohne etwas zu schreiben. Passt alles,
|
|
dasselbe Archiv ohne den Haken noch einmal hochladen.
|
|
|
|
Nicht übernommen wird der Verlauf, denn der Export enthält nur den aktuellen
|
|
Stand. Ein importierter Eintrag beginnt deshalb wieder bei Fassung 1.
|
|
|
|
## Export als ZIP
|
|
|
|
Mit der Rolle `admin` steht über der Eintragsliste der Knopf *Als ZIP
|
|
herunterladen*. Ein Klick lädt alle Einträge des Projekts als ZIP-Archiv herunter: je Eintrag
|
|
eine Markdown-Datei mit allen Feldern im Kopf, dazu eine Übersicht
|
|
`_index.md`. Der Papierkorb und der Verlauf älterer Fassungen sind nicht
|
|
enthalten.
|
|
|
|
Das Archiv passt unverändert in den [Import](#import), in dieses oder ein
|
|
anderes Projekt, auch auf einem anderen Server. Jeder Download steht im
|
|
Protokoll.
|
|
|
|
## Protokoll
|
|
|
|
Unter *Protokoll* in der Seitenleiste steht, wer im Projekt wann etwas
|
|
geschrieben, gelöscht oder sich angemeldet hat.
|