[自荐]适用于Zeal和Dash的Autohotkey V2 docsets

发现频道 🔎
,
1

软件名称

Autohotkey2.docset

应用平台

Windows / macOS / Linux

推荐类型

【开发者自荐】如果对同为AHK爱好者的你有帮助的话，可以给个Star，感谢！

一句简介

「Autohotkey2.docset」是一个基于Dash的语法规范，CI自动持续构建的Autohotkey V2离线文档库的项目，其生成的离线文档包支持多个跨平台离线文档阅读器： Zeal， Velocity，Dash。

应用简介

  • 自动更新子模块和构建离线文档包
  • 支持英文和简体中文两种预研
  • 提供订阅网址
  • 与Docset的 条目类型规范兼容

Screenshot

使用方式

  1. 直接通过下方链接订阅

  • 英语

    https://raw.githubusercontent.com/Jvcon/Autohotkey2.docset/main/us_en/Autohotkey2.xml

  • 简体中文

    https://raw.githubusercontent.com/Jvcon/Autohotkey2.docset/main/zh_cn/Autohotkey2.xml
  1. 手动安装
  • 下载最新版本离线文档包，release
  • 解压后，将Autohotkey2.docset整个文件夹复制到对应的docset目录下

项目地址

Jvcon/Autohotkey2.docset (github.com)

1 个赞
3

我也尝试过使用保留原目录结构，不过目前遇到些情况：

  1. 经过dashing的处理之后，会在每一个跳转链接里增加<a class="dashAnchor" ...></a>的标签
  2. 如果使用原本的content.js版本进行制作，会导致原本的目录每一个菜单都会出现一个很高的空白

我尝试几个解决思路：

  1. 我尝试用原htm文件，重新覆盖dashing的输出文件，但是这样因为丢失了Anchor，也就导致点击zeal左侧的项目跳转不了锚点【弃用】
  2. 通过清空了content.js的function ctor_structure()的“self.template”，从而去掉了原版文档的iframe（相当于去掉了目录结构）。优：支持锚点跳转，也能避免出现太高的空白；弊：缺少了原本的目录，及本身很好用的搜索【现行方案】
  3. 还有一种解法，我猜测是css的样式问题，但是因为html+css+js学艺不精，暂时还没找到解决的苗头【努力思考中…】

所以现在的构建脚本里面，会用一个我修改过的content.js覆盖原版，在进行dashing构建。

如果有css相关领域的同学，提供给一些解决的思路。

稍后可以提供一个我线下构建带有目录结构的版本，分享给大家（注意：目前问题尚未解决，所以会有导航高空白的情况）

1 个赞
4

线下构建的中文版本带有目录解构的docset：

文件下载-奶牛快传 Download ｜CowTransfer 点击链接查看 [ AutoHotkey2-zh_cn.tgz ] ，或访问奶牛快传 cowtransfer.com 输入传输口令 78vm6m 查看；

5

用过 Zeal，体验并不是特别好，我宁愿去看以前的CHM帮助文档……
搜了下，有个V2EX的帖子有这方面讨论可以参考：想开发一个 windows 平台对标 Dash 的应用，用什么技术栈效率高 - V2EX

6

对，其实现在chm也能很好使用。有多种语言文档想查的时候，才会用到zeal这类工具。