Would it be possible to add olink support for HTML Help
output of XSL stylesheets. While searching the mailing
lists, I could see that this feature was planned
already for some time, but probably never realized.
There are two uses for olinks:
1. Use them between modular files within the same
document.
2. Use them between different documents.
In the case of the htmlhelp stylesheet, the first usage
works, where olinks can be used to form internal links
within an CHM file.
Regarding linking between documents, I don't know how to
link from one CHM file to another. Is there some standard
syntax that is used for that? Is there a reference
document that describes it in detail?
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
I looked around and found out some info about linking
between CHM files. You can simlpy look at the help of the
HTML Help workshop itself, search for index entry "linking
to another help file". It suggests the link format:
<A HREF="ms-its:file name.chm::/topic.htm">
I just checked in support to htmlhelp-common.xsl to generate the olink target data file when the collect.xref.targets parameter is not set to 'no'. This generates the target data that should work for olinks in CHM files.
However, the target.database.document (typically named olinkdb.xml) must have some specific syntax for olinks to work. Specifically, the baseuri attribute of a <document> element must look like this:
baseuri="ms-its:mybook1.chm::/output/"
where "ms-its:" is a required string
"mydbook1.chm" is the name of the compiled CHM file for that document
"::/" is a required string
"output/" is any $base.dir parameter value used when building the HTML files.
This set up works when the CHM files are installed into the same directory.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
This Tracker item was closed automatically by the system. It was
previously set to a Pending status, and the original submitter
did not respond within 14 days (the time period specified by
the administrator of this Tracker).
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Logged In: YES
user_id=193218
There are two uses for olinks:
1. Use them between modular files within the same
document.
2. Use them between different documents.
In the case of the htmlhelp stylesheet, the first usage
works, where olinks can be used to form internal links
within an CHM file.
Regarding linking between documents, I don't know how to
link from one CHM file to another. Is there some standard
syntax that is used for that? Is there a reference
document that describes it in detail?
Logged In: YES
user_id=1601455
I looked around and found out some info about linking
between CHM files. You can simlpy look at the help of the
HTML Help workshop itself, search for index entry "linking
to another help file". It suggests the link format:
<A HREF="ms-its:file name.chm::/topic.htm">
Alternatively, the same info is available through MSDN:
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/hworiHTMLHelpStartPage.asp
See for example topic
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/vsconOverlrg.asp
I also found this e-mail from Jirka Kosek:
http://sources.redhat.com/ml/docbook-apps/2003-q3/msg00699.html
which is about three years old and mentions already some
plans to implement this. So maybe Jirka has more ideas or
additional knowledge.
Logged In: YES
user_id=1601455
Two more links:
http://www.helpware.net/htmlhelp/how_to_merge.htm
http://www.helpware.net/htmlhelp/linktochm.htm
I just checked in support to htmlhelp-common.xsl to generate the olink target data file when the collect.xref.targets parameter is not set to 'no'. This generates the target data that should work for olinks in CHM files.
However, the target.database.document (typically named olinkdb.xml) must have some specific syntax for olinks to work. Specifically, the baseuri attribute of a <document> element must look like this:
baseuri="ms-its:mybook1.chm::/output/"
where "ms-its:" is a required string
"mydbook1.chm" is the name of the compiled CHM file for that document
"::/" is a required string
"output/" is any $base.dir parameter value used when building the HTML files.
This set up works when the CHM files are installed into the same directory.
This Tracker item was closed automatically by the system. It was
previously set to a Pending status, and the original submitter
did not respond within 14 days (the time period specified by
the administrator of this Tracker).