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 linke Seitennavigation zeigt den Seitentitel. Fehlt ein Titel, nutzt Workspace Pfad oder Slug als Fallback.

Die Browser-Adresse enthält das aktuell geöffnete Wiki und die aktuelle Seite. Kopieren Sie die Adresse, wenn Sie einen direkten Link auf diese Wiki-Seite weitergeben möchten.

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.

Dateien und Bilder einfügen

Kopieren Sie ein Bild oder eine Datei in die Zwischenablage und fügen Sie sie im Rich-Text-Editor, im Markdown-Quelltext oder in einer Markdown-Zelle ein. Workspace lädt mehrere Dateien nacheinander hoch und setzt jede Referenz an der aktuellen Schreibposition ein. Bilder erscheinen direkt in der Seite, andere Dateien als Link. Der vom Server erkannte Dateityp entscheidet über die Darstellung; die Dateiendung oder die Schreibweise im Editor ist dafür nicht maßgeblich.

Im Markdown-Quelltext sehen Sie für eine eingefügte Datei eine Referenz mit nucleus-attachment:. Lassen Sie die darin enthaltene ID unverändert. Die gespeicherte Wiki-Revision verknüpft diese Referenz mit dem Dateiobjekt und liefert sie über die aktuelle Wiki-Seite aus.

Für den Upload brauchen Sie Bearbeitungszugriff auf die Seite und Schreibrecht auf den für Wikis konfigurierten Dateiablageort. Fehlt die Wiki-Konfiguration, verwendet Workspace den konfigurierten Standard-Dateiablageort. Ist auch dieser nicht nutzbar, zeigt der Editor einen Fehler. Das gilt ebenfalls bei fehlenden Rechten, ausgeschöpftem Speicherplatz oder blockierten Dateitypen.

Nach dem Speichern folgt das Lesen der Wiki- und Seitenfreigabe. Wer die aktuelle Seite lesen darf, kann ihre verknüpften Dateien öffnen, auch wenn die ursprüngliche Datei-Freigabe enger war. Entfernen Sie eine Referenz aus einer neuen Revision, liefert die aktuelle Wiki-Seite diese Datei nicht mehr aus. Ältere Revisionen bleiben in der Historie erhalten.

Der Editor weist nach dem Einfügen darauf hin, dass die Datei nach dem Speichern der Sichtbarkeit der Wiki-Seite folgt.

Workspace lädt nur echte Dateien aus der Zwischenablage hoch. Es ruft keine Bildadresse aus kopiertem HTML automatisch ab. Wenn Sie einen Entwurf nach dem Upload verwerfen, bleibt die hochgeladene Datei gemäß dem konfigurierten Storage-Lebenszyklus bestehen.

Diagramme einfügen

Nutzen Sie DOT-Diagramme, wenn Sie Abläufe, Abhängigkeiten oder einfache Prozessbilder direkt in einer Wiki-Seite pflegen möchten. Workspace rendert DOT serverseitig als bereinigtes SVG und speichert die gerenderte Ansicht mit der Revision im Render-Cache. Beim Lesen lädt Workspace diese gespeicherte Ansicht, statt das Diagramm bei jedem Öffnen neu zu berechnen.

Fügen Sie ein Diagramm in Markdown als Codeblock mit der Sprache dot oder graphviz ein:

Im Block-Modus wählen Sie den Blocktyp DOT-Diagramm und tragen den DOT-Inhalt in die Zelle ein. Speichern Sie die Revision erst, wenn die Vorschau das Diagramm erfolgreich rendert.

Workspace entfernt Skripte, Event-Handler, eingebettetes HTML und externe Ressourcen aus dem erzeugten SVG. Nutzen Sie Diagramme für Visualisierung, nicht für interaktive Inhalte.

Markieren Sie Text im Rich-Text-Editor, um die kompakte Werkzeugleiste für Fett, Kursiv, Unterstrichen, Link und Wiki-Link zu nutzen. Die Haupttoolbar bleibt verfügbar.

Richten Sie Fließtext und Tabellenzellen linksbündig, zentriert, rechtsbündig oder im Blocksatz aus. Workspace übernimmt die Ausrichtung in Vorschau und Lesemodus.

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 Zellschriftfarben und verbinden Sie Zellen. Tabellen behalten im Editor, in der Vorschau und im Lesemodus sichtbare Zellgrenzen. Kopfzellen erscheinen dort fett und mit abgesetztem Hintergrund. 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.

Checklisten und Checkboxen nutzen

Fügen Sie im Rich-Text-Editor eine Checkbox ein, wenn ein Prüfschritt direkt auf der Wiki-Seite abgehakt werden soll. Workspace speichert jede Checkbox mit stabiler ID. Im Lesemodus können Nutzer mit Bearbeitungsrecht die Checkbox anhaken oder abhaken, ohne eine neue Inhaltsrevision zu erzeugen.

Wenn Sie eine Checkbox in einem Listenpunkt verwenden, setzt Enter die Liste als nächsten Checklistenpunkt fort. Workspace fügt nach der Checkbox ein Leerzeichen ein, damit Sie direkt weiterschreiben können.

Fahren Sie im Lesemodus mit der Maus über eine Checkbox, um den aktuellen Status zu sehen. Bei gesetztem Haken zeigt der Tooltip, welche Identity den Haken wann gesetzt hat.

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 und Aktionen an, die Ihre Rechte für diese Seite erlauben. Lua-Codeblöcke können Sie direkt im Entwurf ausführen; andere Codeblöcke dienen nur der Anzeige.

Nutzen Sie im Block-Modus den Tab Zellen. Dort fügen Sie Markdown, Text, Lua-Code, DOT-Diagramm, 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:

{
  "version": 1,
  "blocks": [
    { "type": "markdown", "body": "## Analyse\n\nSiehe [[Kennzahlen]]." },
    { "type": "code", "language": "lua", "body": "return 1" },
    { "type": "dot", "body": "digraph workflow {\n  start -> freigabe\n}" },
    { "type": "output", "body": "Gespeicherte Ausgabe" }
  ]
}

Lua-Code im Entwurf ausführen

Für die Aktion brauchen Sie Bearbeitungszugriff auf die Seite und das Recht wiki_pages:execute. Ist beides vorhanden, zeigt ein Lua-Codeblock die Aktion Lua-Block ausführen.

1. Öffnen Sie eine blockbasierte Wiki-Seite im Modus Admin und wählen Sie Bearbeiten.
2. Fügen Sie einen Codeblock mit der Sprache lua ein oder öffnen Sie einen vorhandenen Lua-Codeblock.
3. Wählen Sie Lua-Block ausführen.
4. Prüfen Sie Lua-Ergebnis, Lua-Fehler oder Lua-Timeout direkt unter dem Block.

Die Ausführung verwendet den aktuellen Entwurf und erzeugt keine Revision. Das Ergebnis bleibt nur im Editor sichtbar und wird verworfen, sobald Sie den Blockinhalt ändern. Workspace speichert weder das Ergebnis noch Änderungen an Wiki-Seiten, Linkindex, Render-Cache oder Fachdaten.

Die Sandbox stellt nur reduzierte Lua-Grundfunktionen sowie String-, Mathematik- und Tabellenfunktionen bereit. Datei-, Betriebssystem-, Paket-, Debug- und Backendzugriffe sind gesperrt. Laufzeit, Codegröße und Ausgabe sind begrenzt. JavaScript, Python und andere Sprachen werden nicht ausgeführt.

Lua lässt sich in diesem Schnitt nur aus blockbasierten Entwürfen ausführen, deren Inhalt in der Datenbank liegt. Storage-Objekt-Inhalte und gespeicherte Ausgabeblöcke werden nicht als Programm ausgeführt.

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/_execute-lua führt einen ausgewählten Lua-Codeblock aus dem blockbasierten Entwurf transient aus.
• POST /api/v1/wikis/{wikiId}/pages/{pageId}/revisions bleibt der einzige Endpunkt, der eine neue Inhaltsrevision schreibt.
• GET /api/v1/wikis/{wikiId}/pages/{pageId}/checkboxes liest den gespeicherten Checkbox-Status einer Seite.
• PUT /api/v1/wikis/{wikiId}/pages/{pageId}/checkboxes/{checkboxId} aktualisiert eine Checkbox ohne neue Inhaltsrevision.

Alle Endpunkte prüfen Tenant, Authentifizierung und Seitenrechte. Prepare, Validate, Preview, Lua-Ausführung und Checkbox-Updates erstellen keine Inhaltsrevision.

Wiki-Links schreiben

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.

Workspace normalisiert sichtbare Wiki-Link-Beschriftungen beim Speichern. Dadurch bleiben manuell geschriebene [[...]]-Links auch nach mehreren Speichervorgängen stabil.

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.

Tippen Sie @, wenn eine konkrete Person die Wiki-Änderung prüfen oder beantworten soll. Workspace speichert ausgewählte Erwähnungen strukturiert und zeigt ungelesene persönliche Wiki-Erwähnungen im Dashboard unter Handlungsbedarf sowie im Profil-Tab Erwähnungen, sofern die erwähnte Person die Wiki-Seite lesen darf. Persönliche Benachrichtigungseinstellungen steuern nur, ob Workspace zusätzlich eine E-Mail-, Matrix- oder App-Zustellung auslöst.

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. Persistente Notebook-Ausgaben, ausführbare Sprachen außer Lua 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

• Ordnen Sie Wissensmanagement-Funktionen mit Wissensmanagement ein.
• Arbeiten Sie Kommentare und Hinweise mit Zusammenarbeit, Kommentare und Hinweise.
• Konfigurieren Sie Storage für Wissensdateien mit Dokumente und Storage.
• Klären Sie Wiki- und Seitenfreigaben mit Quickstart: Benutzer und Rechte prüfen.