发布与部署
发布与部署
本章介绍如何将网站构建为静态文件并部署到线上。
SEO 与分享
在发布之前,建议为每篇文章配置好 SEO 信息,这样分享链接时能够显示预览卡片。
文章 SEO 配置
在博客文章的信息头中添加:
---
title: 文章标题
seo:
title: 分享时显示的标题
description: 分享时显示的描述
image: /images/share-cover.jpg
---
网站 SEO 配置
在 src/data/site-config.ts 中配置网站级的 SEO 信息:
image: {
src: '/vergil-preview.jpg',
alt: 'Vergil 主题预览图'
}
构建与部署
本地构建
运行以下命令生成静态文件:
npm run build
构建完成后,静态文件会输出到 dist/ 目录。
部署到 Vercel
- 在 Vercel 注册账号
- 导入你的 GitHub 仓库
- 框架预设选择 Astro
- 点击部署
Vercel 会自动监听代码推送,每次提交后自动重新部署。
部署到 Netlify
- 在 Netlify 注册账号
- 选择 Add new site → Import an existing project
- 选择你的 GitHub 仓库
- 构建设置:
- Build command:
npm run build - Publish directory:
dist
- Build command:
- 点击部署
部署到 GitHub Pages
- 在仓库设置中启用 GitHub Pages
- 选择 GitHub Actions 作为部署来源
- 项目已包含
.github/workflows/deploy.yml,无需额外配置
Info
如果部署后页面样式丢失,请检查 astro.config.mjs 中的 base 配置是否正确设置为你的仓库名。