主题使用指南
配置站点
在 src/config.ts 中设置标题、默认作者、多语言站点描述、favicon 文件、规范网址、可用语言、每页文章数、手写字体和导航。站点描述由首页、SEO 元数据和 RSS 共用;favicon 路径对应 public/ 中的文件。文章自己的 author 会覆盖默认作者。导航项可以是内置页面名,也可以是带多语言名称的外部链接。
添加内容
文章放在 src/content/blog/<语言>/,独立页面放在 src/content/pages/<语言>/。同一篇内容的译文使用相同文件名。开发环境会显示 draft: true 的草稿供本地预览,生产构建会排除它们。
title: 文章标题
description: 简短摘要
author: 可选作者
pubDate: 2026-11-14
updatedDate: 2026-11-15
draft: true
pin: 1
category: 随笔
tags: [Astro, 写作]
title、description、pubDate 必填,其他字段可选。pin 取 1 到 99 时,文章固定在首页列表顶部,数字越大越靠前。省略或写成 0 时按日期排序。
使用 Markdown 和 MDX
普通文章使用 .md,需要组件时使用 .mdx。先导入 Astro 组件,再像标签一样使用:
import Callout from '../../../components/content/Callout.astro'
<Callout title="补充说明">MDX 可以直接渲染 Astro 组件。</Callout>
组件默认构建为静态 HTML。只有确实需要浏览器交互时才添加 client:*。用 astro dev --background 预览,出错时查看 astro dev logs;发布前运行项目检查和生产构建。