Astro博客文档

vergil-astro-theme — Astro 博客模板

作者 wsjz

Vergil 是一个基于 Astro 的个人网站主题,支持博客、文档、相册、图文动态等多种内容形态,并提供多视图切换与 Markdown 内容指令扩展。

看看你的网站会是什么样

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

1 个预览视图
整体预览
作者提供的预览

查看现有预览图,更多页面尚未采集。

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

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

采集于 2026-09-22查看来源

值得关注的模板亮点

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

01

多视图架构:默认视图、沉浸阅读、简历模式,各自拥有独立布局与导航

02

四维内容组织:标签、分类、专栏、文档目录可自由组合

03

Markdown 内容指令:通过 Remark/Rehype 插件支持 30 余种组件,无需 MDX

04

相册系统:Golden/Seasons 双主题、多种布局切换、Lightbox 与 EXIF 展示

05

图文动态:独立于博客的短内容流,纯 Markdown 编写并支持标签

06

站点助理:按页面路由定制对话台词,支持 Rive 和 Live2D

模板详细介绍

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 安装依赖并启动开发服务器。

Astro博客文档

适合你的项目吗?

适用场景

  • 搭建同时包含博客、文档和作品集的个人网站
  • 为摄影作品建立带 EXIF 信息和季节过滤的相册页面
  • 发布日常想法、读书摘抄等短内容动态
  • 用 Markdown 指令在文章中插入提示块、选项卡、时间线等富内容组件
  • 展示结构化个人简历页面

适合人群

  • 习惯用 Markdown 写作、希望减少手动排版工作的创作者
  • 需要在一个站点内整合博客、文档、相册与简历的个人用户
  • 熟悉 Astro 或愿意使用 Node.js 工具链的前端开发者

上手与定制指南

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

  1. 1

    需要 Node.js 18 及以上版本

  2. 2

    克隆仓库后使用 pnpm install 安装依赖,pnpm dev 启动开发服务器

  3. 3

    编辑站点配置文件,并在内容目录下编写 Markdown 开始创作

  4. 4

    评论系统需配置 Giscus 或 Artalk 后启用

  5. 5

    项目采用 MIT 许可证

查看仓库使用说明

授权与来源资料

使用条件与限制

待核对
  • 尚未完成使用条件评估,请先查看原仓库许可证。
查看许可来源
项目核对记录与介绍依据

模板资料

来源平台
GitHub
资料与维护参考分
资料一般 · 74 / 100
技术栈
Astro
网站类型
博客 · 文档
这个分数如何计算

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

这个项目需要核对什么

记录的仓库更新时间
2026-09-21
截图检查日期
2026-09-22

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

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

查看具体选型方法 →

介绍的制作与核对状态

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

当前版本没有可核对的编辑审核记录;旧的应用时间不代表已完成事实审核。

这条历史介绍未保存固定版本的来源快照。请对照当前仓库,发现不一致可反馈。

反馈内容错误

看看同类模板

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