|
1 | | -# uChmViewer |
| 1 | +uChmViewer |
| 2 | +================================================================================ |
2 | 3 |
|
3 | | -This is a fork of the [kchmviewer](http://www.ulduzsoft.com/linux/kchmviewer) with some improvements. |
| 4 | +This is a fork of the [KchmViewer](http://www.ulduzsoft.com/linux/kchmviewer) |
| 5 | +with some improvements. uChmViewer is a chm (MS HTML help file format) and epub |
| 6 | +viewer, written in C++ using Qt framework. |
4 | 7 |
|
5 | 8 | - [Overview](#overview) |
6 | | -- [What's new](#whats-new) |
7 | 9 | - [Features](#features) |
8 | 10 | - [Getting uChmViewer](#getting-uchmviewer) |
9 | 11 | - [Usage](#usage) |
10 | 12 | - [Thanks](#thanks) |
11 | 13 | - [License](#license) |
12 | 14 |
|
13 | 15 |
|
14 | | -## Overview |
| 16 | +Overview |
| 17 | +-------------------------------------------------------------------------------- |
15 | 18 |
|
16 | | -KchmViewer is a chm (MS HTML help file format) and epub viewer, written in C++. Unlike most existing CHM viewers for Unix, it uses Trolltech Qt widget library, and does not depend on KDE or GNOME. |
| 19 | +The main advantage of uChmViewer is extended support for non-English languages. |
| 20 | +Unlike others, uChmViewer in most cases correctly detects chm file encoding, |
| 21 | +correctly shows tables of context of Russian, Korean, Chinese and Japanese help |
| 22 | +files. It also correctly searches text in non-English help files, including |
| 23 | +Korean, Chinese and Japanese. |
17 | 24 |
|
18 | | -The main advantage of KchmViewer is extended support for non-English languages. Unlike others, KchmViewer in most cases correctly detects chm file encoding, correctly shows tables of context of Russian, Korean, Chinese and Japanese help files. It also correctly searches text in non-English help files, including Korean, Chinese and Japanese. |
| 25 | +Original KchmViewer is written by [Georgy Yunaev](https://github.com/gyunaev). |
19 | 26 |
|
20 | | -KchmViewer is written by [Georgy Yunaev](https://github.com/gyunaev), and is licensed under GNU GPL license version 3. |
21 | 27 |
|
| 28 | +Features |
| 29 | +-------------------------------------------------------------------------------- |
22 | 30 |
|
23 | | -## What's New |
24 | | - |
25 | | -Fixed a bug causing false detection of an external link and displaying the “Open link in external program” dialog box. |
26 | | - |
27 | | -Read more in the [release note](https://github.com/eBookProjects/uChmViewer/releases/latest) and in the [news](NEWS.md). |
28 | | - |
29 | | - |
30 | | -## Features |
31 | | - |
32 | | -- Standalone viewer, depends on Qt 5 or Qt 6 only. Does not require KDE, GNOME or wxWidgets toolkit. |
33 | | -- Completely safe and harmless. JavaScript can be disabled in the settings, optionally warns you before opening an external web page, or switching to another help file. |
| 31 | +- Standalone viewer, depends on Qt 5 or Qt 6 only. Does not require KDE, GNOME |
| 32 | + or wxWidgets toolkit. |
| 33 | +- Completely safe and harmless. JavaScript can be disabled in the settings, |
| 34 | + optionally warns you before opening an external web page, or switching to |
| 35 | + another help file. |
34 | 36 | - Correctly detects and shows encoding of any valid chm file. |
35 | | -- Correctly shows non-English chm files, including Cyrillic, Chinese, Japanese and others. |
| 37 | +- Correctly shows non-English chm files, including Cyrillic, Chinese, Japanese |
| 38 | + and others. |
36 | 39 | - Correctly searches in non-English chm files using chm built-in search index. |
37 | 40 | - Shows an appropriate image for every TOC entry. |
38 | | -- Has complete chm index support, including multiple index entries, cross-links and parent/child entries in index. |
39 | | -- Persistent bookmarks support. Allows to store bookmarks even if "Favorites" window was not enabled for this chm file. Also stores the screen position for every bookmark. You can also edit/delete bookmarks. |
40 | | -- For any opened chm file, stores the last opened window, search history, bookmark history, font size and so on, so when you open this file again, everything is always on the place. |
| 41 | +- Has complete chm index support, including multiple index entries, cross-links |
| 42 | + and parent/child entries in index. |
| 43 | +- Persistent bookmarks support. Allows to store bookmarks even if "Favorites" |
| 44 | + window was not enabled for this chm file. Also stores the screen position for |
| 45 | + every bookmark. You can also edit/delete bookmarks. |
| 46 | +- For any opened chm file, stores the last opened window, search history, |
| 47 | + bookmark history, font size and so on, so when you open this file again, |
| 48 | + everything is always on the place. |
41 | 49 | - Has easy and powerful search-in-page support. |
42 | | -- Allows to increase or decrease the font size, so physically handicapped people can read texts easily. |
| 50 | +- Allows to increase or decrease the font size, so physically handicapped people |
| 51 | + can read texts easily. |
43 | 52 | - Has standard Back/Forward/Home navigation. |
44 | 53 | - Can print the opened pages on a standard printer (usually via CUPS). |
45 | | -- Has complex search query support. You can use search queries like "lazy people" +learn -not. |
| 54 | +- Has complex search query support. You can use search queries like |
| 55 | +`"lazy people" +learn -not`. |
46 | 56 |
|
47 | 57 |
|
48 | | -## Getting uChmViewer |
| 58 | +Getting uChmViewer |
| 59 | +-------------------------------------------------------------------------------- |
49 | 60 |
|
50 | | -Binary builds for Debian, Ubuntu and Windows are available on the |
| 61 | +Binary builds for Debian, Ubuntu, Fedora and Windows are available on the |
51 | 62 | [release page](https://github.com/eBookProjects/uChmViewer/releases/latest).You |
52 | 63 | can also build the application yourself by following the |
53 | 64 | [build instructions](INSTALL.md). In addition, thanks to Андрей Алыпов (AndnoVember), |
54 | 65 | [RPM packages](https://build.opensuse.org/package/show/home:AndnoVember:LXQt:Qt6/uchmviewer) |
55 | 66 | for OpenSuse are available. |
56 | 67 |
|
| 68 | +[](https://repology.org/project/uchmviewer/versions) |
| 69 | + |
57 | 70 |
|
58 | | -## Usage |
| 71 | +Usage |
| 72 | +-------------------------------------------------------------------------------- |
59 | 73 |
|
60 | 74 | Usage of uChmViewer is simple: |
61 | 75 |
|
62 | | -``` |
63 | | -uchmviewer mychmfile.chm |
64 | | -``` |
| 76 | + uchmviewer mychmfile.chm |
65 | 77 |
|
66 | | -for the rest of command-line options, see uchmviewer --help |
| 78 | +For the rest of command-line options, see `uchmviewer --help`. |
67 | 79 |
|
68 | 80 |
|
69 | | -## Thanks |
| 81 | +Thanks |
| 82 | +-------------------------------------------------------------------------------- |
70 | 83 |
|
71 | 84 | Thanks to: |
72 | 85 |
|
73 | | -- [Jed Wing](https://github.com/jedwing), the author of [CHMLib](http://www.jedrea.com/chmlib/). This library is used by kchmviewer to access chm content. |
74 | | -- [Razvan Cojocaru](https://github.com/rzvncj), the author of [xCHM](https://xchm.sourceforge.io/). I used some ideas and chm processing code from xCHM. |
| 86 | +- [Georgy Yunaev](https://github.com/gyunaev), the author of original KchmViewer. |
| 87 | +- [Jed Wing](https://github.com/jedwing), the author of |
| 88 | + [CHMLib](http://www.jedrea.com/chmlib/). This library is used by uChmViewer |
| 89 | + to access chm content. |
| 90 | +- [Razvan Cojocaru](https://github.com/rzvncj), the author of |
| 91 | + [xCHM](https://xchm.sourceforge.io/). Georgy Yunaev used some ideas and chm |
| 92 | + processing code from xCHM. |
75 | 93 | - Peter Volkov for various bug reports and improvement suggestions. |
76 | | -- All the users, who report bugs, and suggest features. You help making kchmviewer better. |
| 94 | +- All the users, who report bugs, and suggest features. You help making |
| 95 | + uchmviewer better. |
| 96 | + |
| 97 | + |
| 98 | +License |
| 99 | +-------------------------------------------------------------------------------- |
77 | 100 |
|
78 | | -## License |
| 101 | +uChmViewer is distributed under GNU GPL license version 3. You can get the |
| 102 | +source code at the following sites: |
79 | 103 |
|
80 | | -uChmViewer is distributed under GNU GPL license version 3. |
| 104 | +- [GitHub](https://github.com/GCodeProjects/uChmViewer) |
| 105 | +- [GitFlic](https://gitflic.ru/project/u-235/uchmviewer) |
| 106 | +- [Codeberg](https://codeberg.org/u-235/uChmViewer) |
0 commit comments