Obsidian 插件：Emo

概述

嵌入 Markdown 在线文件/图像链接。此插件用于将图像上传到 Obsidian 中的托管或文件上传到 Github。

Readme(翻译）

下面是 emo-uploader 插件的自述翻译

Obsidian Emo Uploader

在 Obsidian 中嵌入 Markdown 在线文件/图片链接。

该插件用于将图片上传到托管平台或将文件上传到 Github（更多功能，现在可用）。

图床聚合 & 文件上传器：Imgur SM.MS Github Cloudinary Catbox ……

🚩中文

工作原理

状态

V2.16

适应了 Chevereto v3

V2.15

支持 chevereto

V2.14

添加 Github cdn 切换

提示

如果你想在 Imgur 上创建自己的客户端 ID，请重定向到 obsidian://emo-imgur-oauth。

在注册catbox时，请记住你的用户名。🤨

从 2.6 版本开始，支持剪贴板和拖拽文件；非图片文件在嵌入到 markdown 后，默认情况下会以没有 ”!” 开头的链接形式显示。

如何扩展

想要支持更多的平台吗？如果你想要贡献代码但又不想花太多时间阅读旧代码，你可以通过以下方式进行扩展。

• 参考现有的parms文件，通过向 src/Parms 添加文件来添加你的新uploader所需的参数。
• 使用你的parms接口。在 config.ts 中，添加关于你的uploader的参数配置，以提供选择并在运行时作为uploader的构造函数。
• 通过向 src/Uploader, src/Fragment 添加文件来实现你的uploader和settings panel。
• 在 settings-tab.ts 中，添加你的fragment以在设置选项卡中显示和设置参数。
• 在 main.ts 中的切换判断块中添加你的uploader。
• 进行测试。

完成了！ 😽

配置

1. 禁用 Obsidian 安全模式
2. 安装插件
   • 从 Obsidian 社区插件选项卡中安装
   • 使用发布版本
     • 在最新的发布版本中下载 main.js manifest.json 或 zip 文件
     • 将 main.js manifest.json 移动到 Obsidian Vault 的插件文件夹中的一个文件夹中
   • 手动安装
     • 克隆此存储库
     • 使用 yarn 或 npm 安装依赖项，例如 npm install
     • 运行 yarn run dev 开始编译
3. 启用插件
4. 配置设置 👉 一些详细信息：以配置 GitHub 为例
5. 享受便利之处 🌟

关于上传到 Github

对于来自代码世界之外的初学者，Github 是一个著名的互联网托管服务，用于软件开发和使用 Git 进行版本控制。

如果您需要关于托管图像的更多帮助，请转到 其他部分。这些服务更加专注于此。

这部分允许你将粘贴到 Obsidian 中的文件自动上传到你的 Github 仓库（而不是存储在本地）。当你想在笔记中提到一个你认为适合分享的文件，比如脚本、配置文件或其他文件时，这非常有用。当然，它也可以作为一个简单的图片上传工具，可以很好地将图片嵌入到 Markdown 文件中。但它不仅仅是一个图片上传工具，只要 Github 接受，你可以上传各种类型的文件。文件链接能否在 Obsidian 中渲染取决于 Obsidian 本身的支持。即使不能渲染，它们仍然可以作为链接使用。🍭只需删除开头的感叹号即可。

关于使用政策

GitHub服务条款

jsdelivr使用政策

⚠️ 请注意

1. Github 目标仓库必须是公开的，这意味着所有上传的文件都是公开的。Github 也更适合那些乐于分享的人。请确保您分享的文件对您来说是无害的。我个人期待有一天您上传的文件是无私分享的。🌻
2. 不要上传空文件。这在这里是没有意义且错误的。
3. 建议在面板中检查随机文件名。重复的文件名会引发错误。随机文件名将大大避免重复的文件名。
4. 一般来说，Github 已经足够慷慨了。但是您需要有一个适度的意识，不要过度滥用 Github 的服务。放松点，正常使用，比如在 Github 页面上，当然是可以接受的。但是如果您需要大量使用图片，请使用专业的图片托管服务（现在已经集成到这个插件中）。超出正常范围（例如在单个仓库中存储超过1GB 的文件），滥用 Github，并上传具有不良影响的坏文件可能会导致您的 Github 仓库甚至账户受到影响。
5. 我在这里使用的是 jsdelivr。它是免费的。就像上面所说的，不要滥用它。就像我在视频中所做的那样，使用 jsdelivr 传输大型视频是不好的，我已经删除了它。我的情况是一个小尺寸的视频。 😼

关于其他平台

除了 GitHub 之外，这里的其他平台都是纯粹的托管平台。注册一个账号并找到所需的参数。将参数放置到正确的位置，然后就可以像视频中演示的那样使用了。

ImgURL 和 SM.MS 是云存储平台，允许您上传图片到存储账户中。对于在中国生活的用户来说，它们比 GitHub 和 Cloudinary 更容易访问。

关于 Cloudinary，请参考 obsidian-cloudinary-uploader/README.md。当然，这里也支持 Cloudinary。如果您发现 Cloudinary 已经足够满足您的需求，您可以直接使用它。（实际上，我的插件体积更小。😳）

如果您在中国，不建议使用 imgbb。我发现上传到该平台的图片在中国大陆很难访问，并且通常以缩略图的形式呈现。

Imgur 很好用。但在我的网络环境中，很难访问和测试。我只是参考了一些帖子，实现了匿名上传。 感谢这个 参考。使用 imgur 匿名上传时，删除哈希值将以 ![deletehash](url) 的形式出现，用于防止您后悔上传错误的图片。您可以在 这里 或插件中删除它们。

Catbox 原本支持匿名上传。但我没有找到如何删除匿名上传的文件。为了避免意外情况，这里不提供 catbox 的匿名上传。

⚠️ 文件是公开可见的，请不要上传违禁物品！请自行检查服务限制。

注意

由于不同平台支持的文件范围不同，对于粘贴到此插件中的文件类型没有限制。这将导致不支持的类型上传失败且没有正确的响应。幸运的是，很少有奇怪的文件类型嵌入到文档中。（应该不会有很多，对吧？）

如果您需要将文件作为附件嵌入，请暂时关闭插件。

一般来说，Github、Cloudinary、Catbox支持任何文件类型，SM.MS、ImgURL支持常见的图像类型。

尝试上传平台不支持的文件或超过上限的文件大小可能会导致出现类似 ![](undefined) 的字符串。请注意，不要只是等待。

如果您喜欢这个插件，可以通过给我买一杯可乐来支持我的工作和热情：

谢谢！

感谢