JHelp - Anzeige im Navigator

[kodela]

Hallo,

kann mir jemand sagen, über welche Einstellung man erreicht, dass unter javax.help der Ordnerbaum im Navigator beim Aufruf der Hilfe bereits offen angezeigt wird?

Gruß, kodela

 

[mihe7]

Lt. https://docs.oracle.com/cd/E19253-01/819-0913/author/toc.html sollte es ein Attribut expand geben, das man auf true setzen kann.

 

[kodela]

Danke mihe7!

Hm - bisher habe ich zumindest in JHelp kein Attribut expand (oder ähnlich. was darauf hinzeigen könnte) gefunden.
Morgen werde ich HelpSet durchforsten. Das verlinkte Beispiel kann auf keinen Fall in irgend einer Weise übernommen werden. Bei mir ist die xml-Basisdatei vom DOCTYPE book und im Beispiel DOCTYPE toc.

Wenn ich Erfolg haben sollte, melde ich mich natürlich. Ansonsten "bleibe ich in der Hoffnung".

Gruß, kodela

 

[mihe7]

Arbeitest Du mit DocBook?

 

[kodela]

Ja, ich arbeite mit DocBook und DobuDish. In HelpSet habe ich übrigens auch nichts gefunden.

 

[mihe7]

Wenn Du das Docbook transformierst, bekommst Du doch auch eine irgendwasTOC raus, oder?

 

[kodela]

Lediglich in der Datei style-common.css finden sich folgende zwei Abschnitte, in denen "toc" vorkommt:

/* table of contents, list of figures and list of tables */
.toc, .list-of-figures, .list-of-tables, .list-of-examples
{
/* margin settings are top - right - bottom - left (think clockwise) */
margin: 15px 30px 15px 15px;
}


/* the "headings" are rendered as paragraphs */
.toc p, .list-of-figures p, .list-of-tables p, .list-of-examples p
{
/* no margin */
margin: 0;
}

Das kann es aber doch nicht sein.

 

[kodela]

Bei meiner Suche nach TOC's habe ich in DobuDish\system\docbook und .\custom eine Vielzahl von Dateien gefunden. Welche davon zielführend sind, werde ich jetzt erst einmal untersuchen.

Nachtrag:
Ich habe jetzt eine Datei gefunden, die gut aussah. In autotoc.xsl gibt es an zwei Stellen folgende Zeile:

<xsl:attribute name="axf:outline-expand">false</xsl:attribute>

In beiden habe ich das "false" durch "true" ersetzt und anschließend das Projekt neu compiliert. Ergebnis: keine Änderung im Navigationsbereich des Hilfefensters, aber auch sonst keine Auswirkung festgestellt.

 

[kodela]

Hallo @mihe7,

Dank Deines Hinweises auf das Attribut "expand" und zu den TOCs habe ich nun eine Lösung gefunden. Nicht die eleganteste, aber immerhin:

Wenn ich meine XML-Hilfedatei mit DobuDish compiliere, bekomme ich die drei Dateien hsviewer.jar, jh.jar und [Name der XML-Hilfedatei].jar. Öffne ich leztere mit 7-Zip, dann findet sich dort eine Datei jhelptoc.xml. Hier die ersten Zeilen dieser Datei:

<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE toc
  PUBLIC "-//Sun Microsystems Inc.//DTD JavaHelp TOC Version 1.0//EN" "http://java.sun.com/products/javahelp/toc_1_0.dtd">
<toc version="1.0">
   <tocitem target="d0e1" text="[ProgrammName]">
      <tocitem target="d0e4" text="Informationen zum Programm">
         <tocitem target="d0e89" text="Erste Schritte"/>

Ich öffnete diese Datei und fügte in der ersten Zeile nach <toc version="1.0"> als Attribut "expand="true"" ein und ließ die geänderte Datei von 7-Zip übernehmen. Danach compilierte ich das Programm selbst und der ganze Navigationsbaum zeigte sich genau so offen, wie ich es mir vorgestellt hatte.

Leider habe ich bisher noch keine Möglichkeit gefunden, dieses expand-Attribut auf ganz "legale" Weise einzufügen.

 

[mihe7]

So, ich habe mir jetzt mal ein paar Dateien aus dem DobuDish besorgt. Du kannst mal ausprobieren, was passiert, wenn Du unter system/custom-xsl/javahelp-commons.xsl die Zeilen (sind mehrere)

    <tocitem target="{$id}">

durch

    <tocitem target="{$id}" expand="true">

ersetzt.

 

[kodela]

Hallo @mihe7,

hab' ich's nicht schon einmal gesagt, Du bist ein Ass!

Danke, das war's! Und Du hast mir eine Menge Zeit erspart, denn ich war auch schon auf der Suche. Aber Deine Spürnase habe ich nicht; da fehlt einfach die Erfahrung.

kodela

 

[mihe7]

Vielen Dank für Deine nette Rückmeldung. Freut mich, wenn es jetzt funktioniert.

 

[kodela]

Hallo mihe,

viel Zeit ist vergangen, in der ich DobuDish neu installieren musste, und in der ich mich immer wieder über den Navigationsbereich der Java-Hilfe ärgerte. An Deine Suuuper-Hilfe erinnerte ich mich nicht mehr, aber den Zustand mit nur drei Anzeigen im Navigationsbereich wollte ich unbedingt ändern.
Heute habe ich es mit der KI von Google versucht. Das Ergebnis war bescheiden, ich musste in zwei Dateien nach jeder Änderung der Hilfedateien (ich habe zwei Projekte damit) Änderungen in der von DobuDish erzeugten Hilfedatei vornehmen. Dann fand ich im Sourcecode der Hilfe-Klasse einen Hinweis auf die Lösung von Dir und seitdem ist die Welt wieder in Ordnung. Nochmals also vielen Dank.

Eine Frage habe ich noch: Die Lösung von Dir führt dazu, dass sämtliche Einträge angezeigt werden. Wäre es möglich, die Anzeige etwas gezielter zu gestalten, also einige Anzeigen auszuschließen. Das geht sicher nicht auf die von Dir gefundene Weise, aber eventuell direkt über die Hilfedatei selbst, die ich mit dem XMLmind_XML_Editor erstellt habe und pflege. Ich habe es schon versucht, in dem Code für die Hilfe < expand="false" > Einträge einzubauen. Da ein "expand" über eine einzelne Anzeige hinaus wirkt, müsste man, wenn wieder angezeigt werden soll, gegensteuern. Ein einziges < expand="true" > in der jhelptoc.xml - Datei für die Hilfedatei-Datei bewirkt zwar den selben Effekt, wie Deine Lösung, aber eben nur solange keine Änderungen an der Hilfe vorgenommen werden.

Es grüßt Dich
kodela