Handbuch:Erweiterung/BlueSpiceTagCloud

Die Erweiterung BlueSpiceTagCloud erstellt Wortwolken für Kategorien oder Suchstatistiken. Eine Wortwolke (englisch: tag cloud) visualisiert Schlagwörter aus dem Wiki basierend auf Wichtigkeit. Sie kann auf jeder Wikiseite eingebunden werden.

Datei:Handbuch:tagcloud-example.png

Einbinden einer Wortwolke

Eine Wortwolke kann direkt in der Quelltextbearbeitung über das Tag <bs:tagcloud />

eingefügt werden. Um die Wortwolke über VisualEditor einzufügen, gehen Sie auf Einfügen > Magisches Wort > Tag Cloud.

Konfiguration

Wenn ein Tag mit dem VisualEditor hinzugefügt wird, erscheint nach dem Einfügen ein Konfigurationsdialog. Es zeigt Konfigurationsoptionen in zwei Registerkarten: Allgemein und Erweitert.

Datei:Handbuch:tagcloud2.png

Allgemeine Konfiguration

Parameter	Anzeigename	Beschreibung
renderer	Typ	Modus zum Rendern der Cloud Liste Text - die Schriftgröße hängt von der Häufigkeit ab 3D - rotierende, interaktive Ansicht
width	Breite	Breite der Cloud in % oder px (z.B., 50%, 200px)
showcount	Anzahl anzeigen	Gibt an, ob die numerische Häufigkeit des Begriffs angezeigt wird

Erweiterte Konfiguration

Parameter	Anzeigename	Beschreibung
store	Datenbasis	Quelle der Daten (category oder searchstats)
minsize	Min. Schriftgröße	Kleinstmögliche Schriftart
maxsize	Maximale Schriftgröße	Größtmögliche Schriftart
exclude	Seiten ausschließen	Liste der Kategorien, die von der Cloud ausgeschlossen werden sollen, durch Komma getrennt - "Kategorie1, Kategorie2, Kategorie3"

Beispiele

Text

Tag und Parameter:

<bs:tagcloud count="10" minsize="12" maxsize="34" exclude="Logo" />

Ergebnis:

Zeigt eine Wortwolke mit den 10 (Anzahl) Kategorien, die am meisten verknüpft sind. Die kleinstmögliche Schriftgröße beträgt 12 Pixel (minsize) und die größtmögliche Schriftgröße 34 Pixel. Die Kategorie Logo wird von der Ausgabe ausgeschlossen. Da die Datenquelle Kategorie die Standardeinstellung für eine Tageswolke ist, muss sie nicht speziell referenziert werden.

Datei:Handbuch:tagcloud-example-exclude-DE.png

3D Canvas

Tag und Parameter:

<bs:tagcloud renderer="canvas3d" store="category" count="15" minsize="12" maxsize="40" showcount="false" />

Ergebnis:

Der Renderer canvas3d erzeugt eine interaktive Wortwolke. Die Wolke dreht sich, wenn sich der Cursor über der Wortwolke befindet. Es zeigt die 15 (count) am häufigsten getaggten Kategorien. Es ist wichtig, das Zähllimit festzulegen, da die Standardanzahl auf 40 festgelegt ist. Hierdurch würde eine 3D-Wolke erzeugt, die die Begriffe unleserlich darstellt. Die Datenquelle (store) ist category. Dies ist optional, da category der Standardwert für die Datenquelle ist. Die Schriftgrößen reichen von 12 Pixel (minsize) bis 40 Pixel (maxsize). Wie viele Seiten und Dateien jeder Kategorie zugeordnet sind, wird nicht angezeigt (showcount = "false").

Datei:Handbuch:tagcloud-canvas3D-DE.png

List

Tag und Parameter:

<bs:tagcloud renderer="list" store="searchstats" count="5" />

Ergebnis:

Der Renderer list produziert eine einfache Liste, die absteigend nach Häufigkeit sortiert ist.

Datei:Handbuch:tagcloud-list-searchstats-DE.png

Die Wortwolke vom Typ list ignoriert folgende Parameter: minsize, maxsize

Weiterführende Links

• Referenz:BlueSpiceTagCloud

Tag: XML-Tags, welche beliebig parametrisiert werden können und eine vom Programmierer gewünschte Ausgabe produzieren. Fügt man beispielsweise das <bs:bookshelf>-Tag ein, dann erhält der Artikel die Kapitelnavigation des PDF-Buches, in dem der Artikel verlinkt ist.

Kategorien helfen, Seiten im Wiki zur organisieren. Jede Kategorie ist im gesamten Wiki verfügbar.

Technische Referenz: BlueSpiceTagCloud

---

Feedback zur Dokumentation ist im Community-Forum möglich.