| author | Oleksandr Gavenko <gavenkoa@gmail.com> |
| Mon, 22 Feb 2016 12:46:36 +0200 | |
| changeset 1905 | fba288d59662 |
| parent 1763 | d4baabd053e7 |
| child 1912 | 8b81a8f0f692 |
| permissions | -rw-r--r-- |
|
1334
9bf0d5a1f0cf
Include common header with quick links.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1032
diff
changeset
|
1 |
.. -*- coding: utf-8; -*- |
|
9bf0d5a1f0cf
Include common header with quick links.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1032
diff
changeset
|
2 |
.. include:: HEADER.rst |
| 945 | 3 |
|
4 |
====== |
|
5 |
CHM. |
|
6 |
====== |
|
7 |
.. contents:: |
|
|
1905
fba288d59662
Include only local subsections into TOC. This prevent duplication of
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1763
diff
changeset
|
8 |
:local: |
| 945 | 9 |
|
10 |
Spec. |
|
11 |
===== |
|
12 |
||
13 |
http://www.nongnu.org/chmspec/ |
|
|
1748
f344879f1963
Unofficial CHM Specification.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1432
diff
changeset
|
14 |
HTML Help Projects. |
| 1763 | 15 |
http://chmspec.nongnu.org/ |
16 |
HTML Help Projects. |
|
17 |
http://chmspec.nongnu.org/latest/ |
|
|
1748
f344879f1963
Unofficial CHM Specification.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1432
diff
changeset
|
18 |
Unofficial (Preliminary) HTML Help Specification. |
|
f344879f1963
Unofficial CHM Specification.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1432
diff
changeset
|
19 |
http://savannah.nongnu.org/projects/chmspec |
|
f344879f1963
Unofficial CHM Specification.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1432
diff
changeset
|
20 |
Unofficial CHM Specification. |
| 945 | 21 |
http://www.speakeasy.org/~russotto/chm/chmformat.html |
|
1748
f344879f1963
Unofficial CHM Specification.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1432
diff
changeset
|
22 |
Matthew Russotto's Microsoft's HTML Help format description. |
| 945 | 23 |
http://msdn.microsoft.com/en-us/library/ms669980.aspx |
|
1748
f344879f1963
Unofficial CHM Specification.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1432
diff
changeset
|
24 |
HTML Help Frequently Asked Questions. |
| 1763 | 25 |
http://kb.helpwaregroup.com/ms-html-help/hh_info |
26 |
HH Info, version history |
|
27 |
http://kb.helpwaregroup.com/ms-html-help/hh-faq |
|
28 |
FAQ |
|
29 |
||
| 945 | 30 |
|
31 |
Alternatives. |
|
32 |
============= |
|
33 |
||
34 |
http://www.imendio.com/projects/devhelp/ |
|
| 1761 | 35 |
DevHelp is a GNOME based online help system aimed toward developers. |
| 945 | 36 |
http://en.wikipedia.org/wiki/MHTML |
| 1761 | 37 |
MHTML, short for MIME HTML. |
38 |
||
39 |
* https://en.wikipedia.org/wiki/Online_help |
|
40 |
* https://en.wikipedia.org/wiki/List_of_help_authoring_tools |
|
| 945 | 41 |
|
42 |
Microsoft HTML Help. |
|
43 |
==================== |
|
44 |
||
| 1763 | 45 |
https://msdn.microsoft.com/en-us/library/ms669985 |
|
1759
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
46 |
Microsoft HTML Help Downloads. |
|
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
47 |
http://www.microsoft.com/en-us/download/details.aspx?id=21138 |
|
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
48 |
HTML Help Workshop and Documentation. |
| 945 | 49 |
http://support.microsoft.com/kb/269766/ |
|
1759
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
50 |
INFO: Limited Unicode Support in HTML Help. |
| 1762 | 51 |
http://www.help-info.de/en/Help_Info_HTMLHelp/hh.htm |
52 |
Various links. |
|
| 945 | 53 |
|
|
1432
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
54 |
Microsoft HTML Help under Debian. |
|
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
55 |
================================= |
|
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
56 |
|
|
1759
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
57 |
Set Wine's Windows version to Windows 2000 (or above) via ``winecfg``. |
|
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
58 |
|
|
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
59 |
Install necessary dependency:: |
|
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
60 |
|
|
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
61 |
$ winetricks mfc40 |
|
1432
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
62 |
|
|
1759
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
63 |
Alternatively manually download and install `Microsoft Foundation Classes update |
|
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
64 |
<http://activex.microsoft.com/controls/vc/mfc40.cab>`_:: |
|
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
65 |
|
|
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
66 |
$ wget http://activex.microsoft.com/controls/vc/mfc40.cab |
|
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
67 |
$ cabextract mfc40.cab |
|
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
68 |
$ wine mfc40.exe |
|
1432
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
69 |
|
|
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
70 |
Download `Microsoft HTML Help Workshop |
|
1757
bf335700acbe
how fix "err:virtual:map_image failed to set 60000020 protection on section .text, noexec filesystem?"
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1753
diff
changeset
|
71 |
<https://msdn.microsoft.com/en-us/library/ms669985.aspx>`_ and install it as |
|
bf335700acbe
how fix "err:virtual:map_image failed to set 60000020 protection on section .text, noexec filesystem?"
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1753
diff
changeset
|
72 |
(from non-``noexec`` FS!!):: |
|
1432
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
73 |
|
|
1759
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
74 |
$ wine htmlhelp.exe |
|
1432
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
75 |
|
|
1759
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
76 |
Install ``itircl.dll`` and ``itss.dll`` from ``hhupd.exe`` which available in |
|
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
77 |
installer or in ``~/.wine/drive_c/Program Files/HTML Help Workshop/redist``:: |
|
1432
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
78 |
|
|
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
79 |
cabextract -F hhupd.exe htmlhelp.exe |
|
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
80 |
cabextract -F itircl.dll hhupd.exe |
|
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
81 |
cabextract -F itss.dll hhupd.exe |
|
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
82 |
cp -a itircl.dll ~/.wine/drive_c/windows/system32/ |
|
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
83 |
cp -a itss.dll ~/.wine/drive_c/windows/system32/ |
|
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
84 |
|
|
1759
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
85 |
You must add exception for ``hhc.exe`` and ``hhw.exe`` to use native variant of |
|
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
86 |
``itss.dll`` via ``winecfg``. Note: don't set ``itss.dll`` to native by default |
|
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
87 |
becase then ``wine hh`` wouldn't work. |
|
1757
bf335700acbe
how fix "err:virtual:map_image failed to set 60000020 protection on section .text, noexec filesystem?"
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1753
diff
changeset
|
88 |
|
|
1432
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
89 |
See: |
|
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
90 |
|
|
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
91 |
* http://code.google.com/p/htmlhelp/wiki/HHW4Wine |
|
1759
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
92 |
* https://appdb.winehq.org/objectManager.php?sClass=version&iId=2978 |
|
6f62f6dccf2c
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1757
diff
changeset
|
93 |
* https://bugs.winehq.org/show_bug.cgi?id=7517 |
|
1432
b7a7c8e89818
Microsoft HTML Help under Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1423
diff
changeset
|
94 |
|
| 945 | 95 |
Viewer. |
96 |
======= |
|
| 1423 | 97 |
:: |
| 945 | 98 |
|
99 |
$ sudo apt-get install xchm |
|
| 1423 | 100 |
$ sudo apt-get install gnochm |
| 945 | 101 |
|
| 1749 | 102 |
$ wine hh $FILE |
| 945 | 103 |
|
| 1753 | 104 |
Decompiler. |
105 |
=========== |
|
106 |
||
107 |
For Windows:: |
|
108 |
||
109 |
cmd> hh.exe -decompile %OUTDIR% %INFILE%.chm |
|
110 |
cmd> 7z x -o%OUTDIR% %INFILE%.chm |
|
111 |
||
112 |
Under Linux:: |
|
113 |
||
114 |
$ 7z x -o$OUTDIR $INFILE.chm |
|
115 |
||
116 |
$ sudo apt-get install libchm-bin |
|
117 |
$ extract_chmLib $INFILE.chm $OUTDIR |
|
118 |
||
119 |
||
|
1760
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
120 |
Cyrillic CHM files. |
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
121 |
=================== |
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
122 |
|
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
123 |
In order to show Cyrillic tests in ``hh.exe`` or ``xchm``: |
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
124 |
|
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
125 |
* Use ``cp1251`` or ``cp866`` encoding for ``.html`` files. |
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
126 |
|
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
127 |
* Place corresponding:: |
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
128 |
|
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
129 |
<meta http-equiv="Content-Type" content="text/html; charset=cp1251"> |
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
130 |
|
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
131 |
or:: |
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
132 |
|
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
133 |
<meta http-equiv="Content-Type" content="text/html; charset=cp866"> |
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
134 |
|
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
135 |
into into ``<head>`` tag of your ``.html`` files. |
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
136 |
|
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
137 |
* Use ``cp1251`` encoding for ``.hhc`` and ``.hhk`` and ``.stp`` files. |
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
138 |
|
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
139 |
* Add correcponding settings into your ``.hhp`` file:: |
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
140 |
|
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
141 |
[OPTIONS] |
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
142 |
Language=0x419 Russian |
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
143 |
|
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
144 |
``<meta charset="cp1251">`` works for ``hh.exe`` but not for ``xchm``. |
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
145 |
|
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
146 |
Because ``cp1251`` contains all Cyrillic letters while ``cp866`` only Russian |
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
147 |
and content/index file require only ``cp1251`` I recommend to use only |
|
9504cbe2020d
Cyrillic CHM files.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
1759
diff
changeset
|
148 |
``cp1251`` for ``.html`` files. |
| 1763 | 149 |
|
150 |
See: |
|
151 |
||
152 |
* http://kb.helpwaregroup.com/ms-html-help/hh-tips-tricks/jp |
|
153 |