[插件][程序员手册 1.1.4] 兼容暗黑模式，修复收藏 bug，增加 tmux 文档

payne · 2020年5月21日

utoolsV1.0.2-beta手册无法启用，启用后再次打开还是关闭状态

marsvet · 2020年5月23日

能考虑把 python库中一些比较大的文档分离出来吗，比如 BeautifulSoup，没有索引比较难找，只能靠搜索，效率有点低

fofolee · 2020年5月23日

marsvet ok,安排

marsvet · 2020年5月23日

fofolee 哈哈哈，感谢感谢

fofolee · 2020年6月7日

v1.1.7

修复方向键移动时，滚动条一起滚动的 bug

v1.1.6

修复 vue 手册的 bug

v1.1.5

调整图片显示的方案

v1.1.4

兼容暗黑模式
修复某些情况下导航目录被遮挡的 bug
修复按 S 搜藏时无法跳转到备忘(收藏)插件的 bug
linux 收手册下新增一个 tmux 快捷键 ryuzheng提供中文原版英文原版

v1.1.3

新增 go 文档，来自网友@永远の明日, 源文档

v1.1.2

新增功能
- 新增在文档界面显示导航目录，方便在篇幅较长文档中快速定位，支持目录搜索。默认情况下，如果h1+h2+h3的数量大于10则自动显示目录

新增win32api手册
体验改善
为了减少使用语音面板进行划词搜索时的干扰项，更改了开启主输入框搜索时匹配的正则，现在的匹配规则是/^[a-zA-Z._]{2,20}$/i
优化列表搜索速度
bug 修复
修复了从主输入框搜索进入插件时未对关键词进行搜索的bug

v1.1.1

新增linux下调用zeal
修复一个通过主输入框搜索的bug
增加一个快捷键提示，通过shift+enter也可以发送文本

v1.1.0

适配新版uTools
更新uToolsAPI里的文档至最新版

v1.0.3

增加收藏的功能，调用官方的收藏插件进行收藏，手册界面选择文本后按S键即可收藏
调整划词翻译功能的UI
更新列表界面和手册界面子输入框内的说明，提示各个快捷键的功能
修复一个BUG，该BUG会导致第一次载入插件时无法调用dash或zeal的文档，以及在设置手册时搜索关键字后无法跳转

v1.0.2

增加划词翻译的功能，调用有道的英译中的接口。手册界面选中文本后按T键即可翻译

v1.0.1

一些bug修复、、

v1.0.0

上架 uTools 插件商店,算是正式版了,去除了内置的插件更新提示
修复两个滚动事件引起的BUG
(似乎)修复了mac下退出后再次进入无法触发鼠标单击事件的BUG
修复payload.json文件会被某些杀毒软件误报的情况,现在已做加密处理

v0.0.4

抱歉由于这段时间私事太多，插件疏于更新。感谢@Xinu在插件无法使用的时候帮忙发布了修复版本。

修复了uTools更新后进入插件空白的BUG
添加Linux支持
修复了退出手册后再次进入无法搜索的BUG，但是MacOS下任然存在一个诡异的BUG，退出后再次进入无法触发鼠标单击事件，建议勾选隐藏即完全退出选项，windows不受影响
修复了添加外置手册时使用多关键词会出现问题的BUG
现在外置的Java手册有图标了

v0.0.3

又有一大波更新来袭

先做一个名词解释,本文中所提及的

手册界面为：

列表界面为：

功能更新

添加了快速将内容发送至活动窗口的功能，在列表界面按shift+enter或鼠标中键即可将选中的函数名称发送至上一个系统的活动窗口，在手册界面，选中相关文本内容后，按shift+enter或鼠标中键即可发送。查完api后再也不用慢悠悠地手动复制函数了~~
集成了devdocs，在手册设置页面，点击下方的英文手册按钮即可进入devdocs的配置页面

需要先在该页面点击下载按钮下载相应的文档目录，之后便可和内置手册一样使用

需要注意的是devdocs所有文档的api列表中均无中文注释，且只有目录文件是离线存储的，访问具体的手册页面需要联网

现在手册设置页面可以在顶端输入框内搜索快速查找需要的文档
添加快速启动dash或者zeal的功能，通过关键字dash即可进入

注意，不同于devdocs，最后会根据查询内容调用dash或者zeal进行查看，故需要先安装dash或者zeal才可以使用此功能

添加了多关键词查找的功能，现在想怎么搜就怎么搜~

添加了一个内置手册PyQt5，同时在内置的python手册中添加了多个tkinter的实例

添加了一个内置手册payload，收录了一些网络安全测试的常用payload，没有手册页面，主要配合新出的发送文本到窗口的功能，实现快速输入payload，目前收录的比较少，后续会陆续补充

增加外置手册时，如需自定义css，不再是添加单个css文件，而是统一放入assets目录中，相关外置手册说明同步更新

用户体验改善

当在列表界面进行搜索后，点击进入手册界面，会清空顶端输入框内的值
在某些情况下（例如读取外置手册失败时）会输出一些报错信息

bug修复

修复了添加外置手册后滚动条没有调整的bug，以及某些时候滚动条未自动调整的bug
修复检测更新功能中，即使点了不再提醒，下次重启uTools时仍会再次出现的bug

本项目现已在Github开源，地址见下载一栏，欢迎提交pr，大家一同完善本项目，如果喜欢也请不吝star~

v0.0.2

功能更新

增加外置手册的功能，需要有一定的编写爬虫脚本的能力，详情戳我
增加了三个内置手册javascript,jQuery,vue,一个外置手册Java。由于Java体积太大（目录10M，手册100M+），会使整个插件体积暴增，故采取外置形式，同时也作为外置手册的一个案例作为参考。
增加了版本检测的功能，当有新版本时会弹窗提示
在设置页面增加了两个功能键全部启用和全部禁用

用户体验改善

优化搜索结果的排序，现在的排序规则是，置顶全字匹配的内容，优先显示名称匹配的内容，其次显示描述匹配的内容
滚动条样式调整，现在滚动条会自动隐藏，并在滚动时和鼠标移至滚动条位置时出现
设置页面的开关样式调整，现在开关的状态更加清晰明了
linux、C等语言的手册现在支持语法高亮了
其他一些界面微调

BUG修复

修复了第一次进入插件时、列表更新时、方向键选择列表时，鼠标所在位置会被选中的BUG
修复了方向键进行列表选择时，没有到最后一行就向下滚动的BUG

v0.0.1

相较于之前两版，做了比较大的更新：

整合所有手册到一个插件当中，现在有多达九个语言或工具的手册
添加了一个配置页面，可以选择需要启动的功能（注：默认情况下所有手册均未启用，需要先通过手册设置命令进行配置）

支持直接在uTools主输入框进行快速搜索查询（或复制文本后5s内呼出uTools），可在配置页面选择开启
子输入框功能增强。

在列表界面用来搜索函数/命令，并高亮匹配文本

在手册界面则可以进行当前文档内容的搜索（回车键跳转到匹配文本位置）
添加了一个快捷键TAB，以在列表界面和手册界面之间进行切换
现在支持点击手册里的外部链接跳转到相应网址（通过默认浏览器打开，之前并不支持，不知道你们发现没~_）
界面微调
一些BUG修复

fofolee · 2020年6月7日

marsvet
现在所有手册都增加了索引~以及其他细节更新~

marsvet · 2020年6月7日

fofolee 大佬太强了

胖乎乎的企鹅 · 2020年6月12日

你好，我想写一个外置文档，但是，我不会编程语言，但是又想做文档，又无从下手，请问能给我解答一下嘛。我看了你给的格式，我有点看不懂，又是脚本又是啥的。。。我有点晕，我都不知道jsion是啥。。能帮帮我吗

fofolee · 2020年6月13日

胖乎乎的企鹅不会编程可能有点麻烦，如果想写外置，json至少要知道
最简单的外置：
1.假定你的手册名字叫xxx，新建一个文件夹，名字随便，假定叫yyy
2.然后在文件夹里面创建xxx文件夹，和xxx.txt

3.然后把你的离线文档移动到xxx的文件夹内，需要注意的是，你的离线文档得是html格式的
举例来说：
这个网址：https://www.w3school.com.cn/json/json_syntax.asp
你用浏览器打开后，ctrl+s另存为JSON 语法.html文件，保存到xxx文件夹里

4.然后记事本打开xxx.txt，里面写入

[
    {
	"name": "JSON 语法",
	"path": "xxx/JSON 语法.html"
    }
]

保存后将xxx.txt改名为xxx.json

5.最简单的一个外置文档就做好了，然后在手册里选择yyy这个目录就可以了

在手册里打开这个文档后，只有一个条目

因为这只是一个示例，我们只做了一个条目

所以，最重要的两点：
1.离线手册的来源
要么你有现成的
要么就是chm文件，通过以下命令可以获得一堆html文件

hh.exe -decompile <解压目录> <CHM文件路径>

要么就只能写脚本爬取，当然如果你内容不多，也可以手动保存~

2.生成xxx.json
内容不多的话可以手动~
或者写脚本
或者半手动，比如在手册的目录，通过以下命令可以生成所有文件名的列表

dir /b > ../xxx.txt

然后在记事本里手动将其改成需要的格式（如果会正则的话会轻松很多）

[
    {
	"name": "JSON 语法",
	"path": "xxx/JSON 语法.html"
    }，
    {
	"name": "JSON 简介.html",
	"path": "xxx/JSON 简介.html"
    }
]

如果是通过chm文件解压得到的文档，一般会在解压后的根目录里面有类似HHC，HHK之类的文件，记事本打开后，是一个完整的索引文件，可以通过搜索替换改成我们需要的格式

永远の明日 · 2020年6月17日

fofolee 本次更新一个主要功能就是添加自定义添加手册的功能。一方面随着手册的增加，插件的体积会不断增大，使得插件本身变得臃肿，同时将数据和界面分离，方便后期维护；另一方面个人精力、资源都有限，无法满足所有人需求，增加这个功能，大家可以一起来维护，如果你有好的手册，欢迎发送给我[[fofolee@qq.com](mailto:fofolee@qq.com)](mailto:[fofolee@qq.com](mailto:fofolee@qq.com))，我会添加到内置或者外置的手册库中，并标明贡献者。

这个外置手册库有没有啊，我找不到

fofolee · 2020年6月17日

永远の明日
 下载地址提取码yfh7

永远の明日 · 2020年6月17日

fofolee 原来还只有Java啊，我自己爬了一个go标准库文档，取自go语言中文网，体积也不大，你看能不能收录一下

fofolee · 2020年6月19日

永远の明日好的~

ryu · 2020年6月24日

fofolee 楼主，我自己做了一个Tmux的快捷键的，你看看能不能收录一下，谢谢

https://github.com/ryuzheng/TmuxCheatSheet

Arrake · 2020年6月24日

按s收藏的功能，跳转不到备忘录，它的关键字是收藏(备忘),这个可以改吗?

fofolee · 2020年6月27日

ryu 好的，我收录集成到 linux 手册中，顺便修复了个导航菜单被遮挡的 bug

fofolee · 2020年6月27日

Arrake 这是由于备忘插件名字改了的缘故~已修复~

RhythmLian · 2020年6月27日

可以兼容一下深色模式吗？