Obsidian Image Gallery 项目常见问题解决方案
项目基础介绍
Obsidian Image Gallery 是一个为 Obsidian 笔记软件开发的零配置瀑布流图片库插件。该项目的主要目的是为用户提供一个简单易用的方式来展示和管理笔记中的图片。Obsidian Image Gallery 支持水平和垂直两种瀑布流布局,用户可以通过简单的代码块配置来生成图片库。
该项目主要使用 JavaScript 和 TypeScript 进行开发,依赖于 Obsidian 的插件开发框架。
新手使用注意事项及解决方案
1. 安装插件后无法在 Obsidian 中找到插件
问题描述:
新手在安装 Obsidian Image Gallery 插件后,无法在 Obsidian 的插件列表中找到该插件。
解决方案:
-
检查插件安装路径:
确保插件已正确安装到 Obsidian 的插件目录中。通常路径为你的笔记库/.obsidian/plugins/obsidian-image-gallery
。 -
启用插件:
打开 Obsidian,进入设置(Settings),在左侧菜单中找到“社区插件”(Community Plugins),确保 Obsidian Image Gallery 插件已启用。 -
重启 Obsidian:
有时插件需要重启 Obsidian 才能生效,尝试关闭并重新打开 Obsidian。
2. 图片库无法正确显示图片
问题描述:
在笔记中添加了图片库代码块后,图片库无法正确显示图片。
解决方案:
-
检查图片路径:
确保图片路径正确无误。路径应相对于笔记库的根目录。例如,如果图片位于Attachments/Folder
目录下,代码块应为:```img-gallery path: Attachments/Folder type: horizontal```
-
确认图片存在:
确保指定的目录中确实存在图片文件。如果目录为空或路径错误,图片库将无法显示图片。 -
刷新预览:
在 Live Preview 模式下,将光标移出代码块后,图片库会自动生成。如果使用的是源代码模式,按Cmd+E
(或Ctrl+E
)触发 Obsidian 的笔记预览。
3. 图片库布局不符合预期
问题描述:
图片库的布局(如水平或垂直)不符合预期,或者间距、边框等样式设置不生效。
解决方案:
-
检查代码块配置:
确保代码块中的配置项正确无误。例如,水平布局的代码块应为:```img-gallery path: Attachments/Folder type: horizontal```
垂直布局的代码块应为:
```img-gallery path: Attachments/Folder type: vertical```
-
调整设置项:
如果需要调整间距、边框半径等样式,可以在代码块中添加相应的设置项。例如:```img-gallery path: Attachments/Folder type: horizontal gutter: 10 radius: 5```
-
查看文档:
详细了解每个设置项的含义和默认值,可以参考项目的 README 文件或 Obsidian 插件文档。
通过以上步骤,新手用户可以更好地理解和使用 Obsidian Image Gallery 插件,解决常见的问题。