AstroPaper 可定制项非常多。本文聚焦最常用配置,帮助你快速完成站点级调整。
目录
配置 SITE
主要配置位于 src/config.ts 的 SITE 对象。生产环境请务必设置 SITE.website,便于 canonical URL、社交卡片与 SEO 正常工作。
常见字段包括:
- website:站点域名
- author / profile:作者信息
- desc / title:站点说明与标题
- ogImage:默认分享图
- lightAndDarkMode:亮暗模式开关
- postPerIndex / postPerPage:列表数量
- showArchives / showBackButton:功能入口开关
- editPost:编辑入口配置
- dynamicOgImage:动态 OG 图开关
- lang / dir / timezone:国际化与时区
调整页面宽度
全站宽度由 global.css 的 max-w-app 控制,默认 max-w-3xl。你可以升级到 max-w-4xl 或更大,获得更宽的阅读区域。
配置站点 Logo
可选三种方式:
- 直接使用 SITE.title 文本
- 使用 Astro SVG 组件
- 使用 Astro Image 组件
如果需要根据亮暗模式切换不同 Logo,可参考 Header 组件里的主题图标逻辑。
配置社交链接
在 src/constants.ts 的 SOCIALS 中配置名称、链接、提示文案和图标。
配置分享链接
同样在 src/constants.ts 中调整 SHARE_LINKS,控制文章页可分享平台。
配置字体
AstroPaper 支持 Astro Fonts API。你可以在 astro.config.ts 中声明新字体,并在 Layout 与 global.css 中绑定变量。
总结
建议先完成 SITE、颜色与字体三件套,再逐步扩展 logo、分享和功能开关。这样能在最短时间内获得稳定、统一且可维护的站点体验。