kensanata/sitelen-mute

Sitelen Mute：极简静态图片画廊生成器

Sitelen Mute是一款无多余功能、风格极简的静态图片画廊生成器，仅专注于图片展示。生成的画廊由纯静态文件构成，无需服务器端处理，可直接上传至任何平台（如个人网站、云存储），兼容所有现代浏览器。

核心功能

• 无服务器依赖：生成的画廊为纯静态HTML/JS/CSS文件，部署零门槛。
• 自动优化：无损旋转图片、按拍摄时间排序多来源照片、自适应屏幕尺寸。
• 人脸检测：启用后可优化人物照片的缩略图居中效果（需安装facedetect工具）。
• 高效加载：即使在低速网络下也能快速加载，支持全景图全尺寸展示。
• 原始文件打包：将原始图片压缩为ZIP文件，供用户下载完整素材。

使用场景

• 个人旅行/生活照片分享：生成静态画廊后直接上传至云存储或个人博客。
• 活动图片集：整理会议、聚会照片，生成可分享的静态链接。
• 摄影作品展示：展示高清摄影作品，支持原始文件下载。

配置说明

基础命令

生成画廊的基础命令格式：

bash
./sitelen-mute [照片目录] [输出画廊目录]

示例（带人脸检测与元数据配置）：

bash
sitelen-mute -f --title "2020基多之旅" \
  --description "前往加拉帕戈斯途中，我们在厄瓜多尔基多停留了几天。" \
  --url https://example.com/gallery/2020-quito/ \
  基多照片目录 2020-quito画廊目录

Docker部署示例

1. 设置源照片目录与输出目录：

bash
SOURCE_DIR="$HOME/我的照片/相册1"
DEST_DIR="/var/tmp/我的静态画廊"

2. 生成带人脸检测的画廊：

bash
docker run --rm -it -u $(id -u):$(id -g) -v "$SOURCE_DIR":/mnt:ro \
  -v "$(dirname $DEST_DIR)":/destination kensanata/sitelen-mute \
  /mnt /destination/$(basename $DEST_DIR)-1 -f -j $(nproc)

3. 生成精简版画廊（无原始文件下载+限制最大图片尺寸）：

bash
docker run --rm -it -u $(id -u):$(id -g) -v "$SOURCE_DIR":/mnt:ro \
  -v "$(dirname $DEST_DIR)":/destination kensanata/sitelen-mute \
  /mnt /destination/$(basename $DEST_DIR)-2 -s -d -f -j $(nproc) \
  --max-full 1920x1080

注意事项

• 展示用图片会被缩放压缩（无损旋转），但ZIP包中的原始图片保持完整。
• 图片标题可从文本文件、XMP/EXIF元数据读取，默认优先级为txt→xmp→exif。
• 本地预览需通过HTTP服务（如python -m SimpleHTTPServer 8000）访问，直接打开HTML文件可能因跨域问题失败。
• 处理大尺寸全景图时，需调整ImageMagick的资源限制（修改/etc/ImageMagick-6/policy.xml中的宽度限制）。