2015-04-01 10:34:21 +03:00
# Zeal
2015-01-16 03:03:50 +03:00
2016-09-19 00:22:28 +03:00
[](https://github.com/zealdocs/zeal/releases)
2017-08-28 20:38:55 +03:00
[](https://gitter.im/zealdocs/zeal)
2021-07-11 03:08:32 +03:00
[](https://web.libera.chat/#zealdocs)
2016-09-19 00:22:28 +03:00
[](https://telegram.me/zealdocs)
[](https://twitter.com/zealdocs)
2014-11-26 05:40:36 +03:00
2021-07-10 18:12:16 +03:00
[](https://github.com/zealdocs/zeal/actions/workflows/build-check.yml)
2018-10-19 08:27:06 +03:00
[](https://scan.coverity.com/projects/4271)
2015-09-09 08:37:56 +03:00
Zeal is a simple offline documentation browser inspired by [Dash ](https://kapeli.com/dash ).
2013-01-20 05:49:25 +04:00
2018-01-22 02:05:20 +03:00
2013-02-02 00:23:56 +04:00
2013-03-30 18:45:30 +04:00
## Download
2015-09-09 08:37:56 +03:00
Get binary builds for Windows and Linux from the [download page ](https://zealdocs.org/download.html ).
2013-01-20 05:49:25 +04:00
## How to use
2020-07-07 07:09:49 +03:00
After installing Zeal go to `Tools->Docsets` , select the ones you want, and click the `Download` button.
2013-03-07 02:50:11 +04:00
## How to compile
2020-07-07 07:09:49 +03:00
### Build dependencies
2017-11-16 02:23:06 +03:00
* [CMake ](https://cmake.org/ ).
2020-04-27 02:17:12 +03:00
* [Qt ](https://www.qt.io/ ) version 5.9.5 or above. Required module: Qt WebEngine Widgets.
2020-06-29 07:26:14 +03:00
* [libarchive ](https://libarchive.org/ ).
2017-11-16 02:23:06 +03:00
* [SQLite ](https://sqlite.org/ ).
* X11 platforms only: Qt X11 Extras and `xcb-util-keysyms` .
2020-07-07 07:09:49 +03:00
### Build instructions
2017-11-16 02:23:06 +03:00
```sh
2020-07-07 07:09:49 +03:00
cmake -B build
cmake --build build
2017-11-16 02:23:06 +03:00
```
2014-01-29 01:38:20 +04:00
2020-07-07 07:09:49 +03:00
More detailed instructions are available in the [wiki ](https://github.com/zealdocs/zeal/wiki ).
2013-03-07 02:50:11 +04:00
2014-10-13 23:55:05 +04:00
## Query & Filter docsets
2015-05-18 09:56:05 +03:00
You can limit the search scope by using ':' to indicate the desired docsets:
2014-10-13 23:55:05 +04:00
`java:BaseDAO`
You can also search multiple docsets separating them with a comma:
`python,django:string`
## Command line
2017-11-04 22:07:15 +03:00
If you prefer, you can start Zeal with a query from the command line:
2014-10-13 23:55:05 +04:00
2017-12-10 18:25:45 +03:00
`zeal python:pprint`
2014-10-13 23:55:05 +04:00
2020-07-07 07:09:49 +03:00
## Create your own docsets
2013-02-10 23:00:17 +04:00
2020-07-07 07:09:49 +03:00
Follow instructions in the [Dash docset generation guide ](https://kapeli.com/docsets ).
2015-04-16 06:18:22 +03:00
## Contact and Support
We want your feedback! Here's a list of different ways to contact developers and request help:
2021-07-18 07:46:36 +03:00
2015-04-16 06:18:22 +03:00
* Report bugs and submit feature requests to [GitHub issues ](https://github.com/zealdocs/zeal/issues ).
2021-07-11 03:08:32 +03:00
* Reach developers and other Zeal users on [Gitter ](https://gitter.im/zealdocs/zeal ) or `#zealdocs` IRC channel on [Libera Chat ](https://libera.chat ) ([web client](https://web.libera.chat/#zealdocs)).
2021-07-18 07:46:36 +03:00
* Ask any questions in our [GitHub Discussions ](https://github.com/zealdocs/zeal/discussions ).
2020-07-07 07:09:49 +03:00
* Do not forget to follow [@zealdocs ](https://twitter.com/zealdocs ) on Twitter!
2021-07-18 07:46:36 +03:00
* Finally, for private communication shoot an email to zeal@zealdocs.org.
2019-09-03 05:27:06 +03:00
2015-04-19 00:28:10 +03:00
## License
2020-06-29 07:26:14 +03:00
This software is licensed under the terms of the GNU General Public License version 3 (GPLv3). Full text of the license is available in the [COPYING ](https://github.com/zealdocs/zeal/blob/master/COPYING ) file and [online ](https://www.gnu.org/licenses/gpl-3.0.html ).
