703 字
4 分钟
Astro-Fuwari主题全页面文字修改对照表(已校正)

Fuwari (Astro) 全页面文字修改对照表(已校正)#

项目根目录:/home/ubuntu/Astro/

✅ 以下路径均经实际验证,对照原表已删除无效条目。


一、独立页面(.astro 是页面壳,spec/*.md 写正文)#

  1. 关于页面(About)
    • 外壳:src/pages/about.astro
    • 正文:src/content/spec/about.md

二、列表页(标题文字取自 i18n,无独立 md 正文)#

  1. 归档页(Archive)

    • 外壳:src/pages/archive.astro
    • 页面标题「归档」:src/i18n/languages/zh_CN.ts[Key.archive]: '归档'
    • ⚡ 标签筛选和分类筛选也通过此页 URL 参数实现:/archive/?tag=xxx/archive/?category=xxx
  2. 标签(Tags) — ❌ 无独立页面,仅侧边栏 widget

    • widget 组件:src/components/widget/Tags.astro
    • 标题文字:src/i18n/languages/zh_CN.ts[Key.tags]: '标签'
    • 点击标签 → 跳转到归档页 /archive/?tag=xxx
  3. 分类(Categories) — ❌ 无独立页面,仅侧边栏 widget

    • widget 组件:src/components/widget/Categories.astro
    • 标题文字:src/i18n/languages/zh_CN.ts[Key.categories]: '分类'
    • 点击分类 → 跳转到归档页 /archive/?category=xxx

三、首页#

  1. 首页路由src/pages/[...page].astro(动态分页路由,❌ 不存在 index.astro)
  2. 侧边「最新文章」标题src/i18n/languages/zh_CN.ts[Key.recentPosts]: '最新文章'
  3. 网站标题、副标题src/config.tssiteConfig { title, subtitle }

四、侧边栏个人信息#

文件:src/config.tsprofileConfig { name, bio, avatar, links }

avatar: "assets/images/demo-avatar.png", // 头像路径(相对于 /src)
name: "肥猫少杰", // 昵称
bio: "用文字记录生活,用技术改变世界。", // 个性签名
links: [ /* 社交链接图标列表 */ ]

五、顶部导航菜单#

  1. 菜单文字翻译src/i18n/languages/zh_CN.ts
    • [Key.home]: '主页'[Key.about]: '关于'[Key.archive]: '归档'
  2. 菜单项配置(增删链接/顺序)src/config.tsnavBarConfig.links
    • 可使用 LinkPreset.HomeLinkPreset.AboutLinkPreset.Archive 预设
    • 也可自定义:{ name: "Hermes", url: "http://...", external: true }
  3. 预设映射关系src/constants/link-presets.ts

六、文章相关#

  1. 所有博客文章 mdsrc/content/posts/任意目录/xxx.md
  2. 文章详情页模板src/pages/posts/[...slug].astro
  3. 文章底部版权许可src/config.tslicenseConfig { enable, name, url }
  4. 「无标题」「未分类」「无标签」默认文案src/i18n/languages/zh_CN.tsuntitleduncategorizednoTags

七、全局组件与固定文案#

模块文件路径说明
搜索src/components/Search.svelte客户端搜索(Pagefind),导航栏内嵌
搜索按钮文字src/i18n/languages/zh_CN.ts[Key.search]: '搜索'
页脚src/components/Footer.astro版权年份、RSS、站点地图链接
主题色src/i18n/languages/zh_CN.ts[Key.themeColor]: '主题色'
亮色/暗色/跟随系统src/i18n/languages/zh_CN.ts[Key.lightMode/darkMode/systemMode]
评论标题src/i18n/languages/zh_CN.ts[Key.comments]: '评论'
更多src/i18n/languages/zh_CN.ts[Key.more]: '更多'
作者/发布于src/i18n/languages/zh_CN.ts[Key.author]: '作者'[Key.publishedAt]: '发布于'
许可协议src/i18n/languages/zh_CN.ts[Key.license]: '许可协议'
字数/分钟数src/i18n/languages/zh_CN.ts[Key.wordCount/wordsCount/minuteCount/minutesCount]
文章计数src/i18n/languages/zh_CN.ts[Key.postCount/postsCount]: '篇文章'

八、修改完生效命令#

Terminal window
cd /home/ubuntu/Astro
pnpm run build && sudo rsync -r --delete dist/ /var/www/astro/

九、视频背景(2026年6月22日新增)#

项目说明
视频来源https://mirai.sukuy.com/share_bb267daacbe5d1966f1d9e4bf9cbddcc1775912237115.mp4
组件src/components/VideoBanner.astro
引入布局src/layouts/MainGridLayout.astro
视频高度100vh(全屏 Hero)
失真处理object-cover + object-position: center center,等比缩放裁切
底部过渡linear-gradient(to bottom, transparent 0%, white 100%),覆盖底部 40%
深色模式渐变切换为 #1a1a2e
滚动行为absolute 跟随页面流,下滑后被下方白色内容自然覆盖
开关MainGridLayout.astroconst videoBannerEnabled = true;,改为 false 关闭
Astro-Fuwari主题全页面文字修改对照表(已校正)
https://fuwari.vercel.app/posts/指南/astro-fuwari主题全页面文字修改对照表/
作者
肥猫少杰
发布于
2026-06-15
许可协议
CC BY-NC-SA 4.0