WebHelp-Ausgabe: Unterschiedliches Verhalten beim lokalen Öffnen

Aufgabe

Beim Öffnen einer WebHelp-Ausgabe verhält sich die Ausgabe unterschiedlich, wenn sie lokal im Ausgabeverzeichnis oder direkt aus Help+Manual geöffnet wird, z. B. sind die Inhaltsverzeichniseinträge aufgeklappt oder die Hilfe lässt sich nicht öffnen. Woran kann das liegen?

Lösung

Grundsätzlich unterscheidet sich das Verhalten der WebHelp, wenn Sie die Ausgabe über den HM2Go-Server oder lokal im Windows Explorer öffnen.

Wenn Sie die WebHelp erstellen und direkt in Help+Manual öffnen, wird die Ausgabe üblicherweise automatisch im HM2Go-Server geöffnet. HM2Go ist ein Mini-Web-Server, der alles enthält, was benötigt wird, um ein vollständiges WebHelp System auf einem lokalen Browser darzustellen. In dieser Umgebung funktioniert die WebHelp in der Regel einwandfrei.

Wenn die WebHelp ausgeliefert oder die Hilfe über die Startdatei im Windows-Explorer geöffnet wird, wird beim Öffnen der lokal liegenden Datei wird keine Web-Umgebung vorgespiegelt, z. B. die Index-Datei wird über den Windows Explorer geöffnet. Beim lokalen Öffnen greifen die Sicherheitseinstellungen des Browsers, der das gewünschte Verhalten des Inhaltsverzeichnisses oder das Öffnen der Datei verhindert.

In diesem Fall müssen Sie die HM2Go-Exe-Datei in Ihr Ausgabeverzeichnis kopieren, also dahin wo Ihre WebHelp-Ausgabe liegt. Die HM2Go-EXE liegt im Programmverzeichnis von Help+Manual. Sie können den HM2Go-Server auch an Ihre Kunden ausliefern. Eine detaillierte Beschreibung dazu finden Sie in der Hilfe von HuM: https://www.helpandmanual.com/help/hm_working_configoutput_hm2go.html

WebHelp lässt sich mit Firefox und Edge nicht öffnen

Das betrifft einige (nicht alle) WebHelp-Skins, die mit H+M V7.x mitgeliefert wurden, z. B. WebHelp_FreshLimeSoda.hmskon und andere. Mit der Skin HM7-Help-WebHelp-Responsive.hmskin tritt dieses Problem beispielsweise nicht auf.

Der Grund liegt in der verwendeten Technologie in den betroffenen Skins. Diese stellt aus Sicht der Browsers eine Sicherheitslücke dar, was dann zu folgender Meldung führt:

Zum Vergrößern / Verkleinern auf das Bild klicken

Um das zu vermeiden können Sie entweder den Webserver HM2Go mitliefern und dafür Sorge tragen, dass der lokale Aufruf der WebHelp über den Server erfolgt (siehe Link oben) oder eine andere Skin verwenden (vorher testen, welche lokal funktioniert).