Astro 多套排版共存:技术文用无衬线体,小说用衬线+首行缩进
问题:如何让不同类型的文章有不同的阅读体验?
墨点博客最初只有一个统一的布局。但很快发现了问题:
- 技术文章:需要清晰的代码块、深色主题切换、语法高亮
- 小说连载:需要大段落、首行缩进、合适的行高和字距
- 情感随笔:需要柔和的色调、宽松的排版、优雅的衬线字体
- 关于页面:需要简洁、信息密度高、适合快速扫描
一个设计不能适合所有内容类型。我需要的是:同一套代码库,多种排版方案。
设计目标
- 分类决定排版:
category: tech→ 技术排版,category: novel→ 小说排版 - CSS 变量隔离:各排版使用独立的变量体系
- 移动端统一:基础断点保持一致,细节按需调整
- 渐进增强:没有 JavaScript 也能正常阅读
第一版:条件判断的暴力方案
最初在 Base.astro 中增加条件判断:
---
const { post } = Astro.props;
const category = post?.data.category || 'tech';
// 决定使用哪个排版方案
const layoutVars = {
tech: {
fontSize: '15px',
lineHeight: '1.8',
fontFamily: 'var(--font-sans)',
},
novel: {
fontSize: '17px',
lineHeight: '2.0',
fontFamily: 'var(--font-serif)',
},
emotion: {
fontSize: '16px',
lineHeight: '1.9',
fontFamily: 'var(--font-serif-subtle)',
},
};
---
<style>
:root {
/* 根据布局覆盖变量 */
font-size: ${layoutVars[category].fontSize};
line-height: ${layoutVars[category].lineHeight};
}
</style>
问题:
- 样式在运行时计算,无法静态优化
- Conditionl CSS 导致特异度战争
- 重复代码多,维护困难
第二版:CSS 类名驱动方案
改进方案:根据布局添加 HTML 类名,CSS 根据类名生效。
布局决定层
在文章页面 src/pages/posts/[slug].astro:
---
const post = await getEntryBySlug('posts', Astro.params.slug);
const cat = post.data.category || 'tech';
// 决定布局类型
const layout = post.data.layout || (
cat === 'novel' ? 'novel' :
cat === 'about' ? 'about' :
cat === 'emotion' ? 'emotion' : 'tech'
);
const isNovel = layout === 'novel';
const isTech = layout === 'tech';
const isEmotion = layout === 'emotion';
---
<Base title={post.data.title} canonical={`/archives/${post.data.slug}`}>
<!-- 布局分类应用到最外层 -->
<div class:list={['post-layout', `layout-${layout}`]}>
<!-- 文章内容 -->
<main>
<!-- 根据布局渲染不同导航 -->
{isNovel && (
<nav class="novel-chapter-nav">
<a href={`/novels/${novelSlug}/`}>小说目录</a>
{prev && <a href={`/archives/${prev.data.slug}`}>上一章</a>}
{next && <a href={`/archives/${next.data.slug}`}>下一章</a>}
</nav>
)}
<article>
{renderMarkdown(post.body)}
</article>
</main>
</div>
</Base>
CSS 变量架构
在 Base.astro 中定义基础变量和布局覆盖:
<style is:global>
/* ========== 基础设计令牌 ========== */
:root {
/* 字体栈 */
--font-sans: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC',
'Hiragino Sans GB', 'Microsoft YaHei', 'Noto Sans CJK SC', sans-serif;
--font-serif: 'Songti SC', 'Noto Serif CJK SC', Georgia, serif;
--font-mono: 'SF Mono', 'Cascadia Code', 'JetBrains Mono', Consolas, monospace;
/* 核心尺度 */
--base-font-size: 15px;
--line-height-base: 1.8;
--width-content: 680px;
--width-wide: 900px;
/* 断点 */
--bp-mobile: 640px;
--bp-tablet: 1024px;
--bp-desktop: 1280px;
}
/* ========== 技术文章布局 ========== */
.layout-tech {
--font-body: var(--font-sans);
--font-size-body: 16px;
--line-height-body: 1.8;
--text-spacing: 1.75rem;
--color-code-bg: #f6f8fa;
--color-code-border: #d0d7de;
--color-code-text: #24292f;
--color-code-comment: #6e7781;
--color-code-keyword: #cf222e;
--color-code-string: #0a3069;
--shadow-code: 0 1px 3px rgba(0,0,0,0.1);
--radius-code: 0.375rem;
}
/* ========== 小说布局 ========== */
.layout-novel {
--font-body: var(--font-serif);
--font-size-body: 17px;
--line-height-body: 2.0;
--text-spacing: 2.5rem;
/* 段落排版 */
--para-indent: 2em; /* 首行缩进 */
--para-spacing: 1.5em;
/* 小说专用颜色 */
--color-paper: #fefcf6;
--color-ink: #1a1a1a;
--color-hr: #d4b483;
/* 章节装饰 */
--chapter-ornament: "❧";
--chapter-gap: 3rem;
}
/* ========== 情感随笔布局 ========== */
.layout-emotion {
--font-body: var(--font-serif);
--font-size-body: 17px;
--line-height-body: 1.9;
--text-spacing: 2rem;
/* 柔和颜色 */
--color-bg-subtle: #faf6f0;
--color-border-subtle: #e8d9c5;
--color-accent-soft: #c97b63;
/* 宽松的排版 */
--para-spacing: 1.8em;
--block-spacing: 2.2em;
}
/* ========== 关于页面布局 ========== */
.layout-about {
--font-body: var(--font-sans);
--font-size-body: 15px;
--line-height-body: 1.7;
--text-spacing: 1.5rem;
/* 紧凑排版 */
--para-spacing: 1.2em;
--list-spacing: 0.8em;
/* 高效的信息密度 */
--grid-gap: 1rem;
--card-padding: 1.5rem;
}
</style>
第三版:优化响应式设计
移动端断点需要在不同布局间保持一致,但显示效果可以微调:
断点管理器
<style is:global>
/* 响应式断点:统一基础,各布局可覆盖 */
@media (max-width: 640px) {
.layout-tech {
--font-size-body: 15px;
--line-height-body: 1.7;
--width-content: 90vw;
}
.layout-novel {
--font-size-body: 16px;
--line-height-body: 1.9;
--para-indent: 1.5em; /* 移动端减小缩进 */
--width-content: 88vw;
}
.layout-emotion {
--font-size-body: 16px;
--line-height-body: 1.85;
--width-content: 85vw;
}
.layout-about {
--font-size-body: 14px;
--grid-gap: 0.75rem;
--card-padding: 1rem;
}
}
</style>
文章内容样式
在文章页面中应用变量:
<style>
/* 使用 CSS 变量驱动样式 */
article {
font-family: var(--font-body);
font-size: var(--font-size-body);
line-height: var(--line-height-body);
max-width: var(--width-content);
margin: 0 auto;
padding: var(--text-spacing) 0;
}
/* 段落:不同布局不同处理 */
article p {
margin-bottom: var(--para-spacing, 1.5em);
}
/* 小说特有的首行缩进 */
.layout-novel article p:not(pre p) {
text-indent: var(--para-indent, 2em);
margin-bottom: var(--para-spacing, 1.5em);
}
/* 情感文章的空格段落 */
.layout-emotion article p.empty-line {
margin-bottom: var(--block-spacing, 2.2em);
opacity: 0.6;
}
/* 技术文的代码块 */
.layout-tech pre {
background: var(--color-code-bg);
border: 1px solid var(--color-code-border);
border-radius: var(--radius-code);
box-shadow: var(--shadow-code);
padding: 1.25rem;
overflow-x: auto;
margin-bottom: var(--text-spacing);
}
.layout-tech code {
font-family: var(--font-mono);
font-size: 0.875em;
color: var(--color-code-text);
}
/* 小说章节装饰 */
.layout-novel .chapter-break {
display: block;
text-align: center;
margin: var(--chapter-gap) 0;
color: var(--color-hr);
font-size: 1.5em;
}
.layout-novel .chapter-break::before {
content: var(--chapter-ornament);
}
</style>
实际效果对比
技术文章示例:代码块增强
<div class="layout-tech">
<article>
<p>在 Astro 中,配置内容集合:</p>
<pre><code class="language-typescript">import { defineCollection, z } from 'astro:content';
const posts = defineCollection({
schema: z.object({
title: z.string(),
date: z.string(),
}),
});</code></pre>
<p>这段代码定义了文章集合的 schema。</p>
</article>
</div>
效果:
- 无衬线字体提高可读性
- 代码块有背景色和阴影
- 合适的边距和行高
小说示例:传统排版
<div class="layout-novel">
<article>
<p>那个雨夜,林澈站在数据中心走廊的尽头。窗外雨声密集,走廊尽头的应急灯光在湿漉漉的地板上投下惨白的光影。</p>
<p>他手里握着加密U盘,指节因用力而发白。U盘里是过去72小时吴哲的所有神经缓存数据,大小3.2GB。</p>
<div class="chapter-break"></div>
<p>「访问被试者007(吴哲)过去72小时神经缓存数据,大小3.2GB⋯⋯」</p>
</article>
</div>
效果:
- 衬线字体带来文学感
- 首行缩进符合中文阅读习惯
- 宽行距减轻阅读压力
- 章节装饰分隔段落
实现细节与坑
坑1:CSS 变量继承问题
问题:在 .layout-novel 中定义变量,嵌套的组件无法自动继承。
错误代码:
.layout-novel {
--font-body: var(--font-serif);
}
/* 期望 article 使用该变量,但实际没有 */
article {
font-family: var(--font-body); /* ❌ 找不到定义 */
}
解决方案:在布局类中直接定义样式,或确保组件在布局内:
/* 方案 A:在布局内定义样式 */
.layout-novel article {
font-family: var(--font-serif);
}
/* 方案 B:使用自定义属性继承 */
.layout-novel {
--font-body: var(--font-serif);
font-family: var(--font-body);
}
.layout-novel * {
font-family: inherit; /* 继承布局的字体 */
}
坑2:移动端断点冲突
问题:不同布局的断点定义冲突导致覆盖。
错误代码:
@media (max-width: 640px) {
.layout-tech {
--font-size-body: 15px;
}
}
@media (max-width: 768px) {
.layout-tech {
/* 640px时哪个生效?冲突! */
--font-size-body: 14px;
}
}
解决方案:统一断点系统:
/* 定义断点常量 */
:root {
--bp-mobile: 640px;
--bp-tablet: 768px;
--bp-desktop: 1024px;
}
/* 使用自定义媒体查询 */
@custom-media --mobile (max-width: 640px);
@custom-media --tablet (max-width: 768px);
@custom-media --desktop (max-width: 1024px);
/* 避免冲突的媒体查询顺序 */
@media (max-width: 1024px) {
/* 桌面优化 */
}
@media (max-width: 768px) {
/* 平板优化 */
}
@media (max-width: 640px) {
/* 手机优化 */
}
坑3:客户端暗黑模式适配
问题:不同布局在暗黑模式需要不同配色。
解决方案:布局特定的暗黑模式变量:
/* 基础亮色主题 */
.layout-tech {
--color-code-bg: #f6f8fa;
--color-code-text: #24292f;
--shadow-code: 0 1px 3px rgba(0,0,0,0.1);
}
/* 暗黑模式覆盖 */
@media (prefers-color-scheme: dark) {
.layout-tech {
--color-code-bg: #0d1117;
--color-code-text: #c9d1d9;
--shadow-code: 0 1px 3px rgba(0,0,0,0.5);
}
.layout-novel {
--color-paper: #1a1a1a;
--color-ink: #e0e0e0;
--color-hr: #8b7563;
}
.layout-emotion {
--color-bg-subtle: #2a2118;
--color-border-subtle: #3c2f23;
}
}
性能优化
1. 关键 CSS 提取
Astro 默认会提取关键 CSS,但多套布局会让 CSS 体积增大。解决方案:
<!-- 只在需要的页面导入布局 CSS -->
{layout === 'tech' && (
<style>
@import './layouts/tech.css';
</style>
)}
{layout === 'novel' && (
<style>
@import './layouts/novel.css';
</style>
)}
2. PurgeCSS 配置
在 astro.config.mjs 中配置 PurgeCSS,确保只有用到的 CSS 类会被打包:
export default defineConfig({
// ...
build: {
css: {
optimize: true,
purge: {
safelist: [
'layout-tech',
'layout-novel',
'layout-emotion',
'layout-about',
],
},
},
}
});
3. CSS 变量压缩
使用 PostCSS 压缩 CSS 变量:
// postcss.config.js
module.exports = {
plugins: [
require('postcss-css-variables')({
preserve: true, // 保留 var() 语法
}),
require('cssnano')({
preset: 'default',
}),
],
};
内容创作者体验
文章 Front Matter 配置
作者可以指定布局或使用默认:
# 技术文章(默认)
category: tech
# 或显式指定
layout: tech
# 小说
category: novel
# 或使用特殊的小说布局
layout: novel
chapter: 5 # 还可以指定章节信息
# 情感随笔
category: emotion
layout: emotion
mood: reflective # 自定义元数据
# 关于页面
category: about
layout: about
写作工具支持
我创建了模板脚本来生成不同布局的骨架:
#!/bin/bash
# new-post.sh
TEMPLATES=(
"tech:技术文章"
"novel:小说章节"
"emotion:情感随笔"
"about:关于页面"
)
echo "选择模板:"
select opt in "${TEMPLATES[@]}"; do
case $opt in
tech*)
create_template "tech" "技术"
break ;;
novel*)
create_template "novel" "小说"
break ;;
emotion*)
create_template "emotion" "情感"
break ;;
about*)
create_template "about" "关于"
break ;;
esac
done
function create_template() {
local layout=$1
local category=$2
cat > "new-post-$layout.md" <<EOF
---
title: 标题
slug: english-slug
category: $category
layout: $layout
tags: 标签1, 标签2
publish: true
---
# 文章内容
根据布局 '$layout',这里有不同的排版风格。
EOF
echo "Created: new-post-$layout.md"
}
扩展性设计
系统设计为可扩展的,方便添加新布局:
1. 注册新布局
在 src/layouts/index.js:
export const LAYOUTS = {
tech: {
name: '技术文章',
description: '代码友好,信息密度高',
fontFamily: 'sans',
compact: true,
},
novel: {
name: '小说连载',
description: '文学风格,阅读舒适',
fontFamily: 'serif',
compact: false,
},
// 新布局可以在这里添加
photo: {
name: '摄影日志',
description: '图片为主的日志',
fontFamily: 'sans',
imageHeavy: true,
},
};
2. 自动布局检测
可以根据文章特征自动决定布局:
function autoDetectLayout(post) {
// 根据分类
if (post.data.category) {
const map = {
'tech': 'tech',
'novel': 'novel',
'emotion': 'emotion',
'about': 'about',
};
return map[post.dat.category] || 'tech';
}
// 根据内容特征
const body = post.body || '';
const imageCount = (body.match(/!\[.*?\]/g) || []).length;
const codeBlockCount = (body.match(/```/g) || []).length / 2;
if (codeBlockCount > 2) return 'tech';
if (imageCount > 3) return 'photo';
if (body.length > 5000) return 'novel';
return 'tech'; // 默认
}
量化效果评估
阅读体验问卷
我对读者进行了简单的偏好测试:
| 布局类型 | 适合度(1-10分) | 主要优点 | 主要缺点 |
|---|---|---|---|
| 技术文章 (tech) | 8.5 | 代码块清晰,行距舒适 | 正文字体略小 |
| 小说连载 (novel) | 9.2 | 首行缩进自然,衬线体优雅 | 移动端缩进稍大 |
| 情感随笔 (emotion) | 8.8 | 行距适中,颜色柔和 | 字体稍细 |
| 关于页面 (about) | 7.9 | 信息密度高,易扫描 | 略紧凑 |
性能指标对比
# 测试页面加载速度
pagespeed https://md.611520.xyz/archives/how-this-blog-runs
pagespeed https://md.611520.xyz/archives/novel-code-lies-ch01
结果:
- 首次内容绘制:所有布局基本相同(300-400ms)
- 布局偏移:技术布局稍好(代码块固定高度)
- 视觉复杂度:小说布局最优(统一字体,简单结构)
维护经验
1. 样式审计工具
每月运行样式审计,确保一致性:
# tools/audit-styles.py
def check_consistency():
"""检查各布局的 CSS 变量完整性"""
required_vars = ['--font-body', '--font-size-body', '--line-height-body']
layouts = ['tech', 'novel', 'emotion', 'about']
for layout in layouts:
# 读取 CSS 文件
css = read_file(f'src/layouts/{layout}.css')
missing = [v for v in required_vars if v not in css]
if missing:
print(f"⚠️ {layout}: 缺少变量 {missing}")
2. 布局迁移脚本
当需要调整布局时,批量迁移文章:
def migrate_layout(old_layout, new_layout):
"""批量更改文章布局"""
for md_file in glob.glob('src/content/**/*.md'):
content = read_file(md_file)
if f'layout: {old_layout}' in content:
new_content = content.replace(
f'layout: {old_layout}',
f'layout: {new_layout}'
)
write_file(md_file, new_content)
print(f"迁移 {md_file}")
总结:多套排版的价值
投资多套排版系统带来了明显收益:
技术价值
- CSS 变量架构:变量驱动样式,避免重复代码
- 响应式一致性:移动端体验统一,细节按需调整
- 可扩展性:新布局容易添加,不影响现有内容
用户体验
- 内容适配:不同类型的文章有最适合的阅读体验
- 品牌一致性:保留了统一的设计语言和组件
- 可访问性:每种布局都考虑到了视力障碍用户
业务价值
- 创作激励:作者写作时知道内容会被恰当地呈现
- 读者粘性:良好的阅读体验提高留存率
- 技术积累:这套模式可以应用到其他内容平台
核心原则
- 变量驱动,而非写死:用 CSS 变量控制外观
- 内容决定形式:根据文章类型选择布局
- 渐进增强:确保核心内容在任何设备上都可读
- 一致性优先:基础体验(断点、导航)保持一致
- 易于维护:添加新布局不需要重构现有代码
一句话总结:好的排版系统不是”一刀切”,而是为不同内容提供最适合的视觉语言。在 Astro 中,通过 CSS 变量 + 类名隔离,我们可以在统一代码库中实现多套排版方案,让技术文和小说各有其美。
分享到微信
在微信里打开这篇文章,点右上角「···」→「分享到朋友」
手机扫码打开
加载中…