chm.rst
changeset 1760 9504cbe2020d
parent 1759 6f62f6dccf2c
child 1761 ae4268e34402
--- a/chm.rst	Sat Sep 19 11:22:12 2015 +0300
+++ b/chm.rst	Sat Sep 19 13:38:09 2015 +0300
@@ -24,9 +24,9 @@
 =============
 
   http://www.imendio.com/projects/devhelp/
-                DevHelp is a GNOME based online help system aimed toward developers
+    DevHelp is a GNOME based online help system aimed toward developers
   http://en.wikipedia.org/wiki/MHTML
-                MHTML, short for MIME HTML
+    MHTML, short for MIME HTML
 
 Microsoft HTML Help.
 ====================
@@ -104,3 +104,32 @@
   $ 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.