Handbuch:Erweiterung/ExternalContent: Unterschied zwischen den Versionen

Versionsgeschichte interaktiv durchsuchen

Aktuelle Version vom 28. Januar 2026, 09:04 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 1: / Zeile 1: @@
-{{BSVersion|bsvFrom=5.2|bsvFeature=ChatBot|info=Diese Erweiterung erfordert mehrere Voraussetzungen, bevor sie für Nutzer in einem Wiki verfügbar ist.}}
+{{BSVersion|bsvFrom=5.2|bsvFeature=ExternalContent|info=Diese Erweiterung erfordert mehrere Voraussetzungen, bevor sie für Nutzer in einem Wiki verfügbar ist.}}
-== Eine Unterhaltung starten ==
+Die Erweiterung  '''ExternalContent''' ermöglicht das Einbetten externer Inhalte wie Markdown-Dateien in Ihre Wiki-Seiten.
-Wenn der Chatbot im Wiki aktiviert ist, bietet die Benutzeroberfläche einen Chat-Assistenten, der Fragen zu Ihrem Wiki beantworten kann. Klicken Sie unten auf der Seite auf die Schaltfläche „Chat“, um den Chat zu öffnen.
-[[File:chatbot button.png|alt=Chatbot-Schaltfläche|center|thumb|134x134px|Chatfenster öffnen]]
-== Das Chatfenster ==
+== Externe Inhalte einbetten ==
-[[File:Chatbot window.png|alt=Einführungsseite des BlueSpice-Benutzerhandbuchs mit geöffnetem Chatfenster.|center|thumb|750x750px|Chatbot-Fenster]]Das Chatfenster bietet folgende Hauptfunktionen:
+Die Standardkonfiguration erlaubt das Einbetten von Links aus GitHub und Bitbucket. Zusätzliche Domains und erlaubte Datei-Erweiterungen können [[Handbuch:Erweiterung/ExternalContent#Konfiguration von erlaubten externen Inhalten|vom Wiki-Admin konfiguriert werden]].
-* '''(1) Schaltflächen zum Ändern der Chatgröße oder Schließen:'''
-** ''Größe des Chats ändern:'' Die Größe des Chatfensters lässt sich in drei Stufen einstellen.
-** ''Chat minimieren:'' Das Chatfenster wird ausgeblendet, aber nicht geschlossen. Ein erneuter Klick auf die Chat-Schaltfläche stellt die aktuelle Sitzung wieder her.
-** ''Chat schließen und Chatverlauf löschen:'' Das Chatfenster wird geschlossen und der Chatverlauf der Sitzung gelöscht.
-* '''(2) Frage mit Zeitstempel:''' Sobald eine Konversation durch Senden aus dem Nachrichtenbereich gestartet wurde, erscheint die Frage mit einem Zeitstempel im Chatfenster.
-* Antwort auf die Frage mit den folgenden Elementen:
-** '''(3) Antworttext'''
-** '''(4) Ressourcen:''' Die als Datenquelle verwendeten Seitenverweise
-** '''(5) Schaltflächen zum Kopieren der Antwort''' in die Zwischenablage oder zum Speichern als Wiki-Seite (als Unterseite der Profilseite des aktuellen Benutzers, z. B. <code>Benutzer:WikiSysop/Bot/...</code>)
-* '''(6) Vorgeschlagene Folgefragen'''
-* '''(7) Nachrichtenbereich'''
-* (8) '''Umschalter''' zum Anzeigen oder Verstecken des Chatfensters
-== Suchintegration ==
+=== Kopieren und Einfügen ===
-Im  [[Handbuch:Erweiterung/BlueSpiceExtendedSearch|Suchcenter]]  wird den Suchergebnissen nun eine Zusammenfassung des Chatbots vorangestellt.
-[[Datei:Suchcenter KI-Zusammenfassung .png|alternativtext=KI-generierter Text zum Suchbegriff PDF-Layout|zentriert|mini|650x650px|Suchcenter KI-Zusammenfassung]]
-== Seiten als Datenquelle ausschließen ==
+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.
-'''So schließen Sie eine Seite als Datenquelle für den Chatbot aus:'''
+|-
+|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.
+|}
-# '''Klicken Sie''' in der Symbolleiste des visuellen Editors auf das Menü ''Optionen''. [[File:VE page options menu item.png|alt=Options menu of VisualEditor|center|thumb|150x150px|Page options menu]]
+=== Inhalts-Droplet ===
-# '''Klicken Sie''' auf ''Erweiterte Einstellungen''.
+Um einen GitHub- oder Bitbucket-Link einzubetten, können Sie alternativ auch das entsprechende [[Handbuch:Erweiterung/ContentDroplets|Inhalts-Droplet]] auswählen:
-# '''Klicken Sie''' nach der Beschriftung ''Kann für ChatBot indexiert werden'' auf ''Nein, nicht indexieren''. Benutzer können diese Anforderung in der Symbolleiste des visuellen Editors unter Optionen > Erweiterte Optionen aktivieren.
-Dadurch wird der Verhaltensumschalter <code>__NO_RAG_EXPORT__</code> zur Seitenquelle hinzugefügt.
+* Externer Inhalt (für GitHub)
-== Konfigurationsmanager ==
+* Bitbucket-Datei
-Benuzter mit Adminrechten  können den Namen des Bots, der am Anfang des Chatfensters angezeigt wird, im [[Handbuch:Erweiterung/BlueSpiceConfigManager|Konfigurationsmanager]] unter der Erweiterung ''ChatBot'' konfigurieren.
+[[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 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>.
+== Konfiguration von erlaubten externen Inhalten ==
+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)}}
+{{translation}}