六个页头是怎么变成一个的
改版前,这个博客有六份页头。
不是六个页面共用一份,是六份各自独立的代码——首页一份、文章页一份、归档页一份、标签云一份、标签详情一份、关于页一份。它们长得像,但没有一份是完全一样的。
复制粘贴的账单
把六份摆在一起对比,问题一目了然:
站名写死在四个文件里。 首页从数据库读 site_name,其余五个页面顶上都写着 const BLOG_TITLE = "Loki"。意味着在后台改站名,只有首页会变。这不是理论风险——设置项形同虚设。
版心有三种宽度。 首页 max-w-5xl、归档和标签 max-w-3xl、搜索和关于 max-w-2xl。从首页点进文章,内容框会突然跳宽;再点到归档,又缩回去。没有任何设计意图,纯粹是各写各的。
导航项每页不一样。 归档页的导航是「首页 / 归档 / 搜索」,标签页是「首页 / 归档 / 标签 / 关于」,首页是「首页 / 归档 / 标签 / 关于 + 后台入口」。你在归档页看不到「标签」入口,在标签页看不到「搜索」。
搜索页干脆没有页头页脚。 点进 /search,整个站点外框消失,只剩一个孤零零的搜索框,连回首页的链接都没有。
当前页高亮全靠手写。 每个页面在自己的导航里把对应那项硬编码成蓝色:<span style={{color:"#1890ff"}}>归档</span>。所以标签详情页 /tags/xxx 的导航里,「标签」这一项是不高亮的——因为那份复制过来的代码里,高亮的是别的项。
这些都不是「没做好」,是复制粘贴这种做法的必然产物。第一次复制的时候一切正常,之后每改一次就多一份分歧。
路由组:让页头只存在一次
Next.js App Router 有个特性叫路由组——用括号包住的目录不参与 URL 路径,但可以拥有自己的 layout。
于是把所有公开页面移进 (site):
src/app/
(site)/
layout.tsx ← 页头页脚只在这里出现一次
page.tsx → /
[slug]/ → /:slug
archive/ → /archive
tags/ → /tags
tags/[slug]/ → /tags/:slug
about/ → /about
search/ → /search
admin/ ← 不在组内,不会带上站点外框
login/
URL 一个都没变。/admin 和 /login 留在外面,自然就不会套上公开站的页头。
layout 里做的事很少:
export default async function SiteLayout({ children }) {
const { siteName, footerText, social } = await getSiteSettings();
return (
<div className="flex min-h-screen flex-col bg-bg">
<a href="#main" className="sr-only focus:not-sr-only ...">跳到正文</a>
<SiteHeader siteName={siteName} />
<main id="main" className="flex-1">{children}</main>
<SiteFooter siteName={siteName} footerText={footerText} social={social} />
</div>
);
}
站点设置读一次,7 个页面全部拿到。
三个单一来源
光有 layout 还不够,得把散落的事实收拢:
导航配置 收进 src/lib/site-nav.ts。高亮判定也收进去,写成一个函数而不是每页手写:
export function isNavItemActive(pathname: string, href: string): boolean {
if (href === "/") return pathname === "/";
return pathname === href || pathname.startsWith(`${href}/`);
}
首页要精确匹配(否则任何路径都会命中 /),其余匹配前缀——这样 /tags/foo 也会把「标签」点亮,顺手修好了标签详情页不高亮的问题。
站点设置 收进 src/lib/site-settings.ts,带兜底和 titleWithSite() 辅助函数。现在所有页面的 generateMetadata 都从这里取标题后缀,改站名全站生效。
版心 收成一个 Container 组件,只有两档:
<Container width="page"> {/* 列表类,宽 */}
<Container width="content"> {/* 正文阅读列,窄 */}
具体像素值交给皮肤的 --page-max / --content-max 决定。编辑部风格的正文列是 42rem,科技风格是 45rem——因为后者字号更小,同样字数需要更宽。
顺手拿到的东西
页头变成一个之后,往里加东西的成本就变成 1 份而不是 6 份。所以顺手补了几个原本「不值得改六遍」的功能:
⌘K 全站搜索。 复用已有的 /api/public/search,300ms 防抖,AbortController 防止乱序响应覆盖新结果,方向键导航,回车直达。搜索从「藏在页脚的一个链接」变成了随手可及。
移动端抽屉菜单。 原来窄屏下导航项是硬挤在一行的。
吸顶 + 滚动才显分隔线。 首屏不出现那条多余的横线。
跳到正文链接。 键盘和读屏用户可以跳过导航,sr-only focus:not-sr-only,只在聚焦时出现。
这些都不是什么惊人的功能。重点在于——当共享结构建立起来之后,它们才第一次变得「划算」。
顺带一提:一个死循环
改到页头的时候发现一个存在很久的 bug:后台入口组件 AdminLink 的逻辑是「已登录才渲染」。
于是:没登录 → 看不到入口 → 无从登录。
这个循环在改版前就存在,只是站长自己记得住 URL 所以没暴露。修法是在页脚放一个常驻的「管理」链接指向 /admin/posts——因为中间件已经会把未登录的请求重定向到 /login?from=/admin/posts,登录后自动回到目标页,一个链接同时服务两种状态。
收尾
这次重构没有增加任何架构复杂度。恰恰相反——删掉的代码比加的多,7 个页面加起来少了几百行。
所谓「抽象」,很多时候不是引入新概念,只是把本来就该是一个的东西,真的变成一个。
