Difference between revisions of "htmlhelp compiler"
m (minor edits spelling etc) |
|||
| (4 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | The htmlhelp compiler chmcmd is a htmlhelp1 (CHM) helpfile compiler. | + | == Overview == |
| + | The htmlhelp compiler chmcmd is a GPL licensed htmlhelp1 (CHM) helpfile compiler. | ||
| − | The | + | The help file compiler's main program only performs command line handling. All other functionality (including .hhp loading functionality and HTML scanning) is done by FPC's [[chm]] package, which is licensed under a more permissive license (LGPL with static linking exception) |
| − | Two formats are supported: | + | Two formats are supported: |
| + | * HTML help .hhp help projects (similar to those from the old Microsoft HTML Help workshop) | ||
| + | * a superset that stores all information (including context data) in one .XML. | ||
== History == | == History == | ||
| − | While the primary target of the [[chm]] package is the documentation tool [[fpdoc]], a small commandline utility chmcmd was added for testing purposes. This utility simply created a TCHMProject instance, would load the .xml, and called the "writechm" method. The XML format had to list all files to be included (including .css and image files). | + | While the primary target of the [[chm]] package is the documentation tool [[FPDoc Editor|fpdoc]], a small commandline utility chmcmd was added for testing purposes. This utility simply created a TCHMProject instance, would load the .xml, and called the "writechm" method. The XML format had to list all files to be included (including .css and image files). |
In 2010, basic .hhp support was added, and the project was expanded to scan input files for extra files. | In 2010, basic .hhp support was added, and the project was expanded to scan input files for extra files. | ||
| Line 19: | Line 22: | ||
The chm package has some support for doing the compression using multiple cores, but this has not been enabled by default for two reasons: | The chm package has some support for doing the compression using multiple cores, but this has not been enabled by default for two reasons: | ||
| − | + | # on Linux/FreeBSD this pulls in libpthread and libc which makes the binary distribution dependent (on FreeBSD and Linux, basic FPC binaries are fully static and use syscalls) | |
| − | + | # the savings are not that great (think 25% faster on a dual core) | |
A Win32 binary is currently about 420k (uncompressed, but stripped). | A Win32 binary is currently about 420k (uncompressed, but stripped). | ||
== Download == | == Download == | ||
| − | + | The HTML compiler is not available as a separate download, but is included in most FPC releases and snapshots. | |
| − | The | ||
[[Category:Help and Docs]] | [[Category:Help and Docs]] | ||
| + | [[Category:CHM]] | ||
Latest revision as of 22:18, 24 October 2015
Overview
The htmlhelp compiler chmcmd is a GPL licensed htmlhelp1 (CHM) helpfile compiler.
The help file compiler's main program only performs command line handling. All other functionality (including .hhp loading functionality and HTML scanning) is done by FPC's chm package, which is licensed under a more permissive license (LGPL with static linking exception)
Two formats are supported:
- HTML help .hhp help projects (similar to those from the old Microsoft HTML Help workshop)
- a superset that stores all information (including context data) in one .XML.
History
While the primary target of the chm package is the documentation tool fpdoc, a small commandline utility chmcmd was added for testing purposes. This utility simply created a TCHMProject instance, would load the .xml, and called the "writechm" method. The XML format had to list all files to be included (including .css and image files).
In 2010, basic .hhp support was added, and the project was expanded to scan input files for extra files.
Missing features
See chm
Performance
The performance probably won't be great. Mostly because the program is written in a portable manner.
The chm package has some support for doing the compression using multiple cores, but this has not been enabled by default for two reasons:
- on Linux/FreeBSD this pulls in libpthread and libc which makes the binary distribution dependent (on FreeBSD and Linux, basic FPC binaries are fully static and use syscalls)
- the savings are not that great (think 25% faster on a dual core)
A Win32 binary is currently about 420k (uncompressed, but stripped).
Download
The HTML compiler is not available as a separate download, but is included in most FPC releases and snapshots.
