JavaHelp - Navigationsbereich geöffnet zeigen

[kodela]

Hallo,

kennt sich hier jemand mit JavaHelp im Zusammenspiel mit DobuDish aus? Wenn ja, dann hätte ich eine Frage.

Ich habe zwei Programme, für die ich je eine Hilfe geschrieben habe. Der Inhalt der Hilfe ist in XML geschrieben. Die Übersetzung nach Java erfolgt über DobuDish. Am Ende habe ich drei Dateien, jh.jar, hsviewer.jar und die jar-Datei mit dem Inhalt der Hilfe die ich in das jeweilige Projekt als Bibliothek einbinden kann. Das hat über viele Jahre einwandfrei funktioniert, damit meine ich dass in der Hilfe links im Navigationsbereich alle Kapitel und Unterkapitel (Sectionen) und rechts der gewählt Inhalt gezeigt wurde.

Vor einigen Tagen habe ich nun festgestellt, dass bei beiden Programmen nach dem Start der Hilfe nur die Kapitel gezeigt werden. Die kann man zwar öffnen und damit auch die Unterkapitel sehen und auswählen, aber ich hätte eben gerne, dass vom Start weg sofort der gesamte Inhalt zu sehen ist. Ereignet muss sich das alles schon mindesten vor vier Monaten, gemerkt habe ich es erst jetzt.

Was könnte die Ursache für das geänderte Verhalten sein?

MfG kodela

 

[Blender3D]

Ich kenne Dobudish nicht und kann dir zu dieser Software deshalb nicht viel sagen. Meine Recherche hat ergeben, dass es zu diesem Framework seit 2010 keine Updates mehr existieren.
https://code.google.com/archive/p/dobudish/downloads
Der Link zur Hompage von dobudish https://www.agynamix.de/products/dobudish/ führt nicht einmal mehr zu dieser Software.

Die Gründe für das veränderte Verhalten könnten durch Updates von Java , Betriebssystem usw. bedingt sein.
Normalerweise wird, das dann vom Urheber des Frameworks auch durch Updates behoben.

Für Hilfe des Sourcecode ist javadoc gut geeignet.
Für Hilfen für das Benutzerhandbuch verwende ich gerne eine Textverarbeitung wie z.B. Writer von LibreOffice.
Das damit erstellte Dokument bietet alle Möglichkeiten wie Links, Grafiken, Videos usw. und lässt sich in einem gewünschte Format wie pdf html usw. ausliefern.
Der Vorteil bei Opensource Großprojekten sind zukünftige Updates gewährleistet.

 

[kodela]

Danke für die ausführliche Antwort. Ich werde, mit wenig Hoffnung, weiter nach einer Lösung, oder zumindest nach der Ursache, warum es keine Lösung gibt, suchen und, falls ich doch noch 'fündig' werden sollte, berichten.

 

[Robert Zenz]

Vor einigen Tagen habe ich nun festgestellt, dass bei beiden Programmen nach dem Start der Hilfe nur die Kapitel gezeigt werden. Die kann man zwar öffnen und damit auch die Unterkapitel sehen und auswählen, aber ich hätte eben gerne, dass vom Start weg sofort der gesamte Inhalt zu sehen ist.

Koennte auch eine Race-Condition/Korrektor in Java Swing (JTree) sein was da nun hineinpfuscht.

Ich glaube dass dieser Teil vom Quellcode dafuer zustaendig ist. Das sollte eigentlich alle naselang mal aufgerufen werden, aber vielleicht hat sich da irgendwas geaendert (oder an den Daten wie sie generiert sind). Wirklich sagen kann man das aber erst wenn man da mal Schritt fuer Schritt durchgeht waehrend der Ausfuehrung, wuerde ich sagen.

 

[mihe7]

Mal ganz nebenbei:

Für Hilfen für das Benutzerhandbuch verwende ich gerne eine Textverarbeitung wie z.B. Writer von LibreOffice.

Dafür verwenden wir seit einiger Zeit AsciiDoc. Erstens verzichtet man da automatisch auf kreativen Firlefanz und zweitens lässt sich der Spaß hervorragend mit git verwalten. Für Maven gibt's ein Plugin und mindestens für VS Code auch eine Vorschau.

 

[KonradN]

Dafür verwenden wir seit einiger Zeit AsciiDoc

Da starte ich mal die „me too“ Bewegung.

Ich bin vor allem vom IntelliJ Plugin begeistert, das die Arbeit mit AsciiDoc sehr vereinfacht.

 

[kodela]

Koennte auch eine Race-Condition/Korrektor in Java Swing (JTree) sein was da nun hineinpfuscht.

Ich glaube dass dieser Teil vom Quellcode dafuer zustaendig ist. Das sollte eigentlich alle naselang mal aufgerufen werden, aber vielleicht hat sich da irgendwas geaendert (oder an den Daten wie sie generiert sind). Wirklich sagen kann man das aber erst wenn man da mal Schritt fuer Schritt durchgeht waehrend der Ausfuehrung, wuerde ich sagen.

Danke Robert,

nach längerer unfreiwilliger Abwesenheit habe ich mich wieder mit dem Thema beschäftigt, leider ohne Erfolg. Jetzt will ich aber nicht mehr weiter suchen, es muss auch so gehen, wie es jetzt ist.