WinHelp in Delphi2005

[Stevie]

Hi Leute,

da ich im Moment dran bin, nen HelpBuilder zu bauen, der aus Source-Dateien eine WinHelp-Datei im Stil der Delphi7/VCL-Hilfe erstellt, hab ich mich gefragt, ob das in Delphi2005 auch geht. Ich hab mal geguckt, wie das mit der WinHelp 2.0 aussieht, aber die scheint von Mircosoft aber nicht offiziel herausgegeben worden zu sein. Wie implementiert man denn jetzt die Hilfedateien in Delphi2005? Ich hab da nix gefunden, wie in Delphi7 dieses "Anpassen"!

MfG
Stevie

[Bernhard Geyer]

Ich habe zwar keine Lösung für dein Delphi 2005-Problem. Ich denke auch das du dieses Merging eher im Viewer einstellen müßtest (wenn es überhaupt geht).

Aber für deine Aufgabenstellung gibt es doch schon fertige Tools wie Time2Help?

[Stevie]

Pff, ich kenn diese Pseudo-so-wie-DelphiHilfe-aussehenden-Winhelps!
Ok, das Tool hab ich noch nicht ausprobiert, aber ich seh nirgendwo auf der Page nen Screenshot, wie's aussehen soll!

Kann dieses Tool ne Hilfe-Datei erstellen, die siche komplett in die VCL integriert? (Links auf Vorgängerklasse, ererbte Methoden, Events, Properties)???

[MathiasSimmack]

Zitat von Stevie:

Ich hab mal geguckt, wie das mit der WinHelp 2.0 aussieht, aber die scheint von Mircosoft aber nicht offiziel herausgegeben worden zu sein.

Richtig. War mal vorgesehen, allerdings ist die Help 2.0 jetzt auf Entwicklungsumgebungen beschränkt.

Zitat:

Wie implementiert man denn jetzt die Hilfedateien in Delphi2005? Ich hab da nix gefunden, wie in Delphi7 dieses "Anpassen"!

Du kannst mich fragen. Ich weiß das , weil Hilfedateien an sich zu meinen Interessen gehören. Jede Help 2.0-Hilfedatei besitzt einen Namespace, dem sie angehört. Dieser Namespace muss in einen anderen integriert werden, damit die Hilfe dort erscheint. Dazu ist ein Tool notwendig, weil der Zugriff auf die Help 2.0-Namespaces nicht per INI oder Registry sondern via separatem API realisiert wird. Ein recht gutes Tool ist H2Reg von Rob Chandler. Ich persönlich nutze mein eigenes. Anwendungsbeispiel: s. Win32-API-Tutorials als HxS-Version (Help 2.0), die sich in die Delphi 2005-Hilfe integrieren.

Was das hier angeht

Zitat:

komplett in die VCL integriert

kann ich nichts dazu sagen. Ich schätze, das ist eine Sache der Hilfeimplementation von Delphi. Wenn du dafür sorgst, dass die Schlüsselworte bekannt sind (sprich: Kontexthilfe oder F-Keyword bei Help 2.0), dann müsste/sollte/könnte Delphi das passende Thema anzeigen. Behauptung ohne Garantie

[Bernhard Geyer]

Zitat von Stevie:

Pff, ich kenn diese Pseudo-so-wie-DelphiHilfe-aussehenden-Winhelps!
Ok, das Tool hab ich noch nicht ausprobiert, aber ich seh nirgendwo auf der Page nen Screenshot, wie's aussehen soll!

Es gibt eine Beispiel, jedoch nur für die HTML-Hilfe (nicht Hlp/CHM-Hilfe). Aber einfach Demo herunterladen und ein kleines Beispiel zusammenbauen.

Zitat von Stevie:

Kann dieses Tool ne Hilfe-Datei erstellen, die siche komplett in die VCL integriert? (Links auf Vorgängerklasse, ererbte Methoden, Events, Properties)???

Evtl. ja. (Ausprobieren). Habs bisher nur als CHM und externe Hilfe verwendet.

[Stevie]

Zitat von MathiasSimmack:

Du kannst mich fragen. Ich weiß das , weil Hilfedateien an sich zu meinen Interessen gehören. Jede Help 2.0-Hilfedatei besitzt einen Namespace, dem sie angehört. Dieser Namespace muss in einen anderen integriert werden, damit die Hilfe dort erscheint. Dazu ist ein Tool notwendig, weil der Zugriff auf die Help 2.0-Namespaces nicht per INI oder Registry sondern via separatem API realisiert wird. Ein recht gutes Tool ist H2Reg von Rob Chandler. Ich persönlich nutze mein eigenes. Anwendungsbeispiel: s. Win32-API-Tutorials als HxS-Version (Help 2.0), die sich in die Delphi 2005-Hilfe integrieren.

Was das hier angeht

Zitat:

komplett in die VCL integriert

kann ich nichts dazu sagen. Ich schätze, das ist eine Sache der Hilfeimplementation von Delphi. Wenn du dafür sorgst, dass die Schlüsselworte bekannt sind (sprich: Kontexthilfe oder F-Keyword bei Help 2.0), dann müsste/sollte/könnte Delphi das passende Thema anzeigen. Behauptung ohne Garantie

Ok, Fragen!
Was muss ich jetzt konkret erstellen, um meine Kompo-Hilfe in Delphi2005 einzubauen?
Gibt's nen Decompiler für 2.0, damit ich gucken kann, wie der Style genau aussieht, oder gibt's ne andere Möglichkeit?

Nachtrag @Bernhard Geyer: Das Tool sieht ja ganz nett aus, und kommt auch in etwa in die Richtung, die ich einschlage, aber die Hilfe-Datei gewinnt auch leider keinen Schönheitspreis.

[MathiasSimmack]

Zitat von Stevie:

Was muss ich jetzt konkret erstellen, um meine Kompo-Hilfe in Delphi2005 einzubauen?

Ich nehme an, eine Help 2.0-Hilfedatei. Das ist das HxS-Format. Inwieweit Delphi 2005 dann die richtigen Themen anzeigt, kann ich dir nicht sagen. Es gibt immerhin Probleme mit der an sich offiziellen Hilfe von Borland, die einige Begriffe nicht kennt bzw. nichts dazu findet. Ob das auch bei anderen Hilfedateien (deiner eigenen) auftritt, kann ich dir nicht sagen. Aber es wäre zu befürchten.

Zitat:

Gibt's nen Decompiler für 2.0, damit ich gucken kann, wie der Style genau aussieht, oder gibt's ne andere Möglichkeit?

Ja, hole dir mal das Visual Help Integration Kit von Microsoft. Das ist so eine Art Helpworkshop. Allerdings setzt der was vom Visual Studio voraus. Es sei denn, *hüstel* man ändert das und gibt sich mit den Kommandozeilentools zufrieden. Dazu verweise ich dich auch auf die Helpware-Seite. Da steht´s drauf. Es ist rechtlich ein bisschen heikel, deswegen möchte ich nix weiter dazu sagen. Wie dem auch sei, der Decompiler ist dann quasi eingebaut.

Zitat:

Nachtrag @Bernhard Geyer: Das Tool sieht ja ganz nett aus, und kommt auch in etwa in die Richtung, die ich einschlage, aber die Hilfe-Datei gewinnt auch leider keinen Schönheitspreis.

Bin zwar nicht Bernhard, aber ... Ähem, liegt das nicht an dir. Help 2.0 ist doch auch bloß HTML und CSS.

[Stevie]

Naja, solange noch nichtmal die "offizielle Hilfe" von Delphi2005 richtig funktioniert, lass ich sowieso lieber die Finger davon!

Natürlich liegt's (zumindest, was WinHelp angeht) an mir, wie die Hlp aussieht. Und leider hab ich noch nix gefunden, was vernünftig aussieht, sprich Delphi-Look&Feel hat! Die Programme sind alle mehr oder weniger toll zu bedienen, aber der Output ist IMHO zum

[MathiasSimmack]

Deswegen mache ich meine HTMLs per Hand und nutze den Kommandozeilen-Compiler zum Erzeugen der Hilfedateien.

[Bernhard Geyer]

Zitat von Stevie:

Nachtrag @Bernhard Geyer: Das Tool sieht ja ganz nett aus, und kommt auch in etwa in die Richtung, die ich einschlage, aber die Hilfe-Datei gewinnt auch leider keinen Schönheitspreis.

Welche? Die als Demo auf der Webseite. Diese ist ja auch "nur" reines HTML und keine CHM-Datei.