Handbuch:Erweiterung/ExternalContent: Unterschied zwischen den Versionen

Version vom 28. Januar 2026, 08:43 Uhr

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[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

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[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.

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

@@ Zeile 9: / Zeile 9: @@
 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. [[Datei:externe Vorlage kopieren und einfügen.png|alt=Menü zum Hinzufügen von Linkparametern öffnen|center|thumb|650x650px|Direktes Einfügen einer GitHub-URL in den visuellen Editor.]]
+{| class="wikitable"
+|+
+!Parameter
+!Beschreibung
+|-
+|URL
+|Externer Speicherort der eingebetteten Datei
+|-
+|Sprache des eingebetteten Inhalts
+|Eine der [https://prismjs.com/#supported-languages 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 das entsprechende Inhalts-Droplet auswählen:
+Um einen GitHub- oder Bitbucket-Link einzubetten, können Sie alternativ auch das entsprechende [[Handbuch:Erweiterung/ContentDroplets|Inhalts-Droplet]] auswählen:
 * Externer Inhalt (für GitHub)
 * Bitbucket-Datei
-[[Datei:Externer Inhalt – Bitbucket-Datei.png|alt=12 Codezeilen aus einer öffentlichen Bitbucket-Datei|center|thumb|650x650px|Bitbucket-Inhalt]]
+[[Datei:Externer Inhalt – Bitbucket-Datei.png|alt=12 Codezeilen aus einer öffentlichen Bitbucket-Datei|center|thumb|650x650px|Bitbucket-Inhalt]]{{Textbox|boxtype=important|header=Fehlermeldungen:|text=Falls nach dem Einbetten einer Bitbucket oder GitHub Datei eine Fehelrmeldung erscheint, kann es sein, dass in der [[#Konfiguration von erlaubten externen Inhalten|Konfigurationsverwaltung]] spezielle Domains für die Einbettung definiert wurden. Diese müssen dann entsprechend angepasst werden.|icon=yes}}
 == Konvertierung eines externen Links unterdrücken ==
-Wenn Sie stattdessen einen Link zur externen Seite veröffentlichen möchten, müssen Sie die URL in das Menü „Link einfügen“ einfügen. Nach dem Hinzufügen des Links können Sie eine Beschriftung hinzufügen, da externe Links, die über das Menü „Link einfügen“ erstellt werden, nicht automatisch die vollständige URL oder eine Linkbeschriftung anzeigen.
+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 <code>Strg+Umschalt+V</code>.
-[[File:external content github link.png|alt="Menü "Link einfügen" mit Link zu GitHub-Inhalten|center|thumb|750x750px|Link zu GitHub-Inhalten]]
 == Konfiguration von erlaubten externen Inhalten ==
-In der [[Handbuch:Erweiterung/BlueSpiceConfigManager#BlueSpiceProDistributionConnector|Konfigurationsverwaltung,]] unter BlueSpiceProDistributionConnector, können die Domains und Dateitypen für das Einbetten von Inhalten im Wiki erweitert oder eingeschränkt werden.
+In der [[Handbuch:Erweiterung/BlueSpiceConfigManager#BlueSpiceProDistributionConnector|Konfigurationsverwaltung,]] unter <code>BlueSpiceProDistributionConnector</code>, können die Domains und Dateitypen für das Einbetten von Inhalten im Wiki erweitert oder eingeschränkt werden.
 {{#dpl:|title=Handbuch:Erweiterung/BlueSpiceConfigManager|include=#Editor (Externer Inhalt)}}