+
−.. -*- coding: utf-8; -*-
+
−
+
−======
+
− CHM.
+
−======
+
−.. contents::
+
−   :local:
+
−
+
−Spec.
+
−=====
+
−
+
−  http://www.nongnu.org/chmspec/
+
−    HTML Help Projects.
+
−  http://chmspec.nongnu.org/
+
−    HTML Help Projects.
+
−  http://chmspec.nongnu.org/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.
+
−  http://kb.helpwaregroup.com/ms-html-help/hh_info
+
−     HH Info, version history
+
−  http://kb.helpwaregroup.com/ms-html-help/hh-faq
+
−     FAQ
+
−  http://mshelpwiki.helpmvp.com/mshelp/html-help
+
−     HTML Help.
+
−
+
−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.
+
−
+
− * https://en.wikipedia.org/wiki/Online_help
+
− * https://en.wikipedia.org/wiki/List_of_help_authoring_tools
+
−
+
−Microsoft HTML Help.
+
−====================
+
−
+
−  https://msdn.microsoft.com/en-us/library/ms669985
+
−    Microsoft HTML Help Downloads.
+
−  http://www.microsoft.com/en-us/download/details.aspx?id=21138
+
−    HTML Help Workshop and Documentation.
+
−  http://support.microsoft.com/kb/269766/
+
−    INFO: Limited Unicode Support in HTML Help.
+
−  http://www.help-info.de/en/Help_Info_HTMLHelp/hh.htm
+
−    Various links.
+
−
+
−Microsoft HTML Help under Debian.
+
−=================================
+
−
+
−Set Wine's Windows version to Windows 2000 (or above) via ``winecfg``.
+
−
+
−Install necessary dependency::
+
−
+
−  $ winetricks mfc40
+
−
+
−Alternatively manually download and install `Microsoft Foundation Classes update
+
−<http://activex.microsoft.com/controls/vc/mfc40.cab>`_::
+
−
+
−  $ wget http://activex.microsoft.com/controls/vc/mfc40.cab
+
−  $ cabextract mfc40.cab
+
−  $ wine mfc40.exe
+
−
+
−Download `Microsoft HTML Help Workshop
+
−<https://msdn.microsoft.com/en-us/library/ms669985.aspx>`_ and install it as
+
−(from non-``noexec`` FS!!)::
+
−
+
−  $ wine htmlhelp.exe
+
−
+
−Install ``itircl.dll`` and ``itss.dll`` from ``hhupd.exe`` which available in
+
−installer or in ``~/.wine/drive_c/Program Files/HTML Help Workshop/redist``::
+
−
+
−  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/
+
−
+
−You must add exception for ``hhc.exe`` and ``hhw.exe`` to use native variant of
+
−``itss.dll`` via ``winecfg``. Note: don't set ``itss.dll`` to native by default
+
−becase then ``wine hh`` wouldn't work.
+
−
+
−See:
+
−
+
− * http://code.google.com/p/htmlhelp/wiki/HHW4Wine
+
− * https://appdb.winehq.org/objectManager.php?sClass=version&iId=2978
+
− * https://bugs.winehq.org/show_bug.cgi?id=7517
+
−
+
−Viewer.
+
−=======
+
−::
+
−
+
−  $ sudo apt-get install xchm
+
−  $ sudo apt-get install gnochm
+
−
+
−  $ wine hh $FILE
+
−
+
−https://github.com/jungleji/chmsee
+
−  XUL based viewer.
+
−https://sourceforge.net/projects/chmreader/
+
−  Firefox extension.
+
−
+
−Decompiler.
+
−===========
+
−
+
−For Windows::
+
−
+
−  cmd> hh.exe -decompile %OUTDIR% %INFILE%.chm
+
−  cmd> 7z x -o%OUTDIR% %INFILE%.chm
+
−
+
−Under Linux::
+
−
+
−  $ 7z x -o$OUTDIR $INFILE.chm
+
−
+
−  $ sudo apt-get install libchm-bin
+
−  $ extract_chmLib $INFILE.chm $OUTDIR
+
−
+
−
+
−Cyrillic CHM files.
+
−===================
+
−
+
−In order to show Cyrillic tests in ``hh.exe`` or ``xchm``:
+
−
+
− * Use ``cp1251`` or ``cp866`` encoding for ``.html`` files.
+
−
+
− * Place corresponding::
+
−
+
−     <meta http-equiv="Content-Type" content="text/html; charset=cp1251">
+
−
+
−   or::
+
−
+
−     <meta http-equiv="Content-Type" content="text/html; charset=cp866">
+
−
+
−   into into ``<head>`` tag of  your ``.html`` files.
+
−
+
− * Use ``cp1251`` encoding for ``.hhc`` and ``.hhk`` and ``.stp`` files.
+
−
+
− * Add correcponding settings into your ``.hhp`` file::
+
−
+
−     [OPTIONS]
+
−     Language=0x419 Russian
+
−
+
−``<meta charset="cp1251">`` works for ``hh.exe`` but not for ``xchm``.
+
−
+
−Because ``cp1251`` contains all Cyrillic letters while ``cp866`` only Russian
+
−and content/index file require only ``cp1251`` I recommend to use only
+
−``cp1251`` for ``.html`` files.
+
−
+
−See:
+
−
+
− * http://kb.helpwaregroup.com/ms-html-help/hh-tips-tricks/jp
+
−