diff --git a/docs/docs/guide/frontend/lightbox.md b/docs/docs/guide/frontend/lightbox.md
index f0b8aa61..90a632f9 100644
--- a/docs/docs/guide/frontend/lightbox.md
+++ b/docs/docs/guide/frontend/lightbox.md
@@ -1,10 +1,12 @@
# 图片灯箱
-Artalk LightBox 插件能帮助你将网站**现有的图片灯箱**功能自动集成到 Artalk 中。
+Artalk 图片灯箱插件帮助你将网站**现有的图片灯箱**功能自动集成到 Artalk 中。
-::: code-group
+## 浏览器环境
+
+如果处于浏览器环境,博客主题通常自带图片灯箱,插件将自动检测 `window` 全局对象中的灯箱库,并集成到 Artalk 中,无需额外配置。
-```html [浏览器引入]
+```html
@@ -16,48 +18,104 @@ Artalk LightBox 插件能帮助你将网站**现有的图片灯箱**功能自动
```
-```ts [Node 引入]
-// pnpm add lightgallery @artalk/plugin-lightbox
+如有需要,可以通过全局变量 `ATK_LIGHTBOX_CONF` 对灯箱库进行额外的配置:
+
+```html
+
+```
+
+## Node 环境
+
+安装图片灯箱插件:
+
+```bash
+pnpm add @artalk/plugin-lightbox
+```
+
+配置插件,通过 `import` 动态引入灯箱库:
+
+::: code-group
+
+```ts [LightGallery]
import Artalk from 'artalk'
import { ArtalkLightboxPlugin } from '@artalk/plugin-lightbox'
import 'lightgallery/css/lightgallery.css'
Artalk.use(ArtalkLightboxPlugin, {
- // 手动配置引入灯箱库
lightGallery: {
- lib: async () => (await import('lightgallery')).default
- }
+ lib: () => import('lightgallery'),
+ },
})
```
-:::
+```ts [PhotoSwipe]
+import Artalk from 'artalk'
+import { ArtalkLightboxPlugin } from '@artalk/plugin-lightbox'
+import 'photoswipe/style.css'
-目前自动集成支持:[LightGallery](https://github.com/sachinchoolur/lightGallery) • [FancyBox](https://github.com/fancyapps/fancybox) • [lightbox2](https://github.com/lokesh/lightbox2) • [PhotoSwipe](https://photoswipe.com/)
+Artalk.use(ArtalkLightboxPlugin, {
+ photoSwipe: {
+ lib: () => import('photoswipe/lightbox'),
+ pswpModule: () => import('photoswipe'),
+ },
+})
+```
-对于暂未适配的灯箱库,我们期待你的 PR 😉:[@artalk/plugin-lightbox](https://github.com/ArtalkJS/Artalk/blob/master/ui/plugin-lightbox/src/main.ts)。
+```ts [LightBox]
+import Artalk from 'artalk'
+import { ArtalkLightboxPlugin } from '@artalk/plugin-lightbox'
+import 'lightbox2/dist/css/lightbox.min.css'
+import jQuery from 'jquery'
+
+window.$ = jQuery
-::: details 附:图片灯箱依赖 CDN 资源
+Artalk.use(ArtalkLightboxPlugin, {
+ lightBox: {
+ // @ts-ignore
+ lib: () => import('lightbox2'),
+ },
+})
+```
-注:一个博客主题可能包含现成的图片灯箱插件,无需重复引入。
+```ts [FancyBox]
+import Artalk from 'artalk'
+import { ArtalkLightboxPlugin } from '@artalk/plugin-lightbox'
+import 'fancybox/dist/css/jquery.fancybox.css'
+import jQuery from 'jquery'
-#### LightGallery
+window.$ = jQuery
-```html
-
-
+Artalk.use(ArtalkLightboxPlugin, {
+ fancyBox: {
+ // @ts-ignore
+ lib: () => import('fancybox'),
+ },
+})
```
-#### FancyBox
+:::
-```html
-
-
+在 Node 环境中,如有需要对灯箱库进行额外的配置,可以通过 `config` 选项配置:
+
+```ts
+Artalk.use(ArtalkLightboxPlugin, {
+ // ...
+ // Config for LightGallery
+ config: {
+ speed: 500,
+ },
+})
```
-:::
+---
+
+目前自动集成支持:[LightGallery](https://github.com/sachinchoolur/lightGallery) • [FancyBox](https://github.com/fancyapps/fancybox) • [lightbox2](https://github.com/lokesh/lightbox2) • [PhotoSwipe](https://photoswipe.com/)
+
+一些灯箱库暂未适配,期待你的 PR 😉:[@artalk/plugin-lightbox](https://github.com/ArtalkJS/Artalk/blob/master/ui/plugin-lightbox/src/main.ts)。