MS Document Explorer customizen

[Phoenix]

Hi,

eine Frage für alle, die das MSDN haben

Sowohl die Borland-Hilfe von D8 als auch das MSDN verwenden den Microsoft Document Explorer. Bei beiden wird jeweils das Menu nur auf die eingetragenen Sparten begrenzt.

Wie kann ich nun das MSDN - Inhaltsverzeichnis in die Delphi-Hilfe integrieren oder auch die Delphi-Hilfe in das MSDN - Inhaltsverzeichnis?

Das müsste doch irgendwie gehen, sonst hab ich für D8 und fürs MSDN jeweils einen eigenen Document Explorer auf, und das tut eigentlich nicht not...

[Phoenix]

Neuer Tag, neues Glück... *nochmal nach oben Schieb*

[MathiasSimmack]

Meinst du so was wie im Bild (s. Anhang)?
Na ja, das ist aber nicht ganz einfach -

Die neuen Hilfedateien werden durch Namespaces identifiziert. Das PSDK nutzt bspw. "MS.PSDK.1033". Irgendwelche Konfig-Dateien ändern ist also nicht. Hol dir von www.helpware.net das Programm FAR und installiere und starte es.

Klick auf die Registerseite "Authoring" und dort auf den Button "H2 Utils". Es öffnet sich ein Dialog mit allen bekannten HxS-Namespaces. Wenn du bspw. das PSDK in die Borland-Hilfe integrieren willst, dann wähle "borland.bds2" und mach einen Doppelklick.

Im nächsten Dialog gehst du auf die Seite "Plug-ins" und klickst auf "Add". Den oberen Teil im nächsten Fenster lässt du unverändert, denn der identifiziert ja die Borland-Hilfe. Im unteren Teil suchst du bei "Child Namespace" den vom PSDK raus, den Rest lässt du unverändert.
Wenn du auf OK klickst, kann es sein, dass das Programm die fehlende Attributdatei (*.HxA) bemängelt. Mach dir nichts draus.

Dann mach alles zu und starte die Borland-Hilfe. Es könnte ein Weilchen dauern, solange siehst du eben die Meldung, dass die Hilfe aktualisiert wird. Aber danach ist das PSDK drin.

Allerdings sieht es nicht besonders gut aus, weil das PSDK Top-Level-Knoten im Inhaltsverzeichnis benutzt. Das heißt, es gibt keine visuelle Trennung zwischen Borland-Hilfe und PSDK wie das bspw. beim .NET-Framework der Fall ist. Aber das liegt daran, dass Borland dort die Themen (sprich: Hilfedateien des .NET-Framework) separat gemappt hat und daher alles einem Knoten unterordnen konnte. Das merkst du übrigens, wenn du dir in FAR mal die Titel ansiehst, die zum Borland-Namespace gehören (H2 Utils -> borland.bds2 -> Titles).
Um den gleichen Effekt zu erzielen, müsstest du also a) alle Hilfedateien des PSDK noch einmal unter dem Borland-Namespace eintragen, und b) das Inhaltsverzeichnis der Borland-Collection (%bdsdir%\help\common\bds2.HxT = ist ´ne XML-Datei) entsprechend erweitern. Zuviel Arbeit, wie ich finde.

Gruß.

[Phoenix]

Klasse. Genau das habe ich gesucht

Tja, die Hilfe-Dateien sind anscheinend nicht mehr so ganz trivial wie früher. Kennst Du ausser Helpware.net vielleicht noch ein paar Links zu dem Thema die mir da auch beim Erstellen von Hilfedateien weiterhelfen können?

[MathiasSimmack]

Welche Hilfedateien?

Für die HLPs und CHMs würde ich dich auf die Win32-API-Tutorials von Luckie verweisen. Da gibt´s ein Kapitel darüber. Zu den HxS-en habe ich noch nichts geschrieben. Ich überlege, evtl. entsteht als Resultat meiner Arbeit ´ne PDF oder so. Denn: Im Prinzip sind die schnell gemacht. Ich habe ja noch ´ne Beta vom VS.NET rumliegen. Also habe ich mir ´ne extra Partition eingerichtet, damit ich die Beta nicht auf mein gutes Windows klatschen muss. Dann das VS.NET rauf, bei Microsoft das VSHIK (Link s. helpware.net) geholt, installiert, und schon kann´s losgehen.

Ich habe bspw. einfach nur die CHM-Projektdateien der Win32-API-Tutorials konvertiert. Ein paar spezielle Dinge muss man per Hand machen. Aber lustig ist es. Die Filter bspw. Du schaltest ihn auf "Common Controls", dann wird alles andere ausgeblendet. Und das klappt Dokumenten-weise. Sprich: Du kannst die HTML-Seite #1 anzeigen lassen, während die Seite #2 (in der gleichen Datei) verschwindet. Muss man zwar selbst machen, aber irgendwie hat´s was.

Merkt man, dass mich so was begeistert?

Mein Angebot (s. Link) steht übrigens noch.

[Phoenix]

@Mathias:

Nun habe ich die Borland Hilfe ins MSDN gepackt.
Blöderweise wird die Borlandhilfe nun nicht mehr gestartet, wenn ich in Delphi auf Hilfe drücke, sondern ich kann sie nur noch über das MSDN starten

Gibts da ne Lösung für?

[MathiasSimmack]

ich vermute mal Ja, aber entschuldige die dumme Frage: Hast du dich an die Anleitung gehalten? Ich habe zwar nicht das MSDN, sondern ich habe die Borland-Hilfe mal fix ins PSDK gepackt. Aber ich kann die Hilfe auch nach wie vor aus Borland heraus starten.

Hast du versehentlich den Namespace (borland.bds2) umbenannt?

[Phoenix]

Erm... nein, habe ich nicht. Ich habe nur C# Builder 1 Personal installiert. (Der geht auch irgendwie auf BDS).

Zumindest finde ich nun in der Borland UND in dem gepluggten Teil des MSDN nur noch die C# Builder Hilfe und nichts mehr von meinem D8.

[MathiasSimmack]

Evtl. mit den Filtern rumgespielt?

[Phoenix]

Nein auch nicht. Immer wenn ich die Hilfe jetzt aufrufen will kommt eine Box, die nach einem Pfad fragt, von wegen C:\Programme\Borland\BDS\2.0\Help\Common - da will er dann die bds2start.HxS, die gebe ich an, aber der Dialog kommt immer wieder.