/* * ClassHelper文档站 —— docfx modern 模板的样式覆盖。 * * docfx 按 `template` 数组的顺序合并模板,这个文件排在最后,因此覆盖掉 modern 模板自带的 * `public/main.css`(它本身是空的,被留作官方覆盖点)。docfx.min.css 在本文件之前加载, * 所以同特异度的选择器这里写的会赢;Bootstrap 那类 0-2-0 的选择器要在下面用同等或更高的特异度压。 * * 两条原则: * 1) 只调版式与配色,不动 DOM 结构(结构改动都在 templates/classhelper/layout/_master.tmpl 里); * 2) 深色主题只覆盖**颜色**,几何与浅色完全一致 —— 切换主题时不该看到布局跳一下。 */ /* ── 设计令牌 ─────────────────────────────────────────────────────────── */ :root { --ch-font-ui: 'Segoe UI Variable Text', 'Segoe UI', 'Microsoft YaHei UI', 'Microsoft YaHei', -apple-system, BlinkMacSystemFont, 'PingFang SC', 'Hiragino Sans GB', sans-serif; --ch-font-mono: 'Cascadia Mono', 'Cascadia Code', Consolas, 'JetBrains Mono', 'Sarasa Mono SC', ui-monospace, SFMono-Regular, Menlo, monospace; --ch-accent: #0f6cbd; --ch-accent-soft: rgba(15, 108, 189, 0.08); --ch-radius: 8px; --ch-navbar-h: 60px; --bs-body-bg: #ffffff; --bs-body-color: #24292f; --bs-secondary-color: #59636e; --bs-tertiary-color: #7d8590; --bs-border-color: #d8dee4; --bs-link-color: var(--ch-accent); --bs-link-hover-color: #115ea3; --bs-link-color-rgb: 15, 108, 189; --bs-code-color: #b1370f; --bs-body-font-family: var(--ch-font-ui); --bs-body-font-size: 16px; --bs-body-line-height: 1.8; } [data-bs-theme='dark'] { --ch-accent: #6cb8ff; --ch-accent-soft: rgba(108, 184, 255, 0.12); --bs-body-bg: #1b1f24; --bs-body-color: #e6edf3; --bs-secondary-color: #9198a1; --bs-tertiary-color: #6e7681; --bs-border-color: #30363d; --bs-link-color: var(--ch-accent); --bs-link-hover-color: #96ccff; --bs-link-color-rgb: 108, 184, 255; --bs-code-color: #ffa198; } /* ── 基础 ─────────────────────────────────────────────────────────────── */ body { font-family: var(--ch-font-ui); font-size: 16px; line-height: 1.8; letter-spacing: 0.002em; -webkit-font-smoothing: antialiased; text-rendering: optimizeLegibility; } body > main.container-xxl { padding-top: 1.6rem; } :focus-visible { outline: 2px solid var(--ch-accent); outline-offset: 2px; border-radius: 3px; } /* ── 顶栏 ─────────────────────────────────────────────────────────────── */ header.bg-body { backdrop-filter: saturate(180%) blur(12px); } .navbar { min-height: var(--ch-navbar-h); } .navbar-brand { display: inline-flex; align-items: center; gap: 10px; font-size: 17px; font-weight: 600; letter-spacing: 0.01em; } .navbar-brand #logo { width: 28px; height: 28px; object-fit: contain; } /* 版本徽标:版本号由 docs/build.mjs 从根 package.json 注入,见 _master.tmpl 顶部注释 */ .ch-version { padding: 1px 7px; border: 1px solid var(--bs-border-color); border-radius: 999px; font-family: var(--ch-font-mono); font-size: 11px; font-weight: 500; line-height: 1.6; color: var(--bs-secondary-color); } /* 顶栏右侧那一组(官网链接 + GitHub 图标)。 `margin-left: auto` 只挂在组里的**第一个**元素上 —— 挂两个各推各的会散开。 */ .ch-nav-site { margin-left: auto; padding: 6px 10px; border-radius: 6px; font-size: 14px; color: var(--bs-secondary-color); text-decoration: none; white-space: nowrap; transition: color 0.15s ease, background-color 0.15s ease; } .ch-nav-site:hover { color: var(--bs-body-color); background: var(--ch-accent-soft); } .ch-nav-github { display: inline-flex; align-items: center; padding: 6px 8px; border-radius: 6px; color: var(--bs-secondary-color); transition: color 0.15s ease, background-color 0.15s ease; } .ch-nav-github:hover { color: var(--bs-body-color); background: var(--ch-accent-soft); } /* 顶栏一级导航(由 docfx.min.js 按 toc.yml 生成) */ .navbar-collapse { min-width: 0; } #navbar { min-width: 0; /* 章节有 7 个,窄屏上放不下就会换行成"首/页"这种两行标题 —— 改成横向滚动, 标题一律不折行(滚动条本身隐藏,触控板/滚轮照样能滚)。 */ overflow-x: auto; scrollbar-width: none; } #navbar::-webkit-scrollbar { display: none; } #navbar .navbar-nav { flex-wrap: nowrap; gap: 2px; } #navbar .nav-link { padding: 6px 12px; border-radius: 6px; font-size: 15px; white-space: nowrap; color: var(--bs-body-color); transition: color 0.15s ease, background-color 0.15s ease; } #navbar .nav-link:hover { color: var(--ch-accent); background: var(--ch-accent-soft); } #navbar .nav-link.active, #navbar .nav-item.active > .nav-link { color: var(--ch-accent); font-weight: 600; } /* 搜索框:默认是 Bootstrap 的灰底,这里做成产品里那种浅色输入框 */ form.search { position: relative; display: flex; align-items: center; } form.search > i.bi-search { position: absolute; left: 10px; font-size: 13px; color: var(--bs-tertiary-color); pointer-events: none; } form.search .form-control { min-width: 190px; padding-left: 30px; border-radius: 6px; background: var(--bs-tertiary-bg); } /* ── 左栏(章节导航)与右栏(本页内容) ───────────────────────────────── */ .toc-offcanvas { flex: 0 0 264px; max-width: 264px; padding-right: 8px; border-right: 1px solid var(--bs-border-color); } .toc-offcanvas .offcanvas-header { display: none; } #toc .nav, #affix .nav { display: flex; flex-direction: column; gap: 1px; } #toc .nav-link, #affix .nav-link { padding: 5px 10px; border-left: 2px solid transparent; border-radius: 0 6px 6px 0; font-size: 14.5px; line-height: 1.6; color: var(--bs-secondary-color); transition: color 0.15s ease, background-color 0.15s ease, border-color 0.15s ease; } #toc .nav-link:hover, #affix .nav-link:hover { color: var(--bs-body-color); background: var(--ch-accent-soft); } #toc .nav-link.active, #affix .nav-link.active { border-left-color: var(--ch-accent); color: var(--ch-accent); font-weight: 600; background: var(--ch-accent-soft); } #toc .nav .nav, #affix .nav .nav { margin-left: 10px; padding-left: 6px; border-left: 1px solid var(--bs-border-color); } #affix > .nav::before { content: '本页内容'; display: block; margin-bottom: 8px; font-size: 12px; font-weight: 600; letter-spacing: 0.06em; color: var(--bs-tertiary-color); } .affix .toc-filter { margin-bottom: 10px; } /* ── 正文 ─────────────────────────────────────────────────────────────── */ article { max-width: 46rem; color: var(--bs-body-color); } article > h1 { margin: 0 0 1.2rem; padding-bottom: 0.6rem; border-bottom: 1px solid var(--bs-border-color); font-size: 2rem; font-weight: 650; line-height: 1.35; letter-spacing: -0.01em; } article h2 { margin: 2.6rem 0 0.9rem; font-size: 1.4rem; font-weight: 650; line-height: 1.4; } article h3 { margin: 1.9rem 0 0.6rem; font-size: 1.13rem; font-weight: 650; line-height: 1.5; } article h4 { margin: 1.5rem 0 0.5rem; font-size: 1rem; font-weight: 650; } article h1, article h2, article h3, article h4 { scroll-margin-top: calc(var(--ch-navbar-h) + 16px); } article p, article li { line-height: 1.85; } article a { text-decoration-thickness: 1px; text-underline-offset: 2px; } /* 文档里大量出现「代码 + 中文」混排,行内代码要能跟正文对齐 */ article code { padding: 0.15em 0.4em; border-radius: 5px; background: var(--bs-tertiary-bg); font-family: var(--ch-font-mono); font-size: 0.875em; word-break: break-word; } article pre { margin: 1.1rem 0; padding: 14px 16px; border: 1px solid var(--bs-border-color); border-radius: var(--ch-radius); background: var(--bs-tertiary-bg); line-height: 1.65; overflow-x: auto; } article pre code { padding: 0; background: none; font-size: 13.5px; color: inherit; word-break: normal; } article blockquote { margin: 1.2rem 0; padding: 2px 0 2px 16px; border-left: 3px solid var(--ch-accent); color: var(--bs-secondary-color); } article blockquote p:last-child { margin-bottom: 0; } article table { display: table; width: 100%; margin: 1.2rem 0; border: 1px solid var(--bs-border-color); border-radius: var(--ch-radius); border-collapse: separate; border-spacing: 0; overflow: hidden; font-size: 14.5px; } article table thead th { background: var(--bs-tertiary-bg); font-weight: 600; white-space: nowrap; } article table th, article table td { padding: 9px 13px; border: 0; border-bottom: 1px solid var(--bs-border-color); border-right: 1px solid var(--bs-border-color); vertical-align: top; line-height: 1.7; } article table tr > *:last-child { border-right: 0; } article table tbody tr:last-child > td { border-bottom: 0; } article table img { max-width: 100%; } article img { max-width: 100%; border-radius: var(--ch-radius); } article hr { margin: 2.4rem 0; border-top: 1px solid var(--bs-border-color); opacity: 1; } /* 标题旁自动生成的锚点:默认常显会显得很吵,只在悬停/聚焦时露出来 */ article a.anchor, article h1 > a.anchor, article h2 > a.anchor, article h3 > a.anchor { float: none; margin-left: 8px; color: var(--bs-tertiary-color); opacity: 0; text-decoration: none; transition: opacity 0.15s ease; } article h1:hover > a.anchor, article h2:hover > a.anchor, article h3:hover > a.anchor, article a.anchor:focus-visible { opacity: 1; } /* ── 页脚区(上一页/下一页、编辑入口、站点页脚) ─────────────────────── */ .contribution { margin-top: 2.4rem; } .contribution .edit-link { display: inline-block; padding: 5px 12px; border: 1px solid var(--bs-border-color); border-radius: 6px; font-size: 13.5px; color: var(--bs-secondary-color); text-decoration: none; transition: color 0.15s ease, border-color 0.15s ease; } .contribution .edit-link:hover { border-color: var(--ch-accent); color: var(--ch-accent); } .next-article { margin-top: 1.6rem; padding-top: 1.2rem; } .next-article a { display: inline-flex; gap: 6px; align-items: baseline; max-width: 48%; font-size: 14.5px; } footer.border-top { margin-top: 2rem; padding: 20px 0; font-size: 13.5px; } .ch-footer { display: flex; flex-wrap: wrap; gap: 8px; align-items: center; justify-content: center; } .ch-footer a { color: var(--bs-secondary-color); text-decoration: none; } .ch-footer a:hover { color: var(--ch-accent); } .ch-footer-sep { color: var(--bs-tertiary-color); } /* ── 首页的入口卡片 ─────────────────────────────────────────────────────── 首页(docs/index.md)里手写的一小块 HTML。只在首页用到,所以没做成通用组件。 */ .ch-cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(250px, 1fr)); gap: 12px; margin: 1.6rem 0 2rem; } .ch-card { display: flex; flex-direction: column; gap: 6px; padding: 16px 18px; border: 1px solid var(--bs-border-color); border-radius: 10px; text-decoration: none; transition: border-color 0.15s ease, box-shadow 0.15s ease, transform 0.15s ease; } .ch-card:hover { border-color: var(--ch-accent); box-shadow: 0 6px 18px rgba(0, 0, 0, 0.07); transform: translateY(-2px); } .ch-card-title { font-size: 15.5px; font-weight: 600; color: var(--bs-body-color); } .ch-card-desc { font-size: 13.5px; line-height: 1.65; color: var(--bs-secondary-color); } .ch-tagline { margin: 0 0 1.6rem; font-size: 17px; color: var(--bs-secondary-color); } /* 首页的截图墙 */ .ch-shots { display: grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 16px; margin: 1.4rem 0 2rem; } .ch-shots img { width: 100%; border: 1px solid var(--bs-border-color); } @media (prefers-reduced-motion: reduce) { .ch-card { transition: border-color 0.15s ease; } .ch-card:hover { transform: none; } } /* ── 搜索结果页 ───────────────────────────────────────────────────────── */ .search-results .search-list-item { padding: 12px 0; border-bottom: 1px solid var(--bs-border-color); } /* ── 小屏 ─────────────────────────────────────────────────────────────── */ @media only screen and (max-width: 991px) { .toc-offcanvas { flex: 0 0 240px; max-width: 240px; } article > h1 { font-size: 1.7rem; } } /* 中屏(约 1000–1200px):顶栏放不下 7 个章节 + 搜索框,把每项收窄一档, 配合上面 #navbar 的横向滚动,标题不会被折成两行。 */ @media only screen and (max-width: 1200px) { #navbar .nav-link { padding: 6px 8px; font-size: 14px; } form.search .form-control { min-width: 150px; } } @media only screen and (max-width: 767px) { body { font-size: 15.5px; } .navbar-brand { font-size: 16px; } .ch-version { display: none; } article table { display: block; overflow-x: auto; white-space: nowrap; } article > h1 { font-size: 1.55rem; } .next-article a { max-width: 100%; } } /* ── 打印 ─────────────────────────────────────────────────────────────── */ @media print { .toc-offcanvas, .affix, header.bg-body, .contribution, .next-article { display: none !important; } article { max-width: none; } }