简介
『毛线助手』允许你做如下事情:
- 在裁剪之前对网页的状态进行一些修改,以实现一个更好的裁剪结果
- 重写一些配置信息,是一次性配置,即网页级别的配置
- 预先填写表单,可对某些网页的标题、分类和标签进行预填写
- 选中某一区域,这样就不需要每次都进行点选
- 选中某一区域,并进行确认,直接到填写表单那一步
- 选中某一区域,并立即自动进行裁剪,即当你点击裁剪之后,整个裁剪动作自动开始
为什么需要修改网页的状态?
由于 MaoXian Web Clipper 裁剪网页的时候,裁剪的是当前状态下的网页,并且不会保存任何脚本文件(即 javascript)。 这意味着在一些情况下,我们需要对网页进行一些操作后,才能获得一个较好的裁剪结果。
比如:
- 一篇文章里的图片显示的都是缩略图,而你想保存的是原图
- 或者是你不想保存选区内的按钮、评论等无关内容
- 又或者是网页上的某些区域是可折叠的,需要在裁剪前把它们都展开。
如何利用预填表单?
- 设置正确的标题,在内容标题和整个网页的标题不一致时使用。
- 设置分类,比如新闻网页,都预先保存在
新闻
分类下。 - 设置标签,预先为这些网页打上可预知的标签。
一旦网页的表单都预先填写了,那么就可利用『选中区域』动作,实现一键裁剪。
如何利用网页级别的配置?
网页级别的配置,一般用于一些例外的情况。如:
- 你默认的保存格式为 Markdown,但是某些网页更适合保存成 HTML。你就可以利用网页级别配置,把这些网页的存储格式设置成 HTML。
- 你默认是不保存音频的,而对于一个显示铃声的网页,你想把这些小音频保存下来,你就可以利用网页级别配置完成。
- 等等。。
三种不同的 Plan
全局 Plan
「全局 Plan」 是由你自己编写的。它会应用到所有的网页上,如果某个操作具备普遍性,则可以加入到「全局 Plan」里。
自定义 Plan
「自定义 Plan」也是由你自己编写的,它会应用到某一类网页上。此种为最常见的,一般都会对某个网站的某类网页进行裁剪。比如对某个博客的文章进行裁剪,因为同类网页的结构一般都相同,需要对其的操作也相同,所以可以通过编写此种 Plan 对其进行统一处理。
公开的 Plan
为了减少用户重复编写「自定义 Plan」的工作。MaoXian 支持你将自己编写的 「自定义 Plan」分享出来,成为 「公开的 Plan」。这样所有用户都会受益。 此种 Plan,可以通过下方的订阅地址获取到。
订阅「公开的 Plan」
将下方的订阅地址复制到:MaoXian 扩展 > 设置页面 > 助手 页面的订阅框中。
订阅地址
# 默认网站列表(全球性)
https://mika-cn.github.io/maoxian-web-clipper/assistant/plans/default/index.json
# 华人网站列表
https://mika-cn.github.io/maoxian-web-clipper/assistant/plans/zh/index.json
参与进来
『毛线助手』的工作方式有点像「广告屏蔽扩展」,需要针对不同的网站,编写不同的 Plan。这也意味着它解决问题的多少,取决于我们适配的网站的多少。这需要的不仅仅是开发者,更是每一个使用者的无私分享精神,于此,我们欢迎各位用户参与进来,只有这般,该助手才能发挥其真正的能力。
如果你不会编程,你可以在项目 issue 页面 提交适配请求(提供需要适配的网址),或者回馈某个网站适配不正确的信息,以便其他人进行跟进。
如果你会编程(只需要懂一点 CSS,了解 JSON 格式就行),那么恭喜你,你完全有能力编写 Plan,并分享给其他人,具体查看下一节。
如何编写 Plan
请查看这里
项目地址
- 该项目用于收集和分享各个用户编写的 “Plan”。
- 你也可自部署该项目生成的公有 Plan,来减少外部依赖。
贡献 Plan
所有的 Plan 都存储在 plans
的子目录下,不同的子目录代表不同频道,每个频道最终都将生成一个订阅地址。请将你写的 Plan 以数组的形式单独存为一个文件,如: plans/zh/zhihu.json
。每个网站建一个文件。
最终所有的 Plan 会在 build.rb
这个脚本的渲染下,变成可订阅的形式。
你可以通过下方几种方式把 plan 分享出来:
- 通过 Github 建 Pull Request 的形式。
- 通过 Github 建 issue。(把 plan 贴上即可)
- 通过发邮件给开发者(i.mika[AT]tutanota.com),直接发送内容或者发送 patch。
最后
如果你对「毛线助手」有什么看法或建议,请告诉我们。