Handbuch:Erweiterung/BlueSpiceTagCloud und Setup:Installationsanleitung/Systemvorbereitung/Linux/Elasticsearch: Unterschied zwischen den Seiten

Version vom 22. Dezember 2021, 16:26 Uhr

Hinweis:Elasticsearch ist Voraussetzung für den Betrieb der Erweiterten Suche. Die hier aufgeführten Schritte sind deshalb optional und nur erforderlich, wenn Sie diese in Ihrer BlueSpice-Installation verwenden möchten.

Hinzufügen der Paketsourcen[Bearbeiten | Quelltext bearbeiten]

Elasticsearch ist unter Debian nicht im Paketmanager enthalten. Jedoch stellt der Hersteller selber ein Repository für die Software zur Verfügung. Fügen Sie dieses mit folgenden Befehlen Ihrer Debian-Installation hinzu. Voraussetzung hier ist, dass Sie das Programm "gnupg" installiert haben (apt install gnupg).

wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | apt-key add -; \
echo "deb https://artifacts.elastic.co/packages/6.x/apt stable main" > /etc/apt/sources.list.d/elastic-6.x.list

Installation von Elasticsearch[Bearbeiten | Quelltext bearbeiten]

Die anschließenden Installation von Elasticsearch führen Sie mit diesen Befehlen durch.

apt update; \
apt install elasticsearch; \
apt clean

Installation von ingest-attachment[Bearbeiten | Quelltext bearbeiten]

Für die Erweiterte Suche in BlueSpice wird das Plugin "ingest-attachment" für Elasticsearch benötigt. Dies wird über folgenden Befehl installiert.

/usr/share/elasticsearch/bin/elasticsearch-plugin install -b ingest-attachment

Elasticsearch starten und dem Autostart hinzufügen[Bearbeiten | Quelltext bearbeiten]

Fügen Sie die Elasticsearch dem Autostart hinzu und starten den Dienst anschließend:

systemctl enable elasticsearch; \
service elasticsearch start

Nächster Schritt[Bearbeiten | Quelltext bearbeiten]

Haben Sie alle Schritte erfolgreich abgeschlossen können Sie zum nächsten Schritt "Python" weiter gehen.

Technische Referenz: BlueSpiceTagCloud

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

@@ Zeile 1: / Zeile 1: @@
-{{DISPLAYTITLE:Tag Cloud (TagCloud)}}
+{{DISPLAYTITLE:Elasticsearch}}
+__TOC__
-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:750px-tagcloud-example.png|alternativtext=|zentriert|mini|750x750px]]
-==Einbinden einer Wortwolke==
+{{Hinweisbox|boxtype=Hinweis|Note text=Elasticsearch ist Voraussetzung für den Betrieb der Erweiterten Suche. Die hier aufgeführten Schritte sind deshalb optional und nur erforderlich, wenn Sie diese in Ihrer BlueSpice-Installation verwenden möchten.}}
-Eine Wortwolke kann direkt in der Quelltextbearbeitung über das Tag <nowiki><bs:tagcloud /></nowiki>
+==Hinzufügen der Paketsourcen==
+Elasticsearch ist unter Debian nicht im Paketmanager enthalten. Jedoch stellt der Hersteller selber ein Repository für die Software zur Verfügung. Fügen Sie dieses mit folgenden Befehlen Ihrer Debian-Installation hinzu. Voraussetzung hier ist, dass Sie das Programm "gnupg" installiert haben (<code>apt install gnupg</code>).
-eingefügt werden. Um die Wortwolke über VisualEditor einzufügen, gehen Sie auf ''Einfügen > Magisches Wort > Tag Cloud''.
+<pre>wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | apt-key add -; \
-[[Datei:VE-magicword-tagcloud-DE.png|alternativtext=|zentriert|mini|461x461px]]
+echo "deb https://artifacts.elastic.co/packages/6.x/apt stable main" > /etc/apt/sources.list.d/elastic-6.x.list
-==Konfiguration==
+</pre>
-Wenn ein Tag mit dem[[Handbuch:Erweiterung/VisualEditor | VisualEditor]] hinzugefügt wird, erscheint nach dem Einfügen ein Konfigurationsdialog. Es zeigt Konfigurationsoptionen in zwei Registerkarten: ''Allgemein'' und ''Erweitert''.
-[[Datei:tagcloud2.png|zentriert|461x461px|verweis=Special:FilePath/tagcloud2.png]]
-===Allgemeine Konfiguration===
+==Installation von Elasticsearch==
-{| class="wikitable"
+Die anschließenden Installation von Elasticsearch führen Sie mit diesen Befehlen durch.
-!Parameter!!Anzeigename
-!Beschreibung
-|-
-|renderer||Typ
-|Modus zum Rendern der Cloud
-*Liste
+<pre>apt update; \
-*Text - die Schriftgröße hängt von der Häufigkeit ab
+apt install elasticsearch; \
-*3D - rotierende, interaktive Ansicht
+apt clean
+</pre>
-|-
+==Installation von ingest-attachment==
-|width
+Für die Erweiterte Suche in BlueSpice wird das Plugin "ingest-attachment" für Elasticsearch benötigt. Dies wird über folgenden Befehl installiert.
-|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===
-{| class="wikitable"
-!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==
+<pre>/usr/share/elasticsearch/bin/elasticsearch-plugin install -b ingest-attachment</pre>
-===Text===
+==Elasticsearch starten und dem Autostart hinzufügen==
-Tag und Parameter:
+Fügen Sie die Elasticsearch dem Autostart hinzu und starten den Dienst anschließend:
-<code><nowiki><bs:tagcloud count="10" minsize="12" maxsize="34" exclude="Logo" /></nowiki></code>
+<pre>systemctl enable elasticsearch; \
+service elasticsearch start</pre>
-Ergebnis:
+==Nächster Schritt==
+Haben Sie alle Schritte erfolgreich abgeschlossen können Sie zum nächsten Schritt "[[Setup:Installationsanleitung/Systemvorbereitung/Linux/Python|Python]]" weiter gehen.
-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:tagcloud-example-exclude-DE.png|alternativtext=Tag Cloud Beispiel Typ Text|zentriert|650x650px]]
-===3D Canvas===
-Tag und Parameter:
-<code><nowiki><bs:tagcloud renderer="canvas3d"  store="category" count="15" minsize="12" maxsize="40" showcount="false" /></nowiki></code>
-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:tagcloud-canvas3D-DE.png|alternativtext=3D Tag Cloud|zentriert|350x350px]]
-===List===
-Tag und Parameter:
-<code><nowiki><bs:tagcloud renderer="list" store="searchstats" count="5" /></nowiki></code>
-Ergebnis:
-Der Renderer ''list'' produziert eine einfache Liste, die absteigend nach Häufigkeit sortiert ist.
-[[Datei:tagcloud-list-searchstats-DE.png|alternativtext=Tag Cloud Typ Liste|zentriert|180x180px]]
-Die Wortwolke vom Typ ''list'' ignoriert folgende Parameter: ''minsize'', ''maxsize''
-<br />{{Box Links|Thema1=[[Referenz:BlueSpiceTagCloud]]}}
-{{Translation}}
-[[Category:Inhalt]]