vergil-astro-theme
Astro / 博客 · 文档 · 作者 wsjz
Vergil 是一个基于 Astro 的个人网站主题，支持博客、文档、相册、图文动态等多种内容形态，并提供多视图切换与 Markdown 内容指令扩展。
模板详细介绍
Vergil 是一个面向创作者的 Astro 个人网站主题，基于 Dante 极简主题做了大量定制化和本地化改造。它采用多视图架构，每个视图拥有独立的布局、导航和页面结构，可通过配置在默认视图、沉浸阅读和简历模式之间切换，适合同时承载博客、作品集与个人展示。
内容组织方面，Vergil 提供标签、分类、专栏和文档目录四个维度，可自由组合；并通过自定义 Remark/Rehype 插件扩展 Markdown 语法，在普通 .md 文件中直接使用 ::: 与 : 指令插入提示块、选项卡、时间线、友链卡片、视频播放器等 30 余种组件，无需 MDX。相册系统支持 Golden 与 Seasons 两套主题、grid/masonry/timeline/carousel 布局切换以及 EXIF 信息展示。
主题还包含深色模式、基于 Fuse.js 的全文搜索、Giscus/Artalk 评论、浮动音频播放器、RSS、Sitemap 与 OG 卡片、自定义字体注册表、响应式适配和站点助理等特性。项目采用 MIT 许可证，需要 Node.js 18+，使用 pnpm 安装依赖并启动开发服务器。
主要特点
- 多视图架构：默认视图、沉浸阅读、简历模式，各自拥有独立布局与导航
- 四维内容组织：标签、分类、专栏、文档目录可自由组合
- Markdown 内容指令：通过 Remark/Rehype 插件支持 30 余种组件，无需 MDX
- 相册系统：Golden/Seasons 双主题、多种布局切换、Lightbox 与 EXIF 展示
- 图文动态：独立于博客的短内容流，纯 Markdown 编写并支持标签
- 站点助理：按页面路由定制对话台词，支持 Rive 和 Live2D
适用场景
- 搭建同时包含博客、文档和作品集的个人网站
- 为摄影作品建立带 EXIF 信息和季节过滤的相册页面
- 发布日常想法、读书摘抄等短内容动态
- 用 Markdown 指令在文章中插入提示块、选项卡、时间线等富内容组件
- 展示结构化个人简历页面
适合人群
- 习惯用 Markdown 写作、希望减少手动排版工作的创作者
- 需要在一个站点内整合博客、文档、相册与简历的个人用户
- 熟悉 Astro 或愿意使用 Node.js 工具链的前端开发者
使用前需要核对
- 需要 Node.js 18 及以上版本
- 克隆仓库后使用 pnpm install 安装依赖，pnpm dev 启动开发服务器
- 编辑站点配置文件，并在内容目录下编写 Markdown 开始创作
- 评论系统需配置 Giscus 或 Artalk 后启用
- 项目采用 MIT 许可证
本介绍由 AI 根据目录元数据和仓库 README 整理，实际功能以原仓库为准。
功能与适用范围
目录记录的用途为博客、文档，主要技术栈为Astro。功能是否完整实现，需要在源码和演示中进一步确认。
- Astro
- 博客
- 文档