Extension/ExternalContent

bsvFeature::ChatBot is available from BlueSpice bsvFrom::5.2. This extension has multiple prerequesites before it is available to users in a wiki.

The ExternalContent extension allows for embedding external content, such as markdown files, in your wiki pages. The standard configuration allows embedding links from GitHub and Bitbucket.

Embedding external content

Copy and paste

In visual editing mode, you can simply copy the url to your clipboard and paste it into the wiki page in visual editing mode. The visual editor will automatically convert the url to an embedded view of the actual external content.


Parameter	Description
URL	External location of the embedded file.
Language of embedded content	One of the supported languages . Only required if the language is not detected by the file extension.
Lines to show	Show only specific lines. This can be a single line number or a range separated by a hyphen (-). Multiple line numbers or ranges can be separated by commas.
Show line numbers	Displays the line numbers of the embedded block.

Content Droplet

To embed a GitHub or Bitbucket link, you can also select the related Content Droplet:

External content (for GitHub)
Bitbucket file

Error messages:If an error message appears after embedding a Bitbucket or GitHub file, it may be that specific domains for embedding have been defined in the Configuration management. These must then be adjusted accordingly.

Suppressing the conversion of an external link

If you want to create a link to the external page instead of embedding it, you must copy the URL into the page as plain text (e.g., using the keyboard shortcut Ctrl+Shift+V).

Configuring allowed external content

In the configuration manager, you can restrict the domains and file types that can be embedded in the wiki:

{{#dpl:|title=Manual:Extension/BlueSpiceConfigManager|include=#Editor (External content)}}