Wikis

Nutzen Sie Wikis, um Teamwissen in Workspace zu sammeln, zu verlinken und kontrolliert freizugeben. Ein Tenant kann mehrere Wikis enthalten, zum Beispiel für Betrieb, Produktwissen oder interne Prozesse.

Wikis sind ein Teil von Wissensmanagement. Nutzen Sie Wikis für dauerhaftes, durchsuchbares Wissen. Nutzen Sie Whiteboards für visuelle Entwürfe und Wissensmanagement > Dateien für allgemeine Unterlagen, die nicht direkt eine Wiki-Seite sind.

Wiki öffnen

  1. Öffnen Sie im Hauptmenü Wissensmanagement > Wikis.
  2. Wählen Sie rechts neben der Überschrift das gewünschte Wiki.
  3. Suchen Sie links in der Navigation nach einem Begriff oder wählen Sie eine Seite im Seitenbaum.
  4. Lesen Sie den Inhalt im Bereich rechts.

Workspace öffnet Wikis standardmäßig im Modus Inhalt. In diesem Modus sehen Sie Suche, Seitennavigation und Text. Bearbeitung, Historie und Zugriff bleiben im Modus Admin erreichbar, sind aber beim normalen Lesen nicht sichtbar.

Nutzen Sie Alle Wikis durchsuchen, um alle Wiki-Seiten zu durchsuchen, die Sie lesen dürfen. Die Treffer zeigen Wiki, Seite, Pfad und einen Ausschnitt. Workspace zeigt keine Seiten aus Wikis oder Seitenfreigaben an, für die Ihnen Leserechte fehlen.

Nutzen Sie Seiten filtern, um den aktuellen Seitenbaum nach Titel, Pfad oder Slug einzugrenzen. Ohne Suchbegriff zeigt Workspace die Seiten wieder als Hierarchie an.

Wenn ein Wiki eine Startseite hat, öffnet Workspace diese Seite beim Wechsel in das Wiki zuerst. Die Seitennavigation markiert die Startseite.

Wiki oder Seite anlegen

  1. Nutzen Sie rechts neben der Überschrift Erstellen, um ein neues Wiki anzulegen.
  2. Wählen Sie das Wiki über die Wiki-Auswahl neben der Überschrift.
  3. Nutzen Sie links in der Navigation Seite erstellen.
  4. Geben Sie einen Titel ein.
  5. Wählen Sie, ob die Seite auf oberster Ebene oder unter einer bestehenden Seite angelegt wird.
  6. Erstellen Sie die Seite.

Workspace legt Seiten mit vererbtem Zugriff an. Passen Sie die Freigaben im Modus Admin unter Zugriff an, wenn eine Seite eigene Rechte braucht.

Inhalt bearbeiten

  1. Öffnen Sie eine Seite.
  2. Wechseln Sie in den Modus Bearbeiten.
  3. Wählen Sie das Inhaltsformat.
  4. Wählen Sie, ob die Revision Datenbankinhalt oder ein Storage-Objekt nutzt.
  5. Bearbeiten Sie den Markdown-Inhalt oder die strukturierten Blöcke.
  6. Prüfen Sie die Vorschau.
  7. Speichern Sie die Seite.

Jedes Speichern erzeugt eine neue Revision und erneuert den Render-Cache. Ändern Sie Seitentitel oder Pfad über Umbenennen. Bestehende Wiki-Links bleiben über die interne Seitenidentität stabil, auch wenn sich Pfade ändern.

Workspace erstellt Vorschau, Linkstatus und Inhaltsübersicht serverseitig. Das Frontend zeigt den API-Zustand an und speichert erst, nachdem die API den Draft validiert hat. Dadurch sehen Nutzer und eigene API-Clients dieselben erlaubten Formate, dieselbe Validierung und dieselbe gerenderte Vorschau.

Wenn Sie zwischen Markdown und Blöcke wechseln, konvertiert Workspace den vorhandenen Inhalt nicht automatisch. Leere Drafts erhalten ein passendes Starttemplate aus der API. Bestehender Inhalt bleibt unverändert und muss zum gewählten Format passen.

Wählen Sie bei Übergeordnete Seite eine neue Position in der Seitenhierarchie und nutzen Sie Seite verschieben, um eine bestehende Seite neu einzuordnen. Workspace verhindert, dass eine Seite unter sich selbst oder unter eigenen Unterseiten einsortiert wird.

Setzen Sie die geöffnete Seite über Als Startseite setzen als Einstiegspunkt des Wikis. Workspace speichert die Startseite am Wiki und nutzt sie beim nächsten Öffnen des Wikis.

Strukturieren Sie längere Seiten mit Markdown-Überschriften wie #, ## und ###. Workspace rendert daraus stabile Abschnittsanker und zeigt in der Vorschau eine Inhaltsübersicht, über die Sie direkt zu einem Abschnitt springen.

Nutzen Sie im Rich-Text-Editor die Tabellenaktion, wenn Sie Inhalte vergleichen oder in Zeilen und Spalten pflegen möchten. Wählen Sie die Tabellengröße im Raster aus und fügen Sie die Tabelle ein. Bearbeiten Sie bestehende Tabellen direkt im Editor per Rechtsklick: Fügen Sie Zeilen oder Spalten ein, setzen Sie Kopfzeilen und Kopfspalten, ändern Sie Zellhintergründe oder verbinden Sie Zellen. Workspace speichert Tabellen in Markdown-Seiten als sicheres HTML. Wiki-Links in Tabellenzellen bleiben dabei auswertbar.

Löschen Sie eine Seite über Seite löschen, wenn Sie Eigentümerin oder Eigentümer der Seite sind. Workspace fragt vor dem Löschen nach einer Bestätigung und lädt danach die Seitenliste neu.

Öffnen Sie im Modus Admin den Tab Historie, um gespeicherte Revisionen der Seite zu sehen. Die Liste zeigt die neueste Revision zuerst, markiert die aktuelle Revision und nennt Format, Speicherart und Zusammenfassung. Stellen Sie eine ältere Revision über Wiederherstellen wieder her. Workspace legt dafür eine neue aktuelle Revision an und überschreibt die bestehende Historie nicht.

Inhalte aus Storage-Objekten nutzen

Wiki-Revisionen können Inhalte direkt in der Datenbank speichern oder auf ein Storage-Objekt verweisen. Storage-Objekt-Revisionen eignen sich für größere Markdown- oder Block-JSON-Inhalte, die über den bestehenden Storage-Lebenszyklus verwaltet werden.

  1. Öffnen Sie eine Seite.
  2. Wechseln Sie in den Modus Admin und öffnen Sie Bearbeiten.
  3. Wählen Sie Storage-Objekt als Inhaltsspeicher.
  4. Wählen Sie das Inhaltsformat.
  5. Wählen Sie ein bestehendes Storage-Objekt aus oder tragen Sie die Storage-Objekt-ID manuell ein.
  6. Nutzen Sie Hash laden, damit die API das Storage-Objekt liest und den erwarteten Content-Hash zurückgibt.
  7. Speichern Sie die Revision.

Der Server rendert Storage-Objekt-Inhalte wie Datenbankinhalte: Er prüft den Hash, liest nur Objekte aus demselben Tenant, indexiert Wiki-Links und speichert die gerenderte HTML-Ansicht im Render-Cache. Wenn sich der Storage-Inhalt ändert, legen Sie eine neue Wiki-Revision mit dem neuen Hash an.

Notebookartige Blöcke nutzen

Wählen Sie Blöcke, wenn eine Seite aus mehreren notebookartigen Abschnitten bestehen soll. Workspace zeigt die Blocktypen an, die die API für diese Seite erlaubt. Codeblöcke werden angezeigt, aber nicht ausgeführt.

Nutzen Sie im Block-Modus den Tab Zellen. Dort fügen Sie Markdown, Text, Lua-Code, Ausgabe und Hinweis als einzelne Zellen ein. Bearbeiten Sie jede Zelle mit Typ, Titel, Sprache und Inhalt. Verschieben oder löschen Sie Zellen direkt in der Liste. Workspace synchronisiert die Zellenansicht mit dem gespeicherten Block-JSON im Tab Quelle.

Wenn Sie eine bestehende Markdown-Seite auf Blöcke umstellen, schreibt Workspace den Inhalt nicht automatisch um. Nutzen Sie Markdown übernehmen, um den aktuellen Markdown-Inhalt ausdrücklich als erste Markdown-Zelle zu übernehmen. Speichern Sie danach nur, wenn die Seite künftig als Blockseite geführt werden soll.

Wenn das Block-JSON ungültig ist, korrigieren Sie es im Tab Quelle. Die Zellenansicht überschreibt ungültiges JSON nicht still.

Beispiel:

json
{
  "version": 1,
  "blocks": [
    { "type": "markdown", "body": "## Analyse\n\nSiehe [[Kennzahlen]]." },
    { "type": "code", "language": "lua", "body": "return 1" },
    { "type": "output", "body": "Gespeicherte Ausgabe" }
  ]
}

Speichern Sie nur Inhalte, die als Anzeige oder gespeicherte Ausgabe gedacht sind. Lua-, JavaScript-, Python- oder andere Codeblöcke laufen in diesem Schnitt nicht.

API für eigene Frontends nutzen

Eigene Frontends müssen die Authoring-Regeln nicht nachbauen. Lesen Sie zuerst die Client-Meta der Seitenressource oder die OpenAPI-Dokumentation und nutzen Sie dann die Wiki-Authoring-Endpunkte:

  • GET /api/v1/wikis/{wikiId}/pages/{pageId}/revisions/_authoring liefert erlaubte Inhaltsmodi, Blocktypen und Aktionen.
  • POST /api/v1/wikis/{wikiId}/pages/{pageId}/revisions/_prepare erstellt ein passendes Draft-Template oder validiert ein Storage-Objekt und liefert den Hash.
  • POST /api/v1/wikis/{wikiId}/pages/{pageId}/revisions/_validate prüft den Draft mit derselben Logik wie das Speichern.
  • POST /api/v1/wikis/{wikiId}/pages/{pageId}/revisions/_preview rendert Vorschau, Linkstatus und Inhaltsübersicht ohne Revision zu speichern.
  • POST /api/v1/wikis/{wikiId}/pages/{pageId}/revisions bleibt der einzige Endpunkt, der eine neue Inhaltsrevision schreibt.

Alle Endpunkte prüfen Tenant, Authentifizierung und Seitenrechte. Prepare, Validate und Preview erstellen keine Revision und ändern keinen Render-Cache.

Schreiben Sie Seitenlinks im Format [[Seitentitel]]. Die Vorschau macht diese Links klickbar. Workspace löst den Link serverseitig über den aktuellen Pfad oder frühere Alias-Einträge auf, damit umbenannte Seiten weiter erreichbar bleiben.

Nutzen Sie im Schreibmodus den Link-Button des Editors. Geben Sie eine URL ein, um einen normalen Link zu setzen, oder wählen Sie eine Wiki-Seite, um einen Wiki-Link zu erzeugen. Wenn Sie [[ tippen, öffnet der Wiki-Editor zusätzlich eine Seitensuche direkt an der Cursorposition.

Im Tab Quelle und im Blockmodus steht der separate Bereich Links weiter zur Verfügung. Dort wählen Sie unter Linkziel eine vorhandene Seite und nutzen Link einfügen, um [[...]] an der aktuellen Cursorposition einzusetzen. Im Blockmodus fügt Workspace den Link in das aktive Block-Inhaltsfeld ein und aktualisiert Block-JSON und Vorschau.

Im Modus Admin sehen Sie unter Bearbeiten im Bereich Wiki-Links, welche Links für die aktuelle Revision aufgelöst sind und welche Zielseiten noch fehlen. Aufgelöste Einträge zeigen Zielseite und Pfad. Fehlende Einträge behalten die normalisierte Zielreferenz und bieten Seite anlegen, damit Sie das Linkziel direkt aus dem Schreibfluss heraus erstellen können.

Der Bereich Backlinks im Modus Admin zeigt Seiten, die auf die geöffnete Seite verweisen. Workspace zeigt nur Quellseiten, die Sie lesen dürfen, und öffnet diese Seiten direkt aus der Backlink-Liste.

Zugriff steuern

  1. Wechseln Sie in den Modus Admin.
  2. Öffnen Sie den Tab Zugriff.
  3. Wählen Sie bei Seiten den Zugriffsmodus.
  4. Verwenden Sie Wiki-Zugriff erben, wenn die Seite die Wiki-Freigaben nutzen soll.
  5. Verwenden Sie Nur Seitenfreigaben verwenden, wenn nur direkte Seitenfreigaben gelten sollen.
  6. Verwalten Sie direkte Freigaben für das Wiki oder für die ausgewählte Seite.
  7. Wählen Sie Person oder Gruppe.
  8. Wählen Sie eine Rolle wie Lesen, Bearbeiten oder Eigentümer.
  9. Gewähren oder entziehen Sie die Freigabe.

Seiten erben den Wiki-Zugriff, solange sie keinen eigenen Zugriffsmodus verwenden. Entfernen Sie nicht die letzte Eigentümer-Freigabe.

Grenzen dieses Schnitts

Workspace migriert bestehende Wiki-Inhalte nicht automatisch zwischen Markdown und Blöcken. Skripte, ausführbare Notebook-Zellen und Importe aus externen Wikis gehören nicht zu diesem Authoring-Schnitt.

Nutzen Sie Wikis nicht als lose Dateiablage. Legen Sie eigenständige Dateien in Wissensmanagement > Dateien oder im Dateien-Tab des passenden Fachdatensatzes ab und verlinken Sie sie aus der Wiki-Seite, wenn sie zum Inhalt gehören.

Nächste Schritte