Vergil 主题文档

基本信息

基本信息

网站的基本信息包括标题、副标题、描述和头像,这些信息会显示在网站的多个位置。

配置文件

所有基本信息在 src/data/config/identity.ts 文件中修改。

网站标题

title: '我的博客',

标题会显示在:

  • 浏览器标签页
  • 网站 Logo 旁
  • 首页大标题
  • 分享卡片

副标题

subtitle: '记录生活与思考',

副标题通常显示在首页标题下方,用一句话描述你的网站定位。

网站描述

description: '一个关于技术、生活和摄影的个人博客',

描述用于 SEO 和分享卡片,搜索引擎会抓取这段文字作为网站简介。

头像

avatar: {
    src: avatarImage,
    alt: '我的名字'
}

头像会显示在:

  • 左侧边栏顶部
  • 分享卡片

头像图片建议放在 src/assets/images/ 目录下,尺寸建议 200×200 像素。

网站地址

website: 'https://example.com',

网站地址用于生成 RSS、Open Graph 等元信息中的完整 URL。请替换为你自己的域名。

网站图标

网站图标(favicon)存放在 public/favicon.svg,替换为自定义图标即可。

邮件订阅

在首页底部显示邮件订阅表单,让读者可以订阅你的博客更新。

subscribe: {
    enabled: true,
    title: '订阅我的博客',
    text: '每周更新,最新文章直接送达你的收件箱。',
    form: {
        action: 'https://xxx.com/subscribe',
    }
}

订阅表单需要一个第三方邮件服务来接收提交的数据,如 Buttondown、ConvertKit 或 Mailchimp。将 action 替换为你的服务提供的订阅地址即可。

分页数

控制列表页每页显示的内容数量:

postsPerPage: 8,
projectsPerPage: 8,

预览图

image: {
    src: '/vergil-preview.jpg',
    alt: '网站预览图'
}

预览图用于社交分享时显示的卡片图片,建议尺寸 1200×630 像素。