输入关键词,开始搜索

↑↓ 选择↵ 打开esc 关闭
沉浸

开始01-十分钟创建个人网站

2 min read

这一篇只做一件事:把站点跑起来,改成你的名字,发布上线。准备好 Node.js(24 或更高版本)、pnpm 和 Git 就可以开始。

跑起来

01安装 vg

vg 是 Vergil 的命令行工具,全局装一次,以后建站、升级都用它。

终端
npm install -g @vergil-astro/vergil-cli

02创建并启动

新建 my-site 文件夹,放入示例站,装好依赖,再启动开发服务器,文件夹名换成你想要的。启动后打开终端里给出的地址,通常是 localhost 的 4321 端口。改文件后浏览器会自动刷新。以后再启动,进到站点文件夹运行 pnpm dev 就行。

终端
vg init my-site

改成你的

打开 src/data/config/,下面几处改完,站点就是你的了:

改什么 在哪里
站点名、副标题、描述 identity.ts 的 siteInfo
首页顶部的介绍 identity.ts 的 heroData
顶部导航 nav.ts 的 headerNavLinks
页脚链接 nav.ts 的 footerNavLinks
头像 覆盖 public/assets/site/avatar.jpg

评论、搜索、开屏页、侧栏这些都有默认值,以后有空再慢慢调。评论默认是关着的,想开的话,按文档 评论系统 接好 Giscus 或 Artalk 再打开。

清掉示例内容

站点自带的文章、相册、示例知识库都是演示用的。先预演一遍,看看会删哪些,确认没问题再真正执行:

终端
pnpm reset:dry   # 只列出会删什么pnpm reset       # 真正清理
文档会留下

pnpm reset 会保留站内的 Vergil 使用文档,那是你之后要查的东西。想一起删掉,用 pnpm reset:all。

部署上线

把仓库推到 GitHub,然后在部署平台导入它。构建命令填 pnpm build,输出目录填 dist。以后每次推送,平台都会自动重新部署。

登录 Vercel,导入仓库,框架预设选 Astro,点部署。

国内访问更快。在腾讯云 EdgeOne 控制台进入 Pages,导入仓库,框架预设选 Astro。用默认域名不需要备案。

Netlify、GitHub Pages 同样可以,步骤见文档。

各平台的详细步骤,见文档 发布与部署。

站点上线了,下一篇写第一篇文章。

快速开始 站点配置

© 本文著作权归作者所有,转载请注明出处。

未知标题
00:00
00:00
播放列表