Skip to content

Latest commit

 

History

History
29 lines (21 loc) · 2.21 KB

Deploy.md

File metadata and controls

29 lines (21 loc) · 2.21 KB

开发教程

一、准备工作

  1. Fork 本仓库到自己的 Github 仓库
  2. Clone 代码到本地,并确保已安装 node / npm 环境
  3. 执行 npm i 安装依赖模块,然后执行 npm run dev 确认项目是否能运行

二、文档格式说明

  1. 确认项目能运行后,进入 src/pages/posts,只保留一个 markdown 文件作为格式参考,或添加自己的文件,文档说明如下:
  2. 第一行建议展示图片,代码会自动将第一行作为头图,也可以通过 front matter 规范使用 pic 字段表示,若未填写,将使用默认图片
  3. 第二行留空,第三行是文档描述,可以用 small 标签包裹,或通过 front matter 规范使用 desc 字段表示,若未填写,将使用默认描述
  4. 文档时间默认通过 node 获取文档创建时间,若不需要,可通过 front matter 规范使用 date 字段表示
  5. 文章标题可用 数字-标题 方式,便于统一处理

部署说明

  1. 由于 Astro 最终打包为静态文件,支持所有资源部署平台,如 Github Pages、Vercel、Netlify。推荐使用 Vercel 部署,简单高效。其他平台可参考 astro 文档。以下为 Vercel 部署教程:
  2. 确保 Fork 的代码已上传到 Github,进入 Vercel 选择 Continue with GitHub,将对应仓库导入
  3. 导入后,确认 FRAMEWORK PRESET 为 Astro(截图),若未选中,请选择 Astro,点击 Deploy,稍等片刻,等待部署完成
  4. 部署完成后,参考截图位置,即为你的域名地址,点击即可访问,非常简单
  5. 评论系统使用的是我的 key,若需自用,请参考 giscus 自行配置
  6. 请务必将 config.ts 中的信息配置为你自己的信息,特别是 repo,防止出现不可预料的错误

最后

  1. 若你不是程序员,遇到不懂的名词,请谷歌解决,这个过程很有趣,若仍有问题,可直接问程序员,或提交 issue 问我
  2. 期待你玩得开心,欢迎给我提建议,或推荐「潮流周刊」给你的朋友