{{Vorlage:Hinweisbox|boxtype=Wichtig|icon=|Note text=Apache Tomcat ist Voraussetzung für den Betrieb des PDF-Exports. Die hier aufgeführten Schritte sind deshalb optional und nur erforderlich, wenn Sie einen oder mehrere dieser Dienste in Ihrer BlueSpice-Installation verwenden möchten.|bgcolor=}}
{{Vorlage:Hinweisbox|boxtype=Hinweis|Note text=Für den Betrieb von Apache Tomcat ist [[Setup:Installationsanleitung/Systemvorbereitung/Windows/OpenJDK|OpenJDK]] Voraussetzung. Sollten Sie dies noch nicht installiert haben so folgen Sie dem eben genannten Link.}}
==Download==
Öffnen Sie in Ihrem Browser die [http://tomcat.apache.org/ offizielle Download-Seite] (1) und wechseln auf die Download-Seite der Version 9 Version (2).
Der visuelle Editor von BlueSpice basiert auf der MediaWiki-Erweiterung [[mediawikiwiki:Help:VisualEditor/User_guide/de|VisualEditor]]. Er ermöglicht die Formatierung und das Einfügen von Seiteninhalten ohne Wikitext-Kenntnisse.
#'''Einfügen''' von Spezialinhalten (Dateien/Medien, Tabellen, Vorlagen, Magische Wörter)
#'''Seitenoptionen''' einstellen
<section end="training" />
<br />Beim Erstellen oder Bearbeiten einer Seite ist man gleich im visuellen Bearbeitungsmodus. Wer mit der Codesprache von MediaWiki ("Wikitext") vertraut ist und entsprechend im Quelltext der Seite arbeiten möchte, kann über die Funktion "Editor wechseln" bequem umschalten:.[[Datei:VisualEditor-toggle.png|mini|Moduswechsel|zentriert|200x200px|alt=Moduswechsel]]
Typische Textformatierungen wie '''fett''', ''kursiv'', oder <span class="col-turquoise">Textfarbe</span> sind bereits während der Texteingabe möglich. Wenn Sie mit der Maus Text formatieren, sehen Sie im Anschluß ein Minimenü mit den wichtigsten Formatierungselementen. Mit einem Klick kann die gewünschte Formatierung ausgewählt werden. Dies ist besonders schnell, wenn man zum Beispiel die Textfarbe ändern will:
<br />
[[Datei:VE textcolors.png|zentriert|280x280px|mini|Changing text colors]]
==<span class="mw-headline" id="Pasting_content_from_your_clipboard_.28ctrl.2Bshift.2Bv.29" style="box-sizing: inherit;">Inhalte über die Zwischenablage einfügen</span>==
[[Datei:VisualEditor-undo.png|mini|rück-gängig]]Wenn Sie Inhalte aus Ihrer Zwischenablage einfügen (z. B. aus MS Word oder MS Excel kopiert), fügen Sie normalerweise auch viele unnötige Formatierungs-Tags aus der ursprünglichen Anwendung ein. Um dies zu vermeiden, sollten Sie den Inhalt als Klartext einfügen.
Wenn Sie bereits Text eingefügt haben, der zu einer unerwünschten Formatierung geführt hat, können Sie die Funktion "rückgängig" in VisualEditor verwenden. Dies entefernt den neuen Inhalt, wenn Sie die Seite noch nicht gespeichert haben oder zwischen visueller Bearbeitung und Quelltextbearbeitung gewechselt haben.
Verwenden Sie in die Tastenkombination '''Strg + Umschalt + v''', um den Inhalt stattdessen als Klartext einzufügen.
{{Vorlage:Hinweisbox|boxtype=Hinweis|Note text=Beachten Sie bitte, dass der Download auf Ihrem Windows Server mit Internet Explorer nur dann funktioniert, wenn Sie die Erweiterten Sicherheitseinstellungen für Internet Explorer im Servermanager entsprechend konfiguriert haben. Beachten Sie hierzu die technische Dokumentation von Microsoft.}}
==Shortcuts==
{{Vorlage:Hinweisbox|boxtype=Hinweis|Note text=Im Folgenden wird die Version 9.0.16 von Apache Tomcat verwendet und dient nur beispielhaft für die jeweils aktuellste Version, die Sie zum Zeitpunkt Ihrer Installation herunterladen können.}}
Wenn Sie mehrere Formatierungen gleichzeitig anwenden wollen, geht das über Tastaturkürzel oft am schnellsten. Um Text zum Beispiel fett und kursiv anzuzeigen, markieren Sie den Text und drücken Sie die Tastenkombinationen Strg+b (für das Englische "'''bold'''") und Strg+i (für "''italics''"). Auch ein Link lässt sich schnell über Strg+k einfügen. Ein erneutes Drücken von Strg+b hebt den Fettdruck wieder auf. Mehrere Formatierungen lassen sich nach der Textauswahl über Strg+M kombiniert entfernen.
==Installation von Apache Tomcat==
Öffnen Sie die soeben heruntergeladene Datei "apache-tomcat-9.0.16.exe".
Alle Editor Funktionen, für die es Tastaturkürzel gibt, sind entsprechend gekennzeichnet.
Starten Sie die Installation durch Klick auf "Next >":
[[Datei:Handbuch:1610633848528.png|zentriert|mini|Menüpunkte mit Tastaturkürzeln]]
<br />
{{Hinweisbox|boxtype=Hinweis|Note text=Eine komplette Liste der Tastaturkürzel finden Sie unter "Tastaturkürzel" im Hilfemenü des Visual Editors (dem Fragezeichen-Menüpunkt).}}
Stimmen Sie dem Lizenzvertrag durch Klick auf "I Agree" zu:
Einige Funktionen im Menü "Einfügen" sind aus der traditionellen Textverarbeitung wenig bekannt, sind aber ganz typisch für die Arbeit mit einem Wiki. Daher werden Sie hier kurz vorgestellt. Tiefer eintauchen können Sie auf den jeweiligen Einzelseiten:
*'''Kommentar:''' Fügen Sie Kommentare in die Seite ein. Diese sind nur im Quelltext sichtbar.
Wählen (1) Sie das Home-Verzeichnis Ihrer [[Setup:Installationsanleitung/Systemvorbereitung/Windows/OpenJDK|OpenJDK-Installation]] (2) aus und klicken auf "Next >" (3):
*'''Magisches Wort:''' Wiki Funktionen wie Unterschrift, Wörterzähler, Kategorienbaum oder sogar Prozessdiagramme mit draw.io lassen sich als "magisches Wort" integrieren.
*'''Deine Unterschrift:''' Funktioniert nur auf Seiten, die Unterschriften erlauben. Seiten im Namensraum "Seiten" gehören nicht dazu.
*'''Galerie:''' Eine schlichte Bildergalerie kann so manchen Prozessablauf sinnvoll unterstützen.
*'''Codeblock:''' Programmiercode wird hier sauber in Codeblocks formatiert dargestellt, optional mit Zeilenangaben.
*'''Einzelnachweisliste:'''
*'''Chemische Formel:''' <span class="JLqJ4b ChMk0b"><span>Das Rendering von chemischen Formeln verwendet einen externen Dienst über die REST-API von Wikimedia.</span></span>
*'''Math Formel:''' Es öffnet sich ein Editor zum Eingeben einer mathematischen Formel. [https://www.mediawiki.org/wiki/Help:VisualEditor/User_guide/de?action=view#Editing_mathematical_formulae Mehr Info auf MediaWiki]
Beim Erstellen oder Bearbeiten einer Seite wird die Seite im visuellen Bearbeitungsmodus geladen. Wenn Sie mit der einfachen Codesprache von MediaWiki ("Wikitext") vertraut sind, können Sie mit der Schaltfläche "Editor wechseln" in den Quellbearbeitungsmodus wechseln.
<br />{{Hinweisbox|boxtype=Hinweis|Note text=Ungespeicherte Änderungen können nach dem Wechsel zwischen visueller und Quelltextbearbeitung nicht über die Schaltfläche "rückgängig" wiederhergestellt werden!}}
Da der visuelle Editor eine Standard MediaWiki Erweiterung ist, können Sie auch eine [https://www.mediawiki.org/wiki/Help:VisualEditor/User_guide/de?action=view komplette Dokumentation der Funktionalität auf MediaWiki] lesen.
Hier im BlueSpice Helpdesk geben wir daher nur kurze Hinweise und Tipps zur Nutzung des Editors.
|Hier kann Text als Überschrift oder bestimmter Absatztyp definiert werden.
''Hinweis:'' Wenn Sie in einer [https://de.wiki.bluespice.com/w/index.php?title=Tabelle&action=view Tabelle] arbeiten, ändern sich die Optionen entsprechend (Inhaltszelle und Überschriftszelle):
| Falls vor dem Klicken auf das "'''''A'''''" und auf eine Schaltfläche kein Text ausgewählt worden ist, wird der Text ab der aktuellen Position des Cursors entsprechend formatiert.
([https://www.mediawiki.org/wiki/Help:VisualEditor/User_guide/de?action=view#Erste_Schritte:_Die_VisualEditor-Werkzeugleiste Mehr Info auf MediaWiki])
|-
|Hyperlink einfügen
[[Datei:VE Hyperlink einfügen.png]]<br />
|Wenn kein Text ausgewählt wurde, bevor der Hyperlink Dialog geöffnet wurde, wird der Link mit einer Nummer generiert:
[[mediawikiwiki:Help:VisualEditor/User_guide/de#Erste_Schritte:_Die_VisualEditor-Werkzeugleiste|[1]]] Um die Hyperlink-Beschreibung nachträglich zu ändern, klicken Sie einfach auf den Link, um das Bearbeitungsmenü zu öffnen. In einer Tabelle müssen Sie eventuell erst auf die Zelle doppelklicken und dann noch einmal auf den Hyperlink klicken.
|-
|Zitat
[[Datei:VE Zitat.png]]
|Das Zitat-Menü dient dazu, Verweise (auch Einzelnachweise oder Fußnoten genannt) innerhalb des Textes einzufügen.
Wechseln Sie in das Installationsverzeichnis von Tomcat. Standardmäßig finden Sie dies unter <code>C:\Program Files\Apache Software Foundation\Tomcat 9.0\conf</code>.
|Kommentare sind für Leser nicht sichtbar, sondern nur im Bearbeitungsmodus. Ein Kommentar kann überall auf einer Seite eingefügt werden. Der Kommentar kann durch Anklicken bearbeitet werden.
Und so sieht ein Kommentar aus<br />
|-
|Galerie
[[Datei:VE Galerie.png]]
|Bilder können mit der Galerie Funktion als Bildersatz kombiniert auf einer Seite dargestellt werden.
|Mit einem "Magischem Wort" können Sie bestimmte Variablen oder sogenannte Verhaltensschalter in Ihrer Seite einbinden. Zum Beispiel können Sie die Wortzahl anzeigen lassen:
Öffnen Sie hier die Datei context.xml in einem Texteditor und ersetzen Sie die einmal vorkommende Zeile
|Mit Codeblock können verschiedene Code-Beispiele eingegeben werden, wie z.B. in HTML-Syntax. Der Code wird dann ordentlich formatiert dargestellt: <br />
|Hier teilen Sie die Seite den gewünschten [[Kategorien einfügen|Kategorien]] zu. Die Seite erscheint dann entsprechend auf allen verknüpften Kategorienseiten.
|Weiterleitung der Seite: Wenn die Seite weitergeleitet wird, wird der Inhalt der Seite nicht mehr angezeigt, sondern es wird direkt die Zielseite geladen.
Über diese Einstellung kann auch das Inhaltsverzeichnis am Seitenanfang angezeigt oder entfernt werden. Das Inhaltsverzeichnis wird automatisch durch die Überschriften auf der Seite generiert. Ab drei Überschriften erscheint das Inhaltsverzeichnis standardmäßig automatisch.
|Unterstützung für Sprachen, die von rechts nach links gelesen werden. Das Anklicken dieser Schaltfläche formatiert den Seitentext rechtsbündig. Erneutes Anklicken setzt den Text wieder linksbündig.
|-
|Suchen und ersetzen
[[Datei:VE Suchen und Ersetzen.png]]
|Wörter oder Zeichen können direkt auf der Seite gesucht und ersetzt werden. Über die Schaltfläche "Rückgängig machen" kann die Änderung aufgehoben werden.
|}
==<span class="mw-headline" id="Troubleshooting:_Visuelle_Bearbeitung_ist_deaktiviert">Troubleshooting: Visuelle Bearbeitung ist deaktiviert</span>==
Speichern und schließen Sie die Datei.
Wenn Ihnen nur die Quelltextbearbeitung angezeigt wird, wenden Sie sich bitte an einen Administrator Ihres Wikis. Folgende Einstellungen müssen in diesem Fall überprüft werden:
*Globale Einstellung über den Konfigurationsmanager
Suchen Sie im Startmenü den Eintrag "Configure Tomcat" und öffnen diesen:
Nach erfolgreicher Installation von BlueSpice befolgen Sie bitte folgende weitere Schritte zur Installation der Webservices und Aktivierung der jeweiligen BlueSpice-Erweiterung:
Haben Sie alle Schritte erfolgreich abgeschlossen können Sie die zuvor heruntergeladene Datei "apache-tomcat-9.0.16.exe" von Ihrer Festplatte löschen und zum nächsten Schritt "[[Setup:Installationsanleitung/Systemvorbereitung/Windows/Elasticsearch|Elasticsearch]]" weiter gehen.
Wichtig!Apache Tomcat ist Voraussetzung für den Betrieb des PDF-Exports. Die hier aufgeführten Schritte sind deshalb optional und nur erforderlich, wenn Sie einen oder mehrere dieser Dienste in Ihrer BlueSpice-Installation verwenden möchten.
Hinweis:Für den Betrieb von Apache Tomcat ist OpenJDK Voraussetzung. Sollten Sie dies noch nicht installiert haben so folgen Sie dem eben genannten Link.
Download
Öffnen Sie in Ihrem Browser die offizielle Download-Seite (1) und wechseln auf die Download-Seite der Version 9 Version (2).
Downloaden Sie den "32-bit/64-bit Windows Service Installer"
Hinweis:Beachten Sie bitte, dass der Download auf Ihrem Windows Server mit Internet Explorer nur dann funktioniert, wenn Sie die Erweiterten Sicherheitseinstellungen für Internet Explorer im Servermanager entsprechend konfiguriert haben. Beachten Sie hierzu die technische Dokumentation von Microsoft.
Hinweis:Im Folgenden wird die Version 9.0.16 von Apache Tomcat verwendet und dient nur beispielhaft für die jeweils aktuellste Version, die Sie zum Zeitpunkt Ihrer Installation herunterladen können.
Installation von Apache Tomcat
Öffnen Sie die soeben heruntergeladene Datei "apache-tomcat-9.0.16.exe".
Starten Sie die Installation durch Klick auf "Next >":
Stimmen Sie dem Lizenzvertrag durch Klick auf "I Agree" zu:
Den nächsten Schritt bestätigen Sie durch Klick auf "Next >":
Auch den nächsten Schritt bestätigen Sie durch Klick auf "Next >":
Wählen (1) Sie das Home-Verzeichnis Ihrer OpenJDK-Installation (2) aus und klicken auf "Next >" (3):
Starten Sie jetzt die Installation von Tomcat:
Am Ende der Installation wählen Sie beide vorselektierten Haken ab (1) und beenden das Setup (2)
Konfiguration von Apache Tomcat
Wechseln Sie in das Installationsverzeichnis von Tomcat. Standardmäßig finden Sie dies unter C:\Program Files\Apache Software Foundation\Tomcat 9.0\conf.
Öffnen Sie hier die Datei context.xml in einem Texteditor und ersetzen Sie die einmal vorkommende Zeile
<Context>
durch
<Context mapperContextRootRedirectEnabled="true">
Speichern und schließen Sie die Datei.
Öffnen Sie im selben Verzeichnis die Datei server.xml in einem Texteditor und stellen sicher, dass der komplette Block
Suchen Sie im Startmenü den Eintrag "Configure Tomcat" und öffnen diesen:
Stellen Sie den "Startup type" auf "Automatic" (1) und starten Tomcat (2). Anschließend Beenden Sie die Konfigurations-Konsole (3):
Überprüfen der Installation
Zur Überprüfung, ob Tomcat korrekt läuft öffnen Sie in einem Browser auf dem Server die Adresse http://localhost:8080/.
Sie sollten nun die Startseite des Tomcat-Servers angezeigt bekommen:
Installation der Webapps
Nach erfolgreicher Installation von BlueSpice befolgen Sie bitte folgende weitere Schritte zur Installation der Webservices und Aktivierung der jeweiligen BlueSpice-Erweiterung:
Haben Sie alle Schritte erfolgreich abgeschlossen können Sie die zuvor heruntergeladene Datei "apache-tomcat-9.0.16.exe" von Ihrer Festplatte löschen und zum nächsten Schritt "Elasticsearch" weiter gehen.