散落图墙布局：随机位置与轻度旋转，每次访问排列不同
Astro作品集
darkroom-wall-astro — Astro 作品集模板
作者 xuezx1999
Astro 摄影作品集模板，散落图墙布局，随机位置与旋转，支持暗房灯氛围和全屏查看。
看看你的网站会是什么样
浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。
全部页面与视图 3
截图用于了解视觉与布局，交互效果请以实际项目为准。
采集于 2026-09-27查看来源
值得关注的模板亮点
从已有项目资料中，快速了解它的特点。
按图片数量自适应列数，从 3 列到 9 列自动切换
交互完整：点击置顶、拖拽、视差、洗牌、双击全屏缩放平移
暗房灯氛围：按 D 键切换暖橘红灯，localStorage 持久化
文件即内容：图片丢进 public/pieces/，文件名自动成为标题
scan 脚本用 sharp 生成 400/600 两档 srcset，支持 watch 自动重扫
模板详细介绍
darkroom-wall-astro 是一套面向个人摄影作品集的 Astro 模板，核心是把照片以随机位置、轻度旋转的方式散落在一面「暗房墙」上。布局按图片数量自适应列数：9 张以内 3 列，10–16 张 4 列，17–30 张 5 列，31–60 张 7 列，更多则 9 列，每次访问的排列都不同。交互上支持点击置顶、拖拽、鼠标视差、一键洗牌和双击全屏，全屏内可滚轮缩放、拖动平移、Esc 关闭。
内容管理走文件系统：把图片放进 public/pieces/，文件名去掉扩展名就是显示标题，scan 脚本会读取尺寸并用 sharp 生成 400/600 两档 srcset，同时输出 src/data/pieces.gen.ts。支持 jpg、jpeg、png、webp、svg，HEIC 需要先转成 jpg。排序默认按 date 升序，date 优先从形如 2024.08.15 12-30.jpg 的文件名解析，否则用文件修改时间兜底。站点元信息集中在 src/config.ts，配色 token 在 src/styles/global.css 顶部，按 D 键或点右上角小灰点可切换暖橘红灯氛围，状态用 localStorage 持久化。
部署方面，README 给出了 Cloudflare Pages、Netlify、Vercel 的构建配置，构建命令 npm run build，产物目录 dist，public/_headers 已写好安全头与长缓存。仓库自带 8 张 demo SVG 占位图，clone 后 npm run dev 即可看到效果。需要注意：模板本身是纯静态前端，没有后端或数据库，作品集内容完全依赖本地文件；licenseStatus 为 review，使用前建议核对 LICENSE 文件；site 字段在部署前必须改成自己的域名，否则 canonical 和 sitemap 会指向错误地址。
Astro作品集
适合你的项目吗？
适用场景
- 个人摄影师搭建轻量作品集展示页
- 需要非网格化、带随机感的图片墙呈现方式
- 希望用文件系统管理作品、不想接 CMS 或数据库的静态站点
- 部署到 Cloudflare Pages、Netlify 或 Vercel 的纯静态项目
适合人群
- 熟悉 Astro 或愿意按 README 跑 npm 命令的前端使用者
- 作品数量在几十张以内、以图片展示为主的个人站点
- 接受文件名即标题、按文件修改时间兜底排序的简单内容流程
上手与定制指南
结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。
- 1
部署前必须修改 src/config.ts 中的 site 字段，否则 canonical 和 sitemap 会指向错误域名
- 2
HEIC 格式不被 scan 直接支持，需先用 sips 等工具转为 jpg 再放入 public/pieces/
- 3
src/data/pieces.gen.ts 为自动生成且已 gitignore，不要手动编辑
- 4
licenseStatus 为 review，使用前请核对仓库 LICENSE 文件的具体条款
- 5
模板为纯静态前端，不包含后端、数据库或用户系统，作品内容完全来自本地文件
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明MIT许可，允许免费使用、修改、分发和商用，仅需保留版权与许可声明。
使用时需要遵守
- 保留原作者版权声明和 MIT 许可证声明。
- 保留版权声明和许可声明于所有副本或实质部分
额外费用与待核对事项
- README未说明演示素材或第三方资源的授权范围
查看原文依据
Permission is hereby granted, free of charge, to any person obtaining a copy
许可证原文
MIT © 详见 [LICENSE](LICENSE)
README 原文
https://github.com/xuezx1999/darkroom-wall-astro/blob/main/LICENSEhttps://github.com/xuezx1999/darkroom-wall-astro/blob/HEAD/README.mdPermission is hereby granted, free of char
许可证原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-09-24。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料较完整 · 77 / 100
- 技术栈
- Astro
- 网站类型
- 作品集
这个分数如何计算
本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-07-23
- 截图检查日期
- 2026-09-24
已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 Astro。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
当前版本没有可核对的编辑审核记录；旧的应用时间不代表已完成事实审核。
这条历史介绍未保存固定版本的来源快照。请对照当前仓库，发现不一致可反馈。
反馈内容错误看看同类模板
对比同技术栈与用途的模板，找到更适合的视觉与内容结构。
astro-theme-cactus
A simple Astro theme. Use it to create your blog or website.
Astro · 作品集
astrofy
Astrofy is a free and open-source template for your Personal Portfolio Website built with Astro and TailwindCS…
Astro · 作品集
astro-nano
Astro Nano is a static, minimalist, lightweight, lightning fast portfolio and blog.
Astro · 作品集
astro-erudite
An opinionated, unstyled static blogging template built with Astro and native CSS.
Astro · 作品集
astro-sphere
Astro Sphere is a static, minimalist, lightweight, lightning fast portfolio and blog.
Astro · 作品集
astro-micro
Blog theme for Astro with search and comments built-in. Zero frameworks.
Astro · 作品集