Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/PKM-er/Obsidian-Surfing
An Obsidian plugin that lets you browse the web within Obsidian.
https://github.com/PKM-er/Obsidian-Surfing
Last synced: about 1 month ago
JSON representation
An Obsidian plugin that lets you browse the web within Obsidian.
- Host: GitHub
- URL: https://github.com/PKM-er/Obsidian-Surfing
- Owner: PKM-er
- License: mit
- Created: 2022-10-21T09:24:39.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-05-23T07:24:02.000Z (7 months ago)
- Last Synced: 2024-08-02T17:29:54.188Z (4 months ago)
- Language: TypeScript
- Homepage:
- Size: 1.36 MB
- Stars: 422
- Watchers: 9
- Forks: 24
- Open Issues: 97
-
Metadata Files:
- Readme: README-ZH.md
- License: LICENSE
Awesome Lists containing this project
- awesome-obsidian-zh - PKM-er/Obsidian-Surfing
- jimsghstars - PKM-er/Obsidian-Surfing - An Obsidian plugin that lets you browse the web within Obsidian. (TypeScript)
README
## Surfing
> 这个分支由 Boninall 维护，仅作个人使用。如果你想用该插件，使用 `quorafind/obsidian-surfing` 分支而不是以前的；
> 原始分支来自[这里](https://github.com/Trikzon/obsidian-web-browser)
[English Doc](README.md)
## 简介
这是一款 Obsidian 插件，允许你在 Obsidian v1.0 的标签页中浏览任意网址。
这个插件的核心功能——渲染一个 webview
，离不开 [Ellpeck's Obsidian Custom Frames](https://github.com/Ellpeck/ObsidianCustomFrames) 插件。
## 功能介绍
- 核心功能
- 浏览任意网页：该插件会劫持Obsidian的 file、http、https 协议，使得链接能直接在Obsidian里打开，而不是外部浏览器。对，本地HTML等资源也支持。
- 编辑器网页搜索你可以在编辑器选中关键字后，右键在 web-browser 中打开，使用默认的搜索引擎搜索。
- 网页内网页搜索：同样的，你可以在网页内右键使用默认的搜索引擎搜索。
- 复制指向高亮的链接：同浏览器一样，你可以选中文字，复制指向该处的链接。
- 在浏览器中使用书签直接在 Obsidian 中打开网址。
- 复制视频时间戳(实验性功能：目前仅支持bilibili)：右键文字弹出复制时间戳的菜单，目前有些bug，已知有时弹不出菜单。
- 辅助功能
- 用外部浏览器打开当前URL：右键菜单
- 默认搜索引擎：设置项
- 默认复制高亮的模板：设置项（目前仅支持非常简单的模板），请避免使用一些特殊字符
- 支持浏览历史记录：前后跳转网页
- 清除浏览历史记录：命令面板
- 所有链接都在右侧同一个面板中打开：设置项
- 切换是否在右侧同一面板中打开：命令面板
- 简单的夜间模式：主要是为了bilibili的夜间观感，有些瑕疵，问题不大
## 使用方法
### 利用浏览器书签在obsidain中打开网站
插件注册了一个 Obsidain uri 协议，该协议允许你使用`obsidian://web-open?url=`的网址在 Obsidian 中打开 Web-broswer
。其中``
指网页地址链接。配合 [bookmarklets](https://www.ruanyifeng.com/blog/2011/06/a_guide_for_writing_bookmarklet.html)
便能实现点击浏览器的一个书签，在ob内打开当前浏览器网址。
1. 在插件设置里打开`Open URL In Obsidian Web`选项
2. 该选项下有一个链接，拖拽这个链接到你外部浏览器的书签栏处，会生成一个书签; 你也可以点击这个链接复制 bookmarklets
代码，自己新建一个书签
3. 现在可以点击书签，将浏览器当前页面在 Obsidian 打开了
## 使用技巧
对于中文用户，你可能希望复制的高亮链接是可以直接显示原文，这种情况下，你可以应用下述的 Quickadd 脚本：
```javascript
selObj = window.getSelection();
text = selObj.toString();
text = await decodeURIComponent(text)
this.quickAddApi.utility.setClipboard(text);
return text;
```
然后粘贴取代原来的文本内容即可。
## 安装
- 目前尚未准备好上架市场
- 可以通过 [Brat](https://github.com/TfTHacker/obsidian42-brat) 插件安装
- 手动安装
1. 在该github页面找到release页面并点击
2. 下载最新的一次release压缩包
3. 解压，复制解压后的文件夹到obsidian插件文件夹下，确保该文件夹里有main.js和manifest.json文件
4. 重启obsidian（不重启也行，得刷新），在设置界面启用该插件
5. 欧了
## Contribution
- [皮皮](https://github.com/windily-cloud) - 中文翻译 && 部分功能实现
## Support
You can support original author `Trikzon` :
[
](https://ko-fi.com/trikzon)