#我的增添修改 (持續更新)#
-
更改根目錄下的 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` 中的網站語言不同时需要設置
---