LoveChengke
ded10118f5
官网（`website/`）
- 首屏标题放大一档（`--fs-display` 上限 3.6rem → 4rem），第二行改成**整行渐变填色**，
照 ClassIsland 官网那种「大标题 + 中间一段渐变 + 一行副标 + 一排徽章 + 两个按钮」的写法；
- 标题下补一排 mono 芯片（版本 / Windows / Linux·Docker / 触摸屏），主按钮换成
「立即下载」+「GitHub 仓库」；
- 顶部导航与页脚补「文档站」入口；页脚原本指向 GitHub blob 的那三个链接改成指向文档站
—— 那几个文件已经移到 `docs/management/` 下，原链接是 404。
> ⚠ 渐变那一行**不参与逐字揭示**：`main.js` 的 `setupHeadlineReveal` 会跳过 `.reveal-grad`。
> 拆成 per-char 的 `inline-block` 之后每个字各自建一层合成，祖先的 `background-clip: text`
> 就穿不过去，渐变会整行失效 —— 所以它按整行入场（透明度 + 轻微上浮）。
站点发布（`.github/workflows/pages.yml`，取代 `docs.yml`）
- **一个仓库在 GitHub Pages 上只有一个站点**，所以官网与文档站拼成一份产物：
官网在根、文档站在 `/docs/` 下，组装逻辑在 `scripts/build-pages.mjs`；
- 站点根 404 由 `website/404.html` 提供（含 `{{BASE}}` 占位符，由脚本与 workflow 按仓库名注入）；
- 官网目录里的 `serve.mjs` 与 `tools/` 是开发用的，不发布；
- `website/serve.mjs` 把 `../docs/_site` 挂在 `/docs/` 下，让本地预览与线上同形 ——
否则页脚那几个「文档站」链接在本地全是 404；
- 文档站模板顶栏补一个「官网」入口（`{{_rel}}../`）。
版本迭代
- `scripts/version.mjs` 补上**官网上手写的三处版本号**（顶栏徽标 / 首屏芯片 / 页脚）。
官网是纯静态站、没有构建步骤，没有哪段代码会去读 `package.json`，漏改的后果是
首页一直挂着旧版本号 —— 而那是别人看到的第一眼。落点从 10 处变成 13 处，
`AGENTS.md` §4.4 与 `docs/dev/release.md` 同步。
176 lines
9.2 KiB
Cheetah
176 lines
9.2 KiB
Cheetah
{{!班级小助手文档站的模板覆盖（只改必要的地方，其余保持 docfx modern 模板的行为）。}}
|
||
{{!
|
||
覆盖的是 docfx modern 模板的 layout/_master.tmpl，改动只有四处：
|
||
1) lang 固定 zh-CN；loc: 开头的那些 meta 是给 docfx.min.js 用的 UI 文案（导航、目录、上一页/下一页、
|
||
主题菜单、复制按钮…），modern 模板只提供英文，这里全部换成中文；
|
||
2) 顶栏右侧补一个 GitHub 图标链接与一个版本徽标（版本号由 docs/build.mjs 通过 --metadata 传入，
|
||
单一来源是根 package.json，别在这里写死）；
|
||
3) 补 <meta name="theme-color"> 与 color-scheme，让手机浏览器地址栏跟着深浅色走；
|
||
4) 页脚换成项目自己的（_appFooter 在 docfx.json 里）。
|
||
|
||
下面三行 include 决定**模板目录里哪些文件会被拷进产物**：public/（本模板的 main.css）与两个图标。
|
||
别删 —— 删了图标与样式就进不了 _site。
|
||
}}
|
||
{{!include(/^public/.*/)}}
|
||
{{!include(logo.png)}}
|
||
{{!include(favicon.png)}}
|
||
<!DOCTYPE html>
|
||
<html lang="zh-CN">
|
||
<head>
|
||
<meta charset="utf-8" />
|
||
{{#redirect_url}}
|
||
<meta http-equiv="refresh" content="0;URL='{{redirect_url}}'" />
|
||
{{/redirect_url}}
|
||
{{^redirect_url}}
|
||
<title>{{#title}}{{title}}{{/title}}{{^title}}{{>partials/title}}{{/title}} {{#_appTitle}}| {{_appTitle}} {{/_appTitle}}</title>
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||
<meta name="title" content="{{#title}}{{title}}{{/title}}{{^title}}{{>partials/title}}{{/title}} {{#_appTitle}}| {{_appTitle}} {{/_appTitle}}" />
|
||
<meta name="color-scheme" content="light dark" />
|
||
<meta name="theme-color" content="#ffffff" media="(prefers-color-scheme: light)" />
|
||
<meta name="theme-color" content="#1b1f24" media="(prefers-color-scheme: dark)" />
|
||
{{#_description}}<meta name="description" content="{{_description}}" />{{/_description}}
|
||
{{#description}}<meta name="description" content="{{description}}" />{{/description}}
|
||
<link rel="icon" href="{{_rel}}{{{_appFaviconPath}}}{{^_appFaviconPath}}favicon.ico{{/_appFaviconPath}}" />
|
||
<link rel="stylesheet" href="{{_rel}}public/docfx.min.css" />
|
||
<link rel="stylesheet" href="{{_rel}}public/main.css" />
|
||
<meta name="docfx:navrel" content="{{_navRel}}" />
|
||
<meta name="docfx:tocrel" content="{{_tocRel}}" />
|
||
{{#_noindex}}<meta name="searchOption" content="noindex" />{{/_noindex}}
|
||
{{#_enableSearch}}<meta name="docfx:rel" content="{{_rel}}" />{{/_enableSearch}}
|
||
{{#_disableNewTab}}<meta name="docfx:disablenewtab" content="true" />{{/_disableNewTab}}
|
||
{{#_disableTocFilter}}<meta name="docfx:disabletocfilter" content="true" />{{/_disableTocFilter}}
|
||
{{#docurl}}<meta name="docfx:docurl" content="{{docurl}}" />{{/docurl}}
|
||
<meta name="loc:inThisArticle" content="本页内容" />
|
||
<meta name="loc:searchResultsCount" content="找到 {count} 条结果（{query}）" />
|
||
<meta name="loc:searchNoResults" content="没有找到「{query}」" />
|
||
<meta name="loc:tocFilter" content="按标题过滤" />
|
||
<meta name="loc:nextArticle" content="下一篇" />
|
||
<meta name="loc:prevArticle" content="上一篇" />
|
||
<meta name="loc:themeLight" content="浅色" />
|
||
<meta name="loc:themeDark" content="深色" />
|
||
<meta name="loc:themeAuto" content="跟随系统" />
|
||
<meta name="loc:changeTheme" content="切换主题" />
|
||
<meta name="loc:copy" content="复制" />
|
||
<meta name="loc:downloadPdf" content="下载 PDF" />
|
||
|
||
<script type="module" src="./{{_rel}}public/docfx.min.js"></script>
|
||
|
||
<script>
|
||
const theme = localStorage.getItem('theme') || 'auto';
|
||
document.documentElement.setAttribute(
|
||
'data-bs-theme',
|
||
theme === 'auto' ? (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light') : theme,
|
||
);
|
||
</script>
|
||
|
||
{{#_googleAnalyticsTagId}}
|
||
<script async src="https://www.googletagmanager.com/gtag/js?id={{_googleAnalyticsTagId}}"></script>
|
||
<script>
|
||
window.dataLayer = window.dataLayer || [];
|
||
function gtag() {
|
||
dataLayer.push(arguments);
|
||
}
|
||
gtag('js', new Date());
|
||
gtag('config', '{{_googleAnalyticsTagId}}');
|
||
</script>
|
||
{{/_googleAnalyticsTagId}}
|
||
{{/redirect_url}}
|
||
</head>
|
||
|
||
{{^redirect_url}}
|
||
<body class="tex2jax_ignore" data-layout="{{_layout}}{{layout}}" data-yaml-mime="{{yamlmime}}">
|
||
<header class="bg-body border-bottom">
|
||
{{^_disableNavbar}}
|
||
<nav id="autocollapse" class="navbar navbar-expand-md" role="navigation">
|
||
<div class="container-xxl flex-nowrap">
|
||
<a class="navbar-brand" href="{{_appLogoUrl}}{{^_appLogoUrl}}{{_rel}}index.html{{/_appLogoUrl}}">
|
||
<img id="logo" class="svg" src="{{_rel}}{{{_appLogoPath}}}{{^_appLogoPath}}logo.svg{{/_appLogoPath}}" alt="{{_appName}}" />
|
||
{{_appName}}
|
||
{{#_chVersion}}<span class="ch-version">{{_chVersion}}</span>{{/_chVersion}}
|
||
</a>
|
||
<button class="btn btn-lg d-md-none border-0" type="button" data-bs-toggle="collapse" data-bs-target="#navpanel" aria-controls="navpanel" aria-expanded="false" aria-label="展开导航">
|
||
<i class="bi bi-three-dots"></i>
|
||
</button>
|
||
<div class="collapse navbar-collapse" id="navpanel">
|
||
<div id="navbar">
|
||
{{#_enableSearch}}
|
||
<form class="search" role="search" id="search">
|
||
<i class="bi bi-search"></i>
|
||
<input class="form-control" id="search-query" type="search" disabled placeholder="搜索" autocomplete="off" aria-label="搜索" />
|
||
</form>
|
||
{{/_enableSearch}}
|
||
</div>
|
||
<!-- 官网入口。文档站被发布在官网下面一层（<站点根>/docs/），所以从任意一页
|
||
回到官网就是「先退到文档站根（_rel），再退一层」。这个耦合与控制它的
|
||
.github/workflows/pages.yml 是同一件事，那边改布局这边要跟着改。 -->
|
||
<a class="ch-nav-site" href="{{_rel}}../" title="产品官网">官网</a>
|
||
<a class="ch-nav-github" href="https://github.com/LoveChengke/classhelper" target="_blank" rel="noopener noreferrer" title="GitHub 仓库" aria-label="GitHub 仓库">
|
||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="18" height="18" fill="currentColor" aria-hidden="true"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27s1.36.09 2 .27c1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.01 8.01 0 0 0 16 8c0-4.42-3.58-8-8-8Z"/></svg>
|
||
</a>
|
||
</div>
|
||
</div>
|
||
</nav>
|
||
{{/_disableNavbar}}
|
||
</header>
|
||
|
||
<main class="container-xxl">
|
||
{{^_disableToc}}
|
||
<div class="toc-offcanvas">
|
||
<div class="offcanvas-md offcanvas-start" tabindex="-1" id="tocOffcanvas" aria-labelledby="tocOffcanvasLabel">
|
||
<div class="offcanvas-header">
|
||
<h5 class="offcanvas-title" id="tocOffcanvasLabel">本页内容</h5>
|
||
<button type="button" class="btn-close" data-bs-dismiss="offcanvas" data-bs-target="#tocOffcanvas" aria-label="关闭"></button>
|
||
</div>
|
||
<div class="offcanvas-body">
|
||
<nav class="toc" id="toc"></nav>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
{{/_disableToc}}
|
||
|
||
<div class="content">
|
||
<div class="actionbar">
|
||
{{^_disableToc}}
|
||
<button class="btn btn-lg border-0 d-md-none" type="button" data-bs-toggle="offcanvas" data-bs-target="#tocOffcanvas" aria-controls="tocOffcanvas" aria-expanded="false" aria-label="展开本页目录">
|
||
<i class="bi bi-list"></i>
|
||
</button>
|
||
{{/_disableToc}} {{^_disableBreadcrumb}}
|
||
<nav id="breadcrumb"></nav>
|
||
{{/_disableBreadcrumb}}
|
||
</div>
|
||
|
||
<article data-uid="{{uid}}">{{!body}}</article>
|
||
|
||
{{^_disableContribution}}
|
||
<div class="contribution d-print-none">
|
||
{{#sourceurl}}
|
||
<a href="{{sourceurl}}" class="edit-link">在 GitHub 上编辑这一页</a>
|
||
{{/sourceurl}}{{^sourceurl}}{{#docurl}}
|
||
<a href="{{docurl}}" class="edit-link">在 GitHub 上编辑这一页</a>
|
||
{{/docurl}}{{/sourceurl}}
|
||
</div>
|
||
{{/_disableContribution}} {{^_disableNextArticle}}
|
||
<div class="next-article d-print-none border-top" id="nextArticle"></div>
|
||
{{/_disableNextArticle}}
|
||
</div>
|
||
|
||
{{^_disableAffix}}
|
||
<div class="affix">
|
||
<nav id="affix"></nav>
|
||
</div>
|
||
{{/_disableAffix}}
|
||
</main>
|
||
|
||
{{#_enableSearch}}
|
||
<div class="container-xxl search-results" id="search-results"></div>
|
||
{{/_enableSearch}}
|
||
|
||
<footer class="border-top text-secondary">
|
||
<div class="container-xxl">
|
||
<div class="flex-fill">{{{_appFooter}}}{{^_appFooter}}<span>班级小助手文档</span>{{/_appFooter}}</div>
|
||
</div>
|
||
</footer>
|
||
</body>
|
||
{{/redirect_url}}
|
||
</html>
|