- 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
,将对应的仓库 import 进去 - 导入后,确定 FRAMEWORK PRESET 是 Astro(截图),一般会默认选中,没有的话请选择这个,选择后,点击 Deploy 即可,稍等片刻,等待部署
- 过了一会儿部署完成了,参考截图位置,就是你的域名地址好了,点击进去就可以访问了,是不是很简单
- 由于评论系统使用的是我自己的 key,假如需要自用,辛苦参考 giscus 自己去配置一个,这样就和你的绑定了
- 一定一定需要把你的
config.ts
里面的信息配置成你自己的信息,特别是 repo,防止出现不可预料的错误。
- 假如你不是程序员同学,遇到不懂的名词,请谷歌解决,这个过程很有趣,假如还是不行,可以直接问问程序员,或者直接提交 issue 来问我
- 期待你玩得开心,也欢迎给我提建议,或者推荐「潮流周刊」给你的朋友