- Fork 本仓库到自己的 Github 仓库
- Clone 代码到本地,并确保已安装 node / npm 环境
- 执行
npm i
安装依赖模块,然后执行npm run dev
确认项目是否能运行
- 确认项目能运行后,进入
src/pages/posts
,只保留一个 markdown 文件作为格式参考,或添加自己的文件,文档说明如下: - 第一行建议展示图片,代码会自动将第一行作为头图,也可以通过 front matter 规范使用 pic 字段表示,若未填写,将使用默认图片
- 第二行留空,第三行是文档描述,可以用
small
标签包裹,或通过 front matter 规范使用 desc 字段表示,若未填写,将使用默认描述 - 文档时间默认通过 node 获取文档创建时间,若不需要,可通过 front matter 规范使用 date 字段表示
- 文章标题可用
数字-标题
方式,便于统一处理
- 由于 Astro 最终打包为静态文件,支持所有资源部署平台,如 Github Pages、Vercel、Netlify。推荐使用 Vercel 部署,简单高效。其他平台可参考 astro 文档。以下为 Vercel 部署教程:
- 确保 Fork 的代码已上传到 Github,进入 Vercel 选择
Continue with GitHub
,将对应仓库导入 - 导入后,确认 FRAMEWORK PRESET 为 Astro(截图),若未选中,请选择 Astro,点击 Deploy,稍等片刻,等待部署完成
- 部署完成后,参考截图位置,即为你的域名地址,点击即可访问,非常简单
- 评论系统使用的是我的 key,若需自用,请参考 giscus 自行配置
- 请务必将
config.ts
中的信息配置为你自己的信息,特别是 repo,防止出现不可预料的错误
- 若你不是程序员,遇到不懂的名词,请谷歌解决,这个过程很有趣,若仍有问题,可直接问程序员,或提交 issue 问我
- 期待你玩得开心,欢迎给我提建议,或推荐「潮流周刊」给你的朋友