工程实践

样式陈列 · 一览许愿井的全部笔墨

一文陈列主题的全部排版与组件样式:标题、链接、引用、列表、代码、表格与图文。


一览纸墨的边界,让层次由排版与留白建立,而非装饰堆叠。

井水蓝仅作点睛,文字层级以墨色深浅表达。本文陈列 prose、标题、链接、引用、列表、代码、表格、图片与分隔线的全部样式。

一级标题之外:二级标题

二级标题用于章节的承转,字号 --step-4,上距 1.75rem,下距 0.5remscroll-margin-top 已避开吸顶头部。

三级标题:细节的收敛

三级标题 --step-2,用于章节内的再分段。

四级标题:更细的说明

四级标题 --step-1,用于技术细节与参数说明。

五级标题

五级与六级共用 --text-sm,仅作层级兜底。

六级标题

六级标题与五级同级,默认不单独强调。

段落与行内样式

正文采用 --font-serif 宋体系,17—18.5px/1.9,量度 720pxletter-spacing 0.01em加粗600 字重表达,不用斜体。行内代码--code-bg 衬底,0.15em 0.4em 内距。外部链接如 Hugo 官网 / Refactoring UI 悬停时下划线由淡转实。删除线 已废弃 与高亮 ==mark==(如主题未启用则按普通文本渲染)可用于对比。

中文与 code、数字 2026 混排时,不做强制空格,交由字体原生处理。

引用

首字以「起头,左缘 2px --accent,衬底 8% accent-wash,文字 hsl(206,18%,32%),最大宽度 60em 收敛。[INFERENCE] 暗色下沿用同款纹理,深浅由纸面对比自然区分。

第二段引用,用于验证 blockquote p 的段距与嵌套样式。

列表

无序列表

  • 第一级:功能也会产生维护成本
    • 第二级:提示与插件的增量
      • 第三级:每次启动时加载的决定
  • 第一级:让默认行为重新可见
  • 第一级:安静的命令行

有序列表

  1. 提出能够被证伪的假设
  2. 选择成本最低且信息量足够的观测
  3. 根据结果保留或排除假设
    1. 嵌套有序:等待时间正常
    2. 嵌套有序:排除该假设

任务列表

  • 已完成:井口涟漪
  • 待完成:硬币落水
  • 待完成:纸落墨沉

代码

行内 const paper = "var(--paper)" 与块级配合,顶栏显示语言标签与复制按钮(JS 增强,无 JS 时按钮隐藏)。

// 单一分页入口,见 layouts/_partials/paginator.html
{{ $paginator := false }}
{{ if .Paginator }}
  {{ $paginator = .Paginator }}{{/* 已由 head.html 创建则复用,避免二次 Paginate */}}
{{ end }}
if err != nil {
    return fmt.Errorf("topics 恰 1 项: %w", err)
}
// 主题切换:单一键 ww-theme
const THEME_KEY = "ww-theme";
document.documentElement.setAttribute("data-theme", t);
/* RUI 间距:4 8 12 16 24 32 48 64 … 邻比≥25% */
.hero { min-height: 360px; /* RUI豁免: 画布 */ }
假设:数据库连接池已经耗尽
观测:连接等待时间与活动连接数
结果:等待时间正常,排除该假设

未指定语言的围栏:

plain fences without language
  keep indentation

表格

令牌用途对比度
--paperhsl(60,16%,96%)页面底
--border-controlhsl(206,3%,51%)控件描边3.66:1
--accenthsl(206,43%,34%)井水蓝点睛4.5:1
功能桌面移动备注
版心min(1180, 100%-gutter*2)16px + safe-areamax-width: calc(100% - env(...))
量度720px ≈ 45em同上45–75 字符
头高82px56px--header-h

横向超宽表格将出现 table-scroll 出血(margin: -gutter; width: calc(100%+gutter*2))与滚动阴影:

列A列B列C列D列E列F列G列H
12345678
abcdefgh

图片与图注

涟漪示意

图:figure 上下 1.4remimg1px --border-default 细框承载,figcaption 12px/1.5 弱化。

分隔线


涟漪纹由 data-uri 绘制,色值 hsl+wash 8% 豁免;移动端退化为 64px×1px 实线。

脚注与细节

正文 16–18px/1.9段距 1rem,列表 0.5rem,表格 8×12chroma 行内 0.15em。焦点环 2px + 3px offset--accent,选区 well-200 成对定义前景墨色。

收束

所有层次皆在 primitives → semantic → components 分层中取用,--wp-* 不越层,color-mix 仅在 semantic 沉淀。详见 themes/hugo-wishingwell-theme/docs/DESIGN.md §4–§7.1