这个项目能做什么

Zeal 是一款用于离线浏览文档的桌面应用程序。它表现为一个个人参考库,可以即时搜索并离线使用。其设计最初受到 Dash 的启发,并且读取相同的 docset 格式,因此现有的 Dash docset 可以直接使用。 入门指南:安装后,您需要打开“文件 → 文档库”,选择所需的 docset 并点击下载。下载后的 docset 将保留在本地机器上,用于查询。 搜索行为:可以通过在查询前加上 docset 名称并用冒号分隔来缩小搜索范围,例如 cpp:vector。也可以通过逗号分隔多个 docset 名称同时进行搜索,例如 python,django:string。Zeal 还可以从命令行启动并传入查询参数,如 zeal python:pprint。 分发方式:该项目发布在 Flathub(org.zealdocs.Zeal)和 Snap Store 上,Windows 的二进制构建版本及其他安装选项可在项目的下载页面找到。README 中指出,Windows 构建版本要求 Windows 10 版本 1809 或更高。 从源码构建:README 指向项目 Wiki 获取各平台的最新构建说明,并提供简要概述。构建依赖包括 CMake、Ninja、Qt 6.4.2 或更高版本(需包含 Svg 和 WebEngine 模块以及 Qt Base)、libarchive 和 SQLite;Linux 和 BSD 平台还需要 extra-cmake-modules,X11 平台则需要 libxkbcommon 和 xcb-util-keysyms。文档中记录的构建步骤为:使用 CMake 预设 cmake --preset release 然后执行 cmake --build --preset release,生成 build/release/zeal(Windows 上为 zeal.exe)。 您可以按照 Dash docset 生成指南创建自己的 docset。欢迎通过仓库中的 CONTRIBUTING.md 提交贡献,其中描述了如何构建项目、应遵循的规范以及审查流程的相关内容。 README 中列出的支持与联系方式包括:GitHub issues 用于报告 bug 和功能请求,GitHub discussions 用于提问,Discord 用于与开发者和其他用户聊天,Telegram 频道用于公告,X 上的 @zealdocs 账户用于新闻,以及用于私人或敏感事项的电子邮件地址。 许可证:Zeal 以 GNU 通用公共许可证第 3 版或更新版本发布,完整文本见 COPYING 文件。所附带的第三方组件保留其各自的许可证,仓库符合 REUSE 标准,所有许可证文本均存储在 LICENSES 目录中。