apollonbar/utools-manuals

uTools插件，内置了十多个实用的离线中文手册，包括：Linux、PHP、Python、JS等,以及提供了搜索devdocs、dash/zeal上的文档的功能

程序员手册 V1.1.1

简介

内置了十多个实用的离线中文手册，包括：Linux、PHP、Python、JS等,以及提供了搜索devdocs、dash/zeal上的文档的功能

手册具有以下三个特色：

• 内置多个手册均可离线使用，且90%以上是中文
• 可以自行添加手册
• 可以查询devdocs、dash/zeal上的文档

前身是之前发布的两个插件：

PHP函数查询助手 Linux命令查询手册

基本操作

• 列表界面：
  • 查看选中的内容 ⏎/🖱左键
  • 发送选中的内容至上一个活动窗口 ⇪ + ⏎/🖱中键
  • 上下选择 ⇧/⇩
• 手册界面：
  • 切换列表和手册视图 tab/🖱右键
  • 发送选中的内容至上一个活动窗口 ⇪ + ⏎/🖱中键
  • 搜索下一个关键词 ⏎
  • 选中文本后翻译 T
  • 选中文本后收藏 S
• 退出插件 esc

关键字

• 手册设置/ManualOptions ： 调整程序员手册的功能
• dash/zeal ：打开dash 或 zeal 进行搜索
• linux命令 php函数 python库 C函数 vim命令 git命令 docker命令 sql手册 uToolsAPI 等

更新

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修复

其他预览

安装

请直接在插件中心进行安装即可，或将本项目打包成upx安装

项目地址

插件发布页

外置手册教程

手册一览

所有手册资源均来自网络，如有遗漏，请留言告知

• php手册 | 官方中文文档
• linux手册 | 离线手册：linux-command@jaywcjlove 原始数据：linuxde.net
• python手册 | 官方文档一译翻译版
  • beautifulSoup | 官方中文文档
  • requests | 官方中文文档
  • scrapy | scrapy入门教程中文翻译
  • pillow | pillow官方文档中文翻译
  • tkinter | 易学教程
• PyQt5文档 | PyQt5中文教程
• C函数 | C语言函数速查（Knocker 2004.7.7 版本 0.5）
• vim命令 | awesome-cheatsheets
• git命令 | php中文网git开发手册
• sql手册 | php中文网sql参考手册
• uTools API | uTools官方文档
• java | fondme.cn
• javascript | MDN Web Docs
• jQuery | jQuery中文网
• vue | 官方中文文档
• payload | 收集自网络
• devdocs | devdocs