obsidian-clipper

英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

Obsidian 网页剪辑器帮助你在喜欢的浏览器中高亮和捕捉网页内容。你保存的任何内容都会以可持续的 Markdown 文件形式存储，方便离线阅读，并可长期保存。

• 下载网页剪辑器
• 文档
• 故障排除

开始使用

通过从浏览器的官方目录下载来安装扩展程序：

• Chrome 网上应用店 适用于 Chrome、Brave、Arc、Orion 和其他基于 Chromium 的浏览器。
• Firefox 附加组件 适用于 Firefox 和 Firefox 移动版。
• Safari 扩展 适用于 macOS、iOS 和 iPadOS。
• Edge 附加组件 适用于 Microsoft Edge。

使用扩展

文档可在 Obsidian 帮助网站 上获取，其中涵盖了如何使用 高亮、模板、变量、过滤器 等。

贡献

文档

用户文档保存在 obsidian-help 的 en/Obsidian Web Clipper 目录 中。

翻译

您可以帮助将 Web Clipper 翻译为您的语言。请通过使用 /_locales 文件夹中提供的格式提交拉取请求来提交您的翻译。

功能和错误修复

查看 需要帮助 标签，以获取欢迎贡献的问题。

路线图

无特定顺序：

• 标注高亮
• 模板目录
• 在不同浏览器间同步设置
• 为网页剪辑器添加独立图标（1.6.3）
• 模板验证（1.1.0）
• 模板逻辑（if/for）（1.1.0）
• 本地保存图片（Obsidian 1.8.0）
• 将界面翻译成更多语言 — 欢迎协助

开发者

要构建扩展：

npm run build

这将创建三个目录：

• dist/ 用于 Chromium 版本
• dist_firefox/ 用于 Firefox 版本
• dist_safari/ 用于 Safari 版本

在本地安装扩展

对于 Chromium 浏览器，如 Chrome、Brave、Edge 和 Arc：

1. 打开浏览器并导航到 chrome://extensions
2. 启用 开发者模式
3. 点击 加载已解压的扩展程序 并选择 dist 目录

对于 Firefox：

1. 打开 Firefox 并导航到 about:debugging#/runtime/this-firefox
2. 点击 加载临时附加组件
3. 导航到 dist_firefox 目录并选择 manifest.json 文件

如果您想永久运行扩展，可以使用 Firefox Nightly 或 Developer 版本。

1. 在网址栏中输入 about:config
2. 在搜索框中输入 xpinstall.signatures.required
3. 双击该首选项，或右键选择“切换”，将其设置为 false。
4. 进入 about:addons > 齿轮图标 > 从文件安装附加组件…

在 macOS 上进行 iOS 模拟器测试：

1. 运行 npm run build 来构建扩展
2. 在 Xcode 中打开 xcode/Obsidian Web Clipper/Obsidian Web Clipper.xcodeproj
3. 从方案选择器中选择 Obsidian Web Clipper (iOS) 方案
4. 选择一个 iOS 模拟器设备，然后点击 运行 来构建并启动应用
5. 应用在模拟器上运行后，打开 Safari
6. 导航到一个网页，然后点击 Safari 中的 扩展 按钮以访问 Web Clipper 扩展

运行测试

npm test

或者在开发过程中以观察模式运行：

npm run test:watch

第三方库

• webextension-polyfill 用于浏览器兼容性
• defuddle 用于内容提取和 Markdown 转换
• dayjs 用于日期解析和格式化
• lz-string 用于压缩模板以减少存储空间
• lucide 用于图标
• dompurify 用于清理 HTML

许可

Obsidian Web Clipper 的源代码在 MIT 许可证下是开源的。所有商标、图标、营销文案和其他营销资产不包含在该许可证中。