Handbuch:Erweiterung/ExternalContent

ExternalContent ist ab BlueSpice 5.2 enthalten. Diese Erweiterung erfordert mehrere Voraussetzungen, bevor sie für Nutzer in einem Wiki verfügbar ist.

Die Erweiterung ExternalContent ermöglicht das Einbetten externer Inhalte wie Markdown-Dateien in Ihre Wiki-Seiten.

Externe Inhalte einbetten

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

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.

Direktes Einfügen einer GitHub-URL in den visuellen Editor.

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

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

Bitbucket-Inhalt

Fehlermeldungen:

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

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

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.

Wichtig!

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.

Technische Referenz: ExternalContent

Ein Uniform Resource Locator (Abk. URL; englisch für „einheitlicher Ressourcenverorter“) identifiziert und lokalisiert eine Ressource, beispielsweise eine Webseite, über die zu verwendende Zugriffsmethode (zum Beispiel das verwendete Netzwerkprotokoll wie HTTP oder FTP) und den Ort (englisch location) der Ressource in Computernetzwerken.