问题:如何让不同类型的文章有不同的阅读体验?

墨点博客最初只有一个统一的布局。但很快发现了问题:

  1. 技术文章:需要清晰的代码块、深色主题切换、语法高亮
  2. 小说连载:需要大段落、首行缩进、合适的行高和字距
  3. 情感随笔:需要柔和的色调、宽松的排版、优雅的衬线字体
  4. 关于页面:需要简洁、信息密度高、适合快速扫描

一个设计不能适合所有内容类型。我需要的是:同一套代码库,多种排版方案。

设计目标

  1. 分类决定排版:category: tech → 技术排版,category: novel → 小说排版
  2. CSS 变量隔离:各排版使用独立的变量体系
  3. 移动端统一:基础断点保持一致,细节按需调整
  4. 渐进增强:没有 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>

问题:

  1. 样式在运行时计算,无法静态优化
  2. Conditionl CSS 导致特异度战争
  3. 重复代码多,维护困难

第二版: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}")

总结:多套排版的价值

投资多套排版系统带来了明显收益:

技术价值

  1. CSS 变量架构:变量驱动样式,避免重复代码
  2. 响应式一致性:移动端体验统一,细节按需调整
  3. 可扩展性:新布局容易添加,不影响现有内容

用户体验

  1. 内容适配:不同类型的文章有最适合的阅读体验
  2. 品牌一致性:保留了统一的设计语言和组件
  3. 可访问性:每种布局都考虑到了视力障碍用户

业务价值

  1. 创作激励:作者写作时知道内容会被恰当地呈现
  2. 读者粘性:良好的阅读体验提高留存率
  3. 技术积累:这套模式可以应用到其他内容平台

核心原则

  1. 变量驱动,而非写死:用 CSS 变量控制外观
  2. 内容决定形式:根据文章类型选择布局
  3. 渐进增强:确保核心内容在任何设备上都可读
  4. 一致性优先:基础体验(断点、导航)保持一致
  5. 易于维护:添加新布局不需要重构现有代码

一句话总结:好的排版系统不是”一刀切”,而是为不同内容提供最适合的视觉语言。在 Astro 中,通过 CSS 变量 + 类名隔离,我们可以在统一代码库中实现多套排版方案,让技术文和小说各有其美。