Slash - 基于 atom-shell 开发的开源离线文档阅读工具

[oott123]

缘起

事实上，看到 Slash 的名字，我想你也会想起 Dash 这个在 Mac 平台上做得风生水起的文档阅读工具。

不过，作为一个 Windows 用户，实在是很难在 Windows 上找到一个和 Dash 一样的工具——Velocity 不是很好用，Zeal 也不太符合我心里所想的文档阅读工具的样子。更重要的是，前者并不开源（而且还有点贵）；后者用的 QT 我并不会用，所以也无法修改成自己想要的样子。

事实上 atom-shell 是一个很好的选择；天然跨平台，开发简单方便。于是我就用了 atom-shell ，写了 Slash —— 并用 MIT 协议开源。

现在，Slash 处于“勉强能用”的状态；事实上，我个人觉得它已经比 Velocity 好用一些了。至少，是免费的 :)

Slash pre-alpha

Windows 版本可以在 百度网盘 上下载到。

Linux / Mac OS 的用户，可能需要自己编译。

源代码可以在 GitHub 中找到。

Screenshots

（图上的书签功能是还没做的……）

（其实就是临时对付一下用了 alert ……）

（啊，暴露英语水平了……）

关于 Docsets

我发邮件给 Dash 的作者询问我可不可以使用 Dash 的 Docsets，得到的答复是我不可以把 Dash 的 Docsets 集成到软件中（因为 Velocity 已经独占了 Windows 上的 Dash 文档），也不能引导用户下载它们；但我可以支持 Dash 的格式，同时没有责任监督用户是不是使用它们。

所以…… :)

后续开发

事实上我十分希望有人和我一起对 Slash 进行完善，毕竟，一个人开发它，稍显力不从心了一些。很多东西我也不是很明白，事实上也是第一次用 coffeescript 和 atom-shell 去写一个比较完备的项目（之前基本上都是在玩）。

如果你有心帮助我，那么实在是太棒了。

我用到的技术栈大概是：atom-shell/coffeescript/Vue.js/LESS css。

[testla]

希望能比Dash支持更多的文档集~~~

[echopan]

来赞一下吧

[bingu]

不知道在 linux 下的表现如何，回去弄弄

[0x142857]

有空来 Contribute.

[oott123]

@testla 事实上目前根本没有能够光明正大的用的 Docsets..
@echopan 多谢 :)
@bingu 可能需要用 `apm install` 来安装 sqlite 这种依赖，因为它是一个 native module，编译起来确实是有些痛苦……
@0x142857 感激不尽！:)

[chinvo]

專程前來膜拜oott大神

[xloger]

专程前来膜拜冷场大神三三

[osss]

好东西，期待完善~~

[lotem]

好東西，期待完善~~

[oott123]

@chinvo
@xloger 求不卖萌，我冷场又不是一天两天了……


@osss
@lotem 谢谢支持:)

[xiaogui]

"不可以把 Dash 的 Docsets 集成到软件中（因为 Velocity 已经独占了 Windows 上的 Dash 文档），也不能引导用户下载它们"
这该怎么用？

[oott123]

@xiaogui 其实你可以自己偷偷去下……我管不着……Dash 也管不着……

[xiaogui]

@oott123 这个倒是了解

[oott123]

@xiaogui 如果你关心的是，正式发布的时候最终用户怎么获取 Docsets ，这我也没有主意。
我想的是，最后可能需要我或者志愿者自己重新索引抓取一份，而这种重复劳动并不是我所希望的。

[xiaogui]

@oott123 嗯，那倒是

[wezzard]

@oott123 Just write a robot a rip docsets with it.

[dx3759]

希望能支持用户上传文档
希望能对文档阅读进度进行统计，有多少没读
希望能对用户阅读习惯进行统计，标注哪些地方阅读的最多
希望能支持更多的文档
希望能推荐其他用户的文档
希望能支持github上的文档直接阅读
希望能支持代码的阅读
希望能支持文档打包
希望能支持全平台同步
希望能支持文档变化标注

先这些吧

[oott123]

@wezzard 写 bot 本身就是重复劳动啦 :)

@dx3759
希望能支持用户上传文档 -> 可以参考 Dash 做 Docsets Feed 吧 233
希望能对文档阅读进度进行统计，有多少没读 -> 文档阅读进度……话说真的有很多人都是把所有文档都读一遍的么？
希望能对用户阅读习惯进行统计，标注哪些地方阅读的最多 -> 拯救手册读多了还老是记不住星人！
希望能支持更多的文档 -> 现在支持 Dash 和 Zeal 的格式。更多的，可以自己生成 :)
希望能推荐其他用户的文档 -> 唔，我觉得这个意义不太大，有个页面把文档收录进去就行了，大家需求什么可以用关键字查找的。
希望能支持github上的文档直接阅读 -> 指 GitHub Wiki ，或者 GitHub 中的 markdown 文件们? 这个很有意思，我会考虑优先做的！
希望能支持代码的阅读 -> 代码阅读有很多更好的工具，我想还是不应该使用 Slash 这类主要是方便 [查阅] 的工具。
希望能支持文档打包 -> 事实上 Docsets 文件夹就是一堆 HTML 文档喔，所以其实已经是打包好的。
希望能支持全平台同步 -> 同步 Docsets ？ 可是那些都很大。同步配置和阅读进度是没问题哒:)
希望能支持文档变化标注 -> 这个可以有！不过下载量就更大了orz

谢谢你的意见 :) 感谢已发送！