Die Erweiterung ExternalContent ermöglicht das Einbetten externer Inhalte wie Markdown-Dateien in Ihre Wiki-Seiten.
Externe Inhalte einbetten[Bearbeiten | Quelltext bearbeiten]
Die Standardkonfiguration erlaubt das Einbetten von Links aus GitHub und Bitbucket. Zusätzliche Domains und erlaubte Datei-Erweiterungen können vom Wiki-Admin konfiguriert werden.
Kopieren und Einfügen[Bearbeiten | Quelltext bearbeiten]
Im visuellen Bearbeitungsmodus können Sie die URL einfach in die Zwischenablage kopieren und in die Wiki-Seite einfügen. Der visuelle Editor wandelt die URL automatisch in eine eingebettete Ansicht des externen Inhalts um.
| Parameter | Beschreibung |
|---|---|
| URL | Externer Speicherort der eingebetteten Datei |
| Sprache des eingebetteten Inhalts | Eine der unterstützten Sprachen. Nur erforderlich, wenn die Sprache nicht anhand der Dateierweiterung erkannt wird. |
| Anzuzeigende Zeilen | Nur bestimmte Zeilen anzeigen. Dies kann eine einzelne Zeilennummer oder ein durch einen Bindestrich (-) getrennter Bereich sein. Mehrere Zeilennummern oder Bereiche können durch Kommas getrennt werden. |
| Zeilennummern anzeigen | Zeigt die Zeilennummern des eingebetteten Blocks an. |
Inhalts-Droplet[Bearbeiten | Quelltext bearbeiten]
Um einen GitHub- oder Bitbucket-Link einzubetten, können Sie alternativ auch das entsprechende Inhalts-Droplet auswählen:
- Externer Inhalt (für GitHub)
- Bitbucket-Datei
Falls nach dem Einbetten einer Bitbucket oder GitHub Datei eine Fehelrmeldung erscheint, kann es sein, dass in der Konfigurationsverwaltung spezielle Domains für die Einbettung definiert wurden. Diese müssen dann entsprechend angepasst werden.
Konvertierung eines externen Links unterdrücken[Bearbeiten | Quelltext bearbeiten]
Wenn Sie statt der Einbettung einen Link zur externen Seite erstellen möchten, müssen Sie die URL als Klartext in die Seite kopieren (z.B. über die Tastenkombination Strg+Umschalt+V.
Konfiguration von erlaubten externen Inhalten[Bearbeiten | Quelltext bearbeiten]
In der Konfigurationsverwaltung, unter BlueSpiceProDistributionConnector, können die Domains und Dateitypen für das Einbetten von Inhalten im Wiki erweitert oder eingeschränkt werden.
Enthalten ab v5.2+.
- Domain whitelist: Liste der Domains, deren Inhalte im Wiki eingebettet werden können. Wenn keine Domains definiert sind, gibt es keine Domain-Einschränkung.
Für Github-Inhalte müssen Sie hier raw.githubusercontent.com erlauben.
- Field extension whitelist: Liste der Datei-Erweiterungen, die aus externen Inhalten im Wiki eingebettet werden können.
