Oracle Help
From Just Solve the File Format Problem
(Difference between revisions)
(Created page with "{{FormatInfo |formattype=electronic |subcat=Help files |extensions={{ext|hs}}, {{ext|xml}}, {{ext|toc}}, {{ext|tok}}, {{ext|idx}} |released=≤2001<ref>https://web.archive.org...") |
(Speculation on relationship with JavaHelp - "It is possible that...") |
||
Line 5: | Line 5: | ||
|released=≤2001<ref>https://web.archive.org/web/20010129073900/http://www.ehelp.com/RoboHelp/web/oraclehelp.shtm</ref> | |released=≤2001<ref>https://web.archive.org/web/20010129073900/http://www.ehelp.com/RoboHelp/web/oraclehelp.shtm</ref> | ||
}} | }} | ||
− | '''Oracle Help''' is a help "system" consisting of a common format, and software for two modes of playback: '''Oracle Java Help''', a help viewer embedded in a [[Java]] program; and '''Oracle Web Help''', a help viewer that serves pages over [[HTTP]]. Oracle Help's format appears to have been based on that of [[JavaHelp]], though curiously it was released long before Sun (the creator of JavaHelp) was bought by Oracle. | + | '''Oracle Help''' is a help "system" consisting of a common format, and software for two modes of playback: '''Oracle Java Help''', a help viewer embedded in a [[Java]] program; and '''Oracle Web Help''', a help viewer that serves pages over [[HTTP]]. Oracle Help's format appears to have been based on that of [[JavaHelp]], though curiously it was released long before Sun (the creator of JavaHelp) was bought by Oracle. It is possible that it was originally completely different (perhaps explaining the "old version" referenced in some documentation), and was made to resemble JavaHelp after Sun was acquired. |
The formats a single "HelpSet" uses include: | The formats a single "HelpSet" uses include: |
Revision as of 09:15, 18 December 2020
Oracle Help is a help "system" consisting of a common format, and software for two modes of playback: Oracle Java Help, a help viewer embedded in a Java program; and Oracle Web Help, a help viewer that serves pages over HTTP. Oracle Help's format appears to have been based on that of JavaHelp, though curiously it was released long before Sun (the creator of JavaHelp) was bought by Oracle. It is possible that it was originally completely different (perhaps explaining the "old version" referenced in some documentation), and was made to resemble JavaHelp after Sun was acquired.
The formats a single "HelpSet" uses include:
- HelpSet file, extension ".hs", which provides metadata about the whole help set, and the names of other files;[2]
- map files, XML files (with the extension .xml[3]) that map topic IDs (strings identifying individual help topics) to HTML content files;
- table of contents files, extension .xml[4], though and "old [relative to 2011] version" had extension .toc[5], which give tables of contents;
- index files, extension .xml[5], .tok for the "old version"[5], which give (human-readable) indexes;
- search index files, in "a proprietary binary format"[6] with extension ".idx"[7] that stores a text search index, and is generated by a program distributed with Oracle Help[8];
- link files, similar to map files, but which map link IDs (aliases used in the targets of links on content pages, in lieu of actual destination file names) to topic IDs (which are in turn mapped to content files)[9]
- the "topic files", HTML files that hold the actual content of the help[10].
Contents |
Specifications
Links
See Also
References
- ↑ https://web.archive.org/web/20010129073900/http://www.ehelp.com/RoboHelp/web/oraclehelp.shtm
- ↑ https://docs.oracle.com/middleware/1213/jdev/develop-help/orahelp-metadata-files.htm#CACJACAB
- ↑ https://docs.oracle.com/middleware/1213/jdev/develop-help/orahelp-metadata-files.htm, section 5.2.3, example
- ↑ https://docs.oracle.com/middleware/1213/jdev/develop-help/orahelp-metadata-files.htm, section 5.2.6, following "If both of the labels were the same"
- ↑ 5.0 5.1 5.2 https://web.archive.org/web/20110418143359/http://www.oracle.com/technetwork/topics/faq-099989.html, "How do I convert help files created in other authoring systems to Oracle Help format?"
- ↑ https://docs.oracle.com/middleware/1213/jdev/develop-help/orahelp-helpinfo-files.htm, section 6.5
- ↑ https://docs.oracle.com/middleware/1213/jdev/develop-help/orahelp-text-search-index.htm
- ↑ https://docs.oracle.com/middleware/1213/jdev/develop-help/orahelp-text-search-index.htm
- ↑ https://docs.oracle.com/middleware/1213/jdev/develop-help/orahelp-helpinfo-files.htm, section 6.6
- ↑ https://docs.oracle.com/middleware/1213/jdev/develop-help/orahelp-topic-files.htm