MS Help 2.0 Collection Registrierung
Jede MS Help 2 Collection muss, bevor sie angesehen werden kann, registriert werden. Beim Registrieren wird jeder Collection ein eindeutiger Name zugewiesen. Dieser Name nennt sich „Namespace“. Dies hat den Nachteil, dass Hilfesysteme nicht mehr installiert werden können ohne dass sie registriert werden.
Es gibt zwei Arten von Collections: 1. die nur eine einzige Hilfedatei
enthalten und 2. die zwei oder mehrere Hilfedateien enthalten. Bei der unter 1.
genannten Möglichkeit kann die .HxC Datei beides sein, Collectionsdatei und
Hilfedatei. Bei der 2. Möglichkeit, der Collection mit mehreren Hilfedateien,
werden diese durch eine .HxC Collectionsdatei definiert.
In diesem Fall arbeitet man mit zwei .HxC Dateien:
Eine als Projektdatei, mit allen notwendigen Informationen um die Hilfedatei zu
kompilieren (wird nur zum Zeitpunkt der Kompilierung benötigt) und eine als
Collectionsdatei. Diese letztgenannte Datei enthält Informationen darüber, wie
die einzelnen Hilfedateien miteinander gemergt sind. Logischerweise muss diese
Datei immer mit den Hilfedateien zusammen weitergegeben werden.
Es wird möglich sein, Software auf verschiedenen Computern in verschiedenen Verzeichnissen zu installieren. Die gleiche URL für ein Thema wird bei den unterschiedlichen Installationen funktionieren, vorausgesetzt die Kollektion wurde mit dem gleichen Namespace und den gleichen ThemenID’s registriert. Es ist also ein Vorteil, dass die Collections über ihre Namespaces aufgerufen werden.
Aufgrund der neuen Form der Registrierung ändert sich auch die Syntax beim
direkten Aufrufen eines Themas in der Hilfe. Dies sieht nun wie folgt aus: ms-help://namespace/ThemenID/pfadintern/thema.htm
Hierbei identifiziert //namespace die Collection und /ThemenID die Hilfedatei
innerhalb der Kollektion. Durch /pfadintern/thema.htm wird wie bisher der
interne Pfad und Name der Themenseite angegeben.
Es gibt zwei Stufen der Registrierung einer MS Help Collection:
1. Registrierung der Collection durch die .HxS oder .HxC Datei unter einem
eindeutigen Namespace.
2. Registrierung einer oder mehrerer .HxS Dateien in eine Collection. Jede
Hilfedatei muss hierbei eine eindeutige ThemenID erhalten.
MVP Rob Chandler stellt ein gesondertes Tool zur Registrierung der Collection zur Verfügung:
http://helpware.net/mshelp2/h2reg.htm
Ausführliche Informationen zur Registrierung ebenfalls bei Rob, als Collection Tutorial:
http://www.helpware.net/mshelp2/h2tutorial.htm
Ein großer Teil dieser Erläuterungen wurde von MVP Robert Chandler zusammengetragen und kann bei ihm in englischer Sprache nachgelesen werden.
