Astro作品集

Vault — Astro 作品集模板

作者 hilava999

Vault 是一个基于 Astro 的插画作品集与画廊主题，通过 Markdown 与图片自动生成作品页面。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

1 个预览视图
桌面端首页
桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

目前有 1 张原始预览，可打开完整图片查看设计细节。

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-10-12查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

01

基于 Astro Content Collections 管理作品，Markdown 与图片放入文件夹即可自动生成作品页

02

Masonry 瀑布流布局展示作品，配合 PhotoSwipe 实现图片放大查看

03

支持为作品添加标签

04

通过 src/config/siteConfig.ts 集中配置站点标题、描述、主题色、页头图、图标、简介、社交链接与 OGP 图片

05

包含 OGP 支持与响应式适配

06

首页提供可选的 CreditLink 署名组件，可按需移除

模板详细介绍

Vault 是面向插画作品展示与记录的 Astro 主题，适合把作品按文件夹归档并自动生成画廊页面。作品管理基于 Astro Content Collections：在 src/content/log 下为每件作品建立文件夹，放入 index.md 与图片，页面即可自动生成，同一文件夹内的图片会被收集为画廊。index.md 的 frontmatter 支持 date（发布日期，必填）、cover（封面图，必填）与 tags（标签，可选）。站点信息集中在 src/config/siteConfig.ts 中配置，包括站点标题、描述、主题色、页头图、图标、个人简介、社交链接与 OGP 图片。布局使用 Masonry 瀑布流，图片点击后由 PhotoSwipe 放大查看，并包含标签功能与响应式适配。部署前需要修改 siteConfig 中的个人信息，并在 astro.config.mjs 的 site 字段填写自己的站点 URL 以保证 OGP 正常显示。README 给出的运行环境为 Node.js 22 以上与 Astro 7.x，可部署到 Cloudflare Pages（推荐）、Netlify、Vercel 等静态托管。主题以 MIT 许可发布，首页默认带有 CreditLink 组件，可按需删除。

Astro作品集

适合你的项目吗？

适用场景

  • 插画师整理并公开个人插画作品集
  • 以画廊形式按文件夹归档系列作品并附标签
  • 将作品集部署到 Cloudflare Pages、Netlify 或 Vercel 等静态托管

适合人群

  • 使用 Astro 并希望通过 Markdown 管理作品的创作者
  • 需要瀑布流画廊与图片放大浏览的插画作品集站点
  • 愿意在部署前修改站点配置与站点 URL 的使用者

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

  1. 1

    运行环境要求 Node.js 22 以上与 Astro 7.x

  2. 2

    克隆仓库后执行 npm install，再用 npm run dev 启动本地开发

  3. 3

    编辑 src/config/siteConfig.ts 填写站点标题、描述、主题色、页头图、图标、简介、社交链接与 OGP 图片

  4. 4

    在 astro.config.mjs 的 site 字段填写自己的站点 URL，以保证 OGP 图片正确显示

  5. 5

    作品放入 src/content/log 下的独立文件夹，每个文件夹包含 index.md（date 与 cover 必填，tags 可选）与图片；部署 Cloudflare Pages 时构建命令为 npm run build，输出目录为 dist

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

  • 允许免费使用、修改、商用和分发该版本代码。
  • 分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
  • 代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

  • 演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
  • 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
  • 部署前必须编辑 src/config/siteConfig.ts，将站点标题、个人简介、SNS 链接等替换为自己的信息，否则站点会保留主题作者的默认内容。
  • 为让 OGP 图片正确显示，必须在 astro.config.mjs 的 site 字段中填写自己的站点 URL，否则 OGP 相关功能无法正常工作。
  • 首页默认放置署名组件 CreditLink，是否保留为可选项；如觉得影响设计可自行删除，删除位置为 /src/pages/index.astro。
查看原文依据

Permission is hereby granted, free of charge

许可证原文

> デプロイ前に `src/config/siteConfig.ts` を編集し、サイトタイトルやプロフィール、SNSリンクなどをご自身の情報へ変更してください。

README 原文

OGP画像を正しく表示させるために`astro.config.mjs` の`site`に自分のサイトURLを設定してください。

README 原文

トップページにクレジットを置いていますが、表示するか否かは任意です。デザイン上、邪魔に感じましたら削除しても構いません。

README 原文
https://github.com/hilava999/Vault/blob/main/LICENSEhttps://github.com/hilava999/Vault/blob/main/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-12。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台
GitHub
资料与维护参考分
资料较完整 · 83 / 100
技术栈
Astro
网站类型
作品集
这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间
2026-07-01
截图检查日期
2026-10-12

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Astro。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

审核声明: [email protected] · 2026-10-13

查看当时使用的来源资料

SHA-256: 65fed58e8dbcc9976f58844dde9b9b4497e4da003acccbc9301a4dd25fc977c7

2026-10-12T23:13:17.181Z

来源文件 / 仓库
# Vault
### 🖼️ Astro製のイラスト作品の展示・ログ向けテーマ
Markdownファイルと画像を追加するだけで、作品ページを自動生成できます。
イラストの保管庫（Vault）のように、作品をシンプルにまとめられることを目指して開発しました。

[![Node.js >= 22](https://img.shields.io/badge/node.js-%3E%3D22-brightgreen)](https://nodejs.org/) [![Astro](https://img.shields.io/badge/Astro-7.0.3-orange)](https://astro.build/) ![License](https://img.shields.io/badge/license-MIT-green)

[🖥️デモサイト](https://vault-livedemo.pages.dev/)

![トップページ](doc/top.png)


## コンセプト
Vault は、イラスト作品をシンプルに整理・公開するための Astro テーマです。作品の追加は Markdown ファイルと画像を配置するだけ。作品管理に手間をかけず、創作そのものに集中できることを目指しています。



## ✨️ 特徴
- Astro Content Collections を利用した作品管理
- Markdown + 画像だけで作品ページを自動生成
- Masonryレイアウト
- PhotoSwipeによる画像拡大表示
- タグ機能
- コンフィグファイルによる簡単なサイト設定
- OGP対応
- レスポンシブ対応



## 📦️ 動作環境
- Node.js　22以上
- Astro   7.x



## 🚀 インストール
```bash
git clone https://github.com/hilava999/Vault.git

cd Vault

npm install

npm run dev
```



## ⚙️ 初期設定
`src/config/siteConfig.ts` を編集してください。

設定できる項目

- サイトタイトル
- サイト説明
- テーマカラー
- ヘッダー画像
- アイコン画像
- プロフィール
- SNSリンク
- OGP画像


## 🖼️ 作品の追加方法

フォルダを `src/content/log` に作成し、作品を入れてください。

例

```text
src/content/log/

001/
├ index.md
├ image1.webp
├ image2.webp

002/
├ index.md
├ image.webp
```

各フォルダ内に `index.md` を作成し、作品情報を記述します。同じフォルダ内の画像は自動で取得され、ギャラリーとして表示されます。

`index.md`の記入例

```markdown
---
date: YYYY-MM-DD
cover: ./cover.png
tags: ["タグ1","タグ2"]
---
```

- date → 投稿日、必須
- cover → サムネイル画像の指定、必須
- tags → タグ、任意

## ❗️注意事項
> デプロイ前に `src/config/siteConfig.ts` を編集し、サイトタイトルやプロフィール、SNSリンクなどをご自身の情報へ変更してください。

### OGPについて
OGP画像を正しく表示させるために`astro.config.mjs` の`site`に自分のサイトURLを設定してください。

## ☁️ デプロイ
### Cloudflare Pages(推奨)
|項目|設定値|
|---|---|
|Framework preset|Astro|
|Build command|`npm run build`|
|Build output directory|`dist`|

他、Netlify、Vercelなどの静的ホスティングに対応しています。詳しくは[Astroのドキュメント](https://docs.astro.build/ja/getting-started/)をご確認ください。

## 📷️ スクリーンショット
### トップページ
![トップページ](doc/top.png)

### 作品ページ
![作品ページ](doc/log.png)



## 📝 ライセンス
MIT License

### クレジットについて

トップページにクレジットを置いていますが、表示するか否かは任意です。デザイン上、邪魔に感じましたら削除しても構いません。削除する場合は、`/src/pages/index.astro`の以下のコードを削除してください。

```astro
<CreditLink />
```



## 🙏 使用ライブラリ
- Astro
- PhotoSwipe
- MiniMasonry
- Astro Icon



## 🐞 不具合・要望

不具合報告や機能要望は Issue よりお気軽にお知らせください。


## ⭐️ 最後に
このテーマが皆さんの創作活動のお役に立てれば嬉しいです。
反馈内容错误

看看同类模板

对比同技术栈与用途的模板，找到更适合的视觉与内容结构。

astro-theme-cactus

astro-theme-cactus

A simple Astro theme. Use it to create your blog or website.

Astro · 作品集

astrofy

astrofy

Astrofy is a free and open-source template for your Personal Portfolio Website built with Astro and TailwindCS…

Astro · 作品集

astro-nano

astro-nano

Astro Nano is a static, minimalist, lightweight, lightning fast portfolio and blog.

Astro · 作品集

astro-erudite

astro-erudite

An opinionated, unstyled static blogging template built with Astro and native CSS.

Astro · 作品集

astro-sphere

astro-sphere

Astro Sphere is a static, minimalist, lightweight, lightning fast portfolio and blog.

Astro · 作品集

astro-micro

astro-micro

Blog theme for Astro with search and comments built-in. Zero frameworks.

Astro · 作品集