SharpDevelop.HxS mit MS-Document Explorer öffnen?

[Jürgen Thomas]

Hallo,

ich möchte die #d-Hilfe direkt anschauen (einfach nur lesen und vielleicht einzelne Seiten drucken). Da es sich um Hx*-Dateien handelt, ist dafür doch wohl der Document Explorer zuständig?!

Leider gelingt es mir nicht, die Hilfe zu aktivieren:

Doppelclick auf die Datei öffnet zunächst den T-Online-Browser (vermutlich - das lässt das Datei-Icon vermuten, das habe ich aber noch untersucht - hatte dieser Browser sich mit HxS in der Registry verknüpft).

Danach folgt die Abfrage "Öffnen" oder "Speichern". Speichern führt praktisch zu einer Dateikopie unter "Eigene Dateien".

Öffnen holt sich den Document Explorer und liefert die Fehlermeldung:

Zitat:

Ungültige Befehlszeile
Unbekannter Schalter: (Pfad+Dateiname)

Aber irgendwie muss es doch auch bei HxS möglich sein, die Datei direkt zu öffnen (ohne das Programm)?!

Wenn ich dexplore.exe direkt starte, kann ich keine Hilfedatei auswählen:
Die Version 7 (2003) öffnet die NET-SDK-Doku (weil ich diese durch AutoStart immer öffne?).
Die Version 8 (2005) öffnet direkt nur die eigene Hilfe.

Danke für Tipps! Jürgen

[Khabarakh]

Bei mir haben die Dateien überhaupt keine Verknüpfung . Registrierte Hilfedateien kann ich jedoch per MDE und /helpcol-Parameter öffnen (getestet mit den Chrome-Helpfiles).

[MathiasSimmack]

Hah! Endlich ein Thema, bei dem ich auch mal wieder protzen kann.
Kurze Antwort: Ist nicht.

Die HxSen lassen sich nicht mehr direkt öffnen wie noch HLPs und CHMs. HxSen müssen im System registriert werden und lassen sich dann nur über den Help-Namespace via "ms-help://NamespaceName" öffnen. Man kann eine einzelne Hilfedatei so registrieren, oder aber auch einen ganzen Batzen als so genannte Collection. Abhilfe gibt es leider nur mit

Code:

dexplore /helpcol ms-help://NamespaceName

Du musst natürlich wissen, welche Namespaces es in deinem System gibt. Hier hilft dir das folgende kleine VBSkript (in Klammern der Namespace-Name)

Code:

On Error Resume Next
Dim registryWalker, help2Namespaces, help2Namespace

Set registryWalker    = CreateObject("HxDs.HxRegistryWalker")
Set help2Namespaces   = registryWalker.RegisteredNamespaceList("")

If registryWalker And help2Namespaces And help2Namespace.Count > 0 Then
   For I = 1 to help2Namespaces.Count
      Set help2Namespace = help2Namespaces.Item(I)

      If help2Namespace Then
         WScript.Echo help2Namespace.GetProperty(4) & " (" & help2Namespace.Name & ")"
      End If      
   Next
End If

Das einzige, das noch klappt, ist das direkte Öffnen einzelner Seiten aus HxSen, à la

Code:

ms-help://MS.MSSDK.1033/MS.WinSDK.1033/shellcc/platform/shell/reference/functions/shfileoperation.htm

per Browser. Aber selbst das ist, wie du sehen kannst, vom Namespace-Namen abhängig.

[Jürgen Thomas]

Zitat von MathiasSimmack:

Hah! Endlich ein Thema, bei dem ich auch mal wieder protzen kann. :lol:
Kurze Antwort: Ist nicht. :stupid:

Die HxSen lassen sich nicht mehr direkt öffnen wie noch HLPs und CHMs. HxSen müssen im System registriert werden und lassen sich dann nur über den Help-Namespace via "ms-help://NamespaceName" öffnen. Man kann eine einzelne Hilfedatei so registrieren, oder aber auch einen ganzen Batzen als so genannte Collection. Abhilfe gibt es leider nur mit

Code:

dexplore /helpcol ms-help://NamespaceName

Du musst natürlich wissen, welche Namespaces es in deinem System gibt.

Danke vielmals, das hilft mir bereits (nicht optimal, aber es geht): Wenn ich die Hilfe in #d öffne, wird mir angezeigt:

Code:

ms-help://Fidalgo/SharpMain/index.html

Also kann ich entsprechend Euren Tipps die Hilfe "direkt" öffnen (auch über einen Link):

Code:

dexplore /helpcol ms-help://Fidalgo/SharpMain

Warum einfach, wenn's auch umständlich geht... [/edit](Diese Bemerkung richtet sich an eine Firma in Richmond.)
Jürgen

[MathiasSimmack]

Zitat von Jürgen Thomas:

Warum einfach, wenn's auch umständlich geht... [/edit](Diese Bemerkung richtet sich an eine Firma in Richmond.)

Richmond? Oder Redmond?

Egal, zur Verteidigung besagter Firma: Die HxSen sind nicht als reguläre Benutzerhilfe gedacht. Dafür empfiehlt Microsoft auch weiterhin HLP und CHM. Die HxS-Hilfe wird an sich nur von Microsoft-Produkten (Visual Studio, usw.) genutzt. Wer als externe Firma oder Privatperson diese Hilfe nutzen will, muss sich eben an die Spielregeln halten. Und grundsätzlich ist die Idee dieser Hilfe gar nicht verkehrt. Klar, es ist schade, dass man eine Hilfedatei nicht mehr direkt öffnen kann. Das Problem könnte man aber umgehen, wenn man ein kleines Hilfstool schreibt, das sich im System einklinkt und beim Klick auf eine HxS-Datei diese temporär im System registriert und dann aufruft.

Auf der anderen Seite ist es aber unwichtig, wo sich eine Hilfedatei befindet, weil sie per Namespace aufgerufen werden kann. Jeder von euch könnte also zum Beispiel eigene Tutorials zur Help 2.0-Variante von Luckies Win32-API-Tutorials beisteuern, in eigenen Ordnern ablegen und trotzdem die vorhandenen Tutorials erweitern oder sogar ersetzen.



Edit:

Zitat von Jürgen Thomas:

Code:

ms-help://Fidalgo/SharpMain/index.html

Das bedeutet, "Fidalgo" ist der Namespace-Name, "SharpMain" ist die interne ID einer Hilfedatei. Ich habe das Ding selbst gemacht, ich sollte es wissen. Aber die Wahrheit ist, Fidalgo und Corsavy sind mittlerweile längst von meiner Platte runter.

Zitat:

Code:

dexplore /helpcol ms-help://Fidalgo[s]/SharpMain[/s]

sollte reichen.

[Jürgen Thomas]

Zitat von MathiasSimmack:

Richmond? Oder Redmond? :zwinker:

Nun ja, daran siehst Du, wie wichtig mir diese Firma (eigentlich) ist; aber die Produkte dieses Quasi-Monopolisten muss man ja nutzen.

Zitat von MathiasSimmack:

Egal, zur Verteidigung besagter Firma: Die HxSen sind nicht als reguläre Benutzerhilfe gedacht. Dafür empfiehlt Microsoft auch weiterhin HLP und CHM. Die HxS-Hilfe wird an sich nur von Microsoft-Produkten (Visual Studio, usw.) genutzt. Wer als externe Firma oder Privatperson diese Hilfe nutzen will, muss sich eben an die Spielregeln halten. Und grundsätzlich ist die Idee dieser Hilfe gar nicht verkehrt...

Auf der anderen Seite ist es aber unwichtig, wo sich eine Hilfedatei befindet, weil sie per Namespace aufgerufen werden kann. Jeder von euch könnte also zum Beispiel eigene Tutorials zur Help 2.0-Variante von Luckies Win32-API-Tutorials beisteuern, in eigenen Ordnern ablegen und trotzdem die vorhandenen Tutorials erweitern oder sogar ersetzen.

Ist das der Grund dafür, dass für #d eine solche Hilfe erzeugt wurde? Oder gibt es noch andere Gründe?

Zitat von MathiasSimmack:

Code:

dexplore /helpcol ms-help://Fidalgo

sollte reichen.

OK, also dann so.

Jürgen

[MathiasSimmack]

Zitat von Jürgen Thomas:

Ist das der Grund dafür, dass für #d eine solche Hilfe erzeugt wurde? Oder gibt es noch andere Gründe?

Vor meinem Help 2.0-Addin hat Fidalgo ganz normale CHM-Hilfedateien verwendet. Die Themen in der alten Hilfe kamen aus einer XML-Datei, wenn ich mich recht erinnere, und enthielten auch Verweise ins .NET Framework SDK.

Genau an der Stelle spielt das Help 2.0-System eine Stärke aus. Du kannst andere Hilfesammlungen als Plugin einklinken. Und weil Fidalgo auch eine eigene kleine Hilfe hatte, die den Umgang mit dem Programm erläutert, habe ich sie ins Help 2.0-Format umgewandelt und dann das komplette .NET Framework SDK als Plugin eingebunden.

Damit konnte das alte Hilfesystem entfernt werden.

[schöni]

Zitat von MathiasSimmack:

Hah! Endlich ein Thema, bei dem ich auch mal wieder protzen kann.
Kurze Antwort: Ist nicht.

Die HxSen lassen sich nicht mehr direkt öffnen wie noch HLPs und CHMs. HxSen müssen im System registriert werden und lassen sich dann nur über den Help-Namespace via "ms-help://NamespaceName" öffnen. Man kann eine einzelne Hilfedatei so registrieren, oder aber auch einen ganzen Batzen als so genannte Collection. Abhilfe gibt es leider nur mit

Code:

dexplore /helpcol ms-help://NamespaceName

Du musst natürlich wissen, welche Namespaces es in deinem System gibt. Hier hilft dir das folgende kleine VBSkript (in Klammern der Namespace-Name)

Code:

On Error Resume Next
Dim registryWalker, help2Namespaces, help2Namespace

Set registryWalker    = CreateObject("HxDs.HxRegistryWalker")
Set help2Namespaces   = registryWalker.RegisteredNamespaceList("")

If registryWalker And help2Namespaces And help2Namespace.Count > 0 Then
   For I = 1 to help2Namespaces.Count
      Set help2Namespace = help2Namespaces.Item(I)

      If help2Namespace Then
         WScript.Echo help2Namespace.GetProperty(4) & " (" & help2Namespace.Name & ")"
      End If      
   Next
End If

Das einzige, das noch klappt, ist das direkte Öffnen einzelner Seiten aus HxSen, à la

Code:

ms-help://MS.MSSDK.1033/MS.WinSDK.1033/shellcc/platform/shell/reference/functions/shfileoperation.htm

per Browser. Aber selbst das ist, wie du sehen kannst, vom Namespace-Namen abhängig.

Gibt es da einen Workaround dergestalt, das ich den Code des Scriptes in Delphi schreibe?

In TurboDelphi habe ich ja schon mal in der Objektgalerie eine "Anwendung für die Systemsteuerung" gefunden. Leider brauche ich die, um die Hilfe für Turbo Delphi erst wieder verfügbar zu machen. Habe leider kein Visual-Basic installiert. Deshalb will ich das mit Delphi erledigen.

[MathiasSimmack]

Ist das hier noch relevant? Falls Ja: Ich habe dir mal den Quellcode meines alten Help 2.0-Viewers rausgesucht. Vielleicht hilft er dir irgendwie weiter.

Du musst aber die Typbibliothek "Microsoft Help Data Services" importieren, sonst bekommst du keinen Kontakt zum Hilfesystem. Du kannst auch gleich noch die "Microsoft Help Visuals"-Bibliothek importieren, dann hättest du Zugang zu den Controls. Ist für dein Thema weniger relevant, aber so kann man einen eigenen Hilfebetrachter à la Document Explorer bzw. integrierte Hilfe in SharpDevelop bauen.