Skip to content

Self-hosted personal gallery application with online photo management and albums, supporting Live/Motion Photos, EXIF parsing, geolocation recognition, and an explore map.

docs(usage): clarify album URL behavior and slug reuse

Ahmet Ömer3c2d27f02852
diff --git a/docs/guide/usage.md b/docs/guide/usage.md
index 5a5ddfe9..604c5fca 100644
--- a/docs/guide/usage.md
+++ b/docs/guide/usage.md
@@ -21,7 +21,11 @@ For Apple Live Photos, use matching image and MOV filenames, such as `IMG_1234.h
Albums group photos by subject. ChronoFrame supports ordering for both albums and the photos within them.
-On self-hosted sites, album URLs are generated from titles. You can set a custom URL in the album form. Old URLs redirect after a rename; URLs from deleted albums remain reserved so an old link cannot open a different album. Choose a new URL if one was used before.
+On self-hosted sites, album URLs are generated from titles. You can set a custom URL in the album form. When an album has a current slug, its numeric URL permanently redirects to that slug; historical slug URLs redirect temporarily because a slug can be reassigned. If a slug cannot be assigned, the album keeps a numeric URL and remains accessible.
+
+::: warning Album URLs can be reused
+Only one album can hold a slug while it is current. Renaming an album frees the old URL, and any album, including the same one, can claim it, so an old link may open a different album after a rename. Deleting an album frees all of its URLs; old links then return 404.
+:::
::: warning Hidden albums also affect shared photos
Hidden albums restrict public visibility. ChronoFrame also restricts anonymous access to their photos, even when a photo belongs to a public album as well. Check the public gallery after changing visibility.
diff --git a/docs/zh/guide/usage.md b/docs/zh/guide/usage.md
index f64d7f32..116c0fc3 100644
--- a/docs/zh/guide/usage.md
+++ b/docs/zh/guide/usage.md
@@ -21,7 +21,11 @@ Apple Live Photo 的照片和 MOV 文件使用同一文件名,例如 `IMG_1234
相册可将同一主题的照片集中展示,支持相册排序和相册内照片排序。
-在自行部署的站点中,相册网址根据标题生成,也可以在相册表单中自定义。修改网址后,旧网址会重定向;删除相册后,其网址仍会保留,以免旧链接指向其他相册。曾使用过的网址不能重复使用,请选择新的网址。
+在自行部署的站点中,相册网址根据标题生成,也可以在相册表单中自定义。当相册拥有当前网址时,其数字网址会永久重定向到该网址;历史网址使用临时重定向,因为该网址之后可能被重新分配。如果无法分配网址,相册会保留数字网址并保持可访问。
+
+::: warning 相册网址可能被重新使用
+同一时间只有一个相册能持有某个当前网址。重命名相册会释放旧网址,任何相册(包括同一相册)都可以重新使用,因此旧链接之后可能打开另一个相册。删除相册会释放其所有网址,旧链接将返回 404。
+:::
::: warning 隐藏相册也会影响公开相册中的照片
隐藏相册用于限制公开展示,同时限制匿名访客访问其中的照片,即使该照片还属于公开相册;请在调整可见性后检查公开画廊的结果。