#我的增添修改 (持续更新)#
-
更改根目录下的 astro.config.mjs, 更改站点 url site
-
注意,若不删除 biome.yaml,在移动端显示会有 bug
-
媒体资源都放在 public 文件夹下
-
build.yml 也可以删除,原因如下:
- build.yml 中的构建功能已经包含在 astro_auto_deploy.yml 中
- Node.js 版本问题
build.yml 使用了 Node.js 22 和 23 版本
这些版本太新,可能不稳定
而 astro_auto_deploy.yml 使用的是更稳定的 Node.js 20 - 对于个人博客项目,不需要这么复杂的构建检查
保留一个部署工作流就足够了
- 主页显示内容条数的配置,它在 export const PAGE_SIZE = 8
#一些辅助工具 (持续更新)#
- icon 图标:你需要前往icones.js去搜索你想要的图标
#相关构建指令#
下列指令均需要在项目根目录执行:
Command | Action |
---|---|
pnpm install 并 pnpm add sharp | 安装依赖 |
pnpm dev /npm run dev | 在 localhost:4321 启动本地开发服务器 |
pnpm build | 构建网站至 ./dist/ |
pnpm preview | 本地预览已构建的网站 |
pnpm new-post <filename> | 创建新文章 |
pnpm astro ... | 执行 astro add , astro check 等指令 |
pnpm astro --help | 显示 Astro CLI 帮助 |
#基本信息使用#
1. 改写 config.ts#
- title:你的博客主标题
- subtitle:你的博客副标题。可选,在首页会显示为 "主标题 - 副标题"
- lang:博客显示语言。注释已经列出了一些常用的值,如:en, zh_CN, zh_TW, ja, ko
- themeColor:hue 值则是你的博客主题色,可以在你的博客右上角的画板图标确定喜欢的颜色再填写
- banner:src:即 banner 图片,支持 http/https URL
- favicon:src:即网站图标,支持 http/https URL
- links:即友情链接,这些链接在导航栏上
- avatar:即你的头像
- name:即你的名字
- bio:即个性签名,会显示在头像和名字下面
- NavBarConfig 为导航栏设置的超链接。ProfileConfig 为你的用户的超链接
2. 文章格式 Frontmatter#
---
title: My First Blog Post
published: 2023-09-09
updated: 2023-09-09
description: This is the first post of my new Astro blog.
image: ./cover.jpg
tags: [Foo, Bar]
category: Front-end
draft: false
lang: zh_CN # 仅当文章语言与 `config.ts` 中的网站语言不同时需要设置
---