.. -*- coding: utf-8; -*-
.. include:: HEADER.rst

======
 CHM.
======
.. contents::

Spec.
=====

  http://www.nongnu.org/chmspec/
    HTML Help Projects.
  http://www.nongnu.org/chmspec/latest/
    Unofficial (Preliminary) HTML Help Specification.
  http://savannah.nongnu.org/projects/chmspec
    Unofficial CHM Specification.
  http://www.speakeasy.org/~russotto/chm/chmformat.html
    Matthew Russotto's Microsoft's HTML Help format description.
  http://msdn.microsoft.com/en-us/library/ms669980.aspx
    HTML Help Frequently Asked Questions.

Alternatives.
=============

  http://www.imendio.com/projects/devhelp/
                DevHelp is a GNOME based online help system aimed toward developers
  http://en.wikipedia.org/wiki/MHTML
                MHTML, short for MIME HTML

Microsoft HTML Help.
====================

  http://msdn.microsoft.com/en-us/library/ms669985
                Microsoft HTML Help Downloads
  http://support.microsoft.com/kb/269766/
                INFO: Limited Unicode Support in HTML Help

Microsoft HTML Help under Debian.
=================================

Set Wine's Windows version to Windows 2000 (or above), and add an override to
use the native itss.dll, both via ``winecfg``::

  wine winecfg

Download `Microsoft HTML Help Workshop
<http://msdn.microsoft.com/library/en-us/htmlhelp/html/hwMicrosoftHTMLHelpDownloads.asp>`_
and install it as::

  wine htmlhelp.exe

Install itircl.dll and itss.dll as::

  cabextract -F hhupd.exe htmlhelp.exe
  cabextract -F itircl.dll hhupd.exe
  cabextract -F itss.dll hhupd.exe
  cp -a itircl.dll ~/.wine/drive_c/windows/system32/
  cp -a itss.dll ~/.wine/drive_c/windows/system32/
  wine regsvr32 /s 'C:\WINDOWS\SYSTEM32\itircl.dll'
  wine regsvr32 /s 'C:\WINDOWS\SYSTEM32\itss.dll'

Download `Microsoft Foundation Classes update
<http://activex.microsoft.com/controls/vc/mfc40.cab>`_, extract it, and install
it as::

  wget http://activex.microsoft.com/controls/vc/mfc40.cab
  cabextract mfc40.cab
  wine mfc40.exe
  wget -N http://activex.microsoft.com/controls/vc/mfc40.cab
  cabextract -F mfc40.exe mfc40.cab
  cabextract -F mfc40.dll mfc40.exe
  cp -a mfc40.dll ~/.wine/drive_c/windows/system32/

See:

 * http://code.google.com/p/htmlhelp/wiki/HHW4Wine

Viewer.
=======
::

  $ sudo apt-get install xchm
  $ sudo apt-get install gnochm

  $ wine hh $FILE