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)
[](https://kiwiirc.com/client/irc.freenode.net/#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
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
2015-04-27 01:17:12 +03:00
## Build Status
[](https://scan.coverity.com/projects/4271)
2018-01-04 03:13:11 +03:00
| OS | Build Status |
| -------- | ------------ |
| Linux | [](https://app.shippable.com/projects/54ac2ce4d46935d5fbc19b84) |
| Windows | [](https://ci.appveyor.com/project/trollixx/zeal) |
2015-04-27 01:17:12 +03: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
2017-11-16 02:24:41 +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
2017-11-16 02:23:06 +03:00
### Required dependencies
* [CMake ](https://cmake.org/ ).
* [Qt ](https://www.qt.io/ ) version 5.5.1 or above. Required module: Qt WebKit Widgets.
2015-05-18 09:56:05 +03:00
* [libarchive ](http://libarchive.org/ ).
2017-11-16 02:23:06 +03:00
* [SQLite ](https://sqlite.org/ ).
* X11 platforms only: Qt X11 Extras and `xcb-util-keysyms` .
### Building instructions
```sh
mkdir build & & cd build
cmake ..
make
```
2014-01-29 01:38:20 +04:00
2017-11-16 02:23:06 +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
2013-02-10 23:00:17 +04:00
## Creating your own docsets
2017-11-16 02:24:41 +03:00
Follow 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:
* Report bugs and submit feature requests to [GitHub issues ](https://github.com/zealdocs/zeal/issues ).
2017-12-10 18:25:45 +03:00
* Reach developers and other Zeal users on [Gitter ](https://gitter.im/zealdocs/zeal ), or IRC channel #zealdocs on [Freenode ](https://freenode.net/ ).
2015-04-16 06:18:22 +03:00
* Ask any questions in our [Google Group ](https://groups.google.com/d/forum/zealdocs ). You can simply send an email to zealdocs@googlegroups.com.
2017-12-10 18:25:45 +03:00
* Finally, for private communications email us at zeal@zealdocs.org.
2015-04-16 06:18:22 +03:00
* And do not forget to follow [@zealdocs ](https://twitter.com/zealdocs ) on Twitter!
2015-04-19 00:28:10 +03:00
## License
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 ](http://opensource.org/licenses/gpl-3.0.html ).
