feat: release Terminal-Witcher 3.1.17 and project handoff
Ship responsive navigation, configurable profile and four-section homepage, article/life category separation, natural-ratio book covers, and independent border settings. Include release history and complete context handoff documentation.
This commit is contained in:
@@ -34,6 +34,8 @@
|
||||
3. 在浅色方案或深色方案中选择 `custom`, 再填写自定义方案的 ID.
|
||||
4. 如需允许访客自由选择配色, 在 `页头 -> 功能按钮` 中保留或添加配色切换按钮.
|
||||
|
||||
自定义方案的高级颜色设置支持分别配置 `导航栏背景色` 和 `导航文字颜色`,同时作用于顶部导航、下拉菜单和手机全屏菜单。背景色留空时跟随页面背景,滚动后基于导航栏背景色显示半透明毛玻璃效果。
|
||||
|
||||
### 字体与像素风格
|
||||
|
||||
主题内置 JetBrains Mono, Hack 和 Fira Code, 也可以选择访客的系统字体. 如需加载自己的字体, 开启 `字体与排版 -> 启用自定义字体`, 再按优先级添加字体文件.
|
||||
@@ -47,14 +49,36 @@
|
||||
- `全屏布局` 会让正文占满可用宽度, 并可单独限制正文图片, 视频和 `figure` 的最大宽度
|
||||
- `正文区域最大宽度`, `正文区域内边距` 和 `表格宽度铺满父元素` 用于调整内容区域
|
||||
- `基础字体大小`, `基础行高` 和 `文章段落间距` 用于调整阅读密度
|
||||
- `无序列表标记`, 边线样式, 边线宽度和标题分隔线用于统一全站视觉风格
|
||||
- `无序列表标记`, 边线样式, 边线宽度和标题分隔线用于统一全站视觉风格;图片与卡片默认使用方角,主边框默认 2px。在 `全局样式 → 边线宽度(px)` 直接填写 1、1.5、2 等数字,0 隐藏主边框。留空时兼容原有的 `边线宽度(高级 CSS,可选)`,两项都留空时采用默认值
|
||||
- `元信息分隔符` 用于分隔文章时间, 作者和标签等信息
|
||||
|
||||
### 页面设置
|
||||
|
||||
首页采用错开的两排布局:上排为 70% 文章和 30% 生活,下排为 30% 阅读和 70% 作品集;窄屏自动变为单列。欢迎区左侧为可配置的个人简介,右侧沿用公告标题、公告内容和终端光标,无外框;标题靠左,公告内容在欢迎区域内靠右。各区域右侧入口统一为“更多”。
|
||||
|
||||
在 `主题设置 → 首页` 中配置欢迎区与个人简介:
|
||||
|
||||
- `欢迎区样式`:默认细节版,用淡电路走线、轻底色简介和细分隔线组织欢迎区;社交图标与文章归档、作品集快捷入口收在右侧欢迎内容底部。支持切换简洁版。颜色跟随主题,装饰不拦截点击。
|
||||
- `欢迎区左右比例`:默认左侧名片占 30%、右侧欢迎内容占 70%;也可切换为 50% / 50%。
|
||||
- 填写 `简介姓名或昵称`、`身份或研究方向` 和 `个人简介`;简介为纯文本,保留换行,文字左对齐。
|
||||
- `个人照片(可选)`:上传后显示在最右侧,简介位于照片左侧;不上传照片时只显示文字,不留照片占位。也支持仅放照片。
|
||||
- `关于我或完整简历链接(可选)`:可指向站内页面、外部网址或简历 PDF,不填则不显示链接。
|
||||
- 手机端先显示名片,再显示欢迎语,简介文字仍在照片左侧。所有简介字段均为空时隐藏简介;关闭 `欢迎区左侧展示个人简介` 可恢复全宽欢迎语。
|
||||
|
||||
在 `首页` 设置中维护四个区域:
|
||||
|
||||
- `首页文章来源`:默认展示生活分类以外的已发布文章,不会因为模块名为“文章”而自动筛选同名分类;旧版本保存的分类选择也不会自动开启筛选。生活分类(含子分类)优先归入首页生活区,即使文章同时属于技术分类,也不会在两个区域重复出现。排除生活文章后再按设置数量展示,“更多”进入完整归档 `/archives`。如需只展示某一分类,请选择“仅指定分类”,再设置 `首页文章分类`;此时同样排除生活文章,“更多”进入该分类。未找到生活分类时保留原有文章列表。
|
||||
- 顶层导航中名为“文章”的入口指向 `/archives`,其下嵌入式、机器人、Web 等分类链接仍指向各自分类。导航菜单的缩进用于组织链接,与文章分类管理中的真实父子关系分别维护,不需要为首页展示逐篇移动文章或修改原有分类。
|
||||
- `文章卡片列数`:自动模式按文章区实际宽度显示两列或三列,手机窄屏一列,也可手动选择两列或三列。`首页文章数量` 默认六篇,适合三列两行或两列三行;已有的自定义数量会保留,可在设置中调整。卡片上方为正方形封面,下方为标题、摘要和日期;无封面时使用终端字符占位。标题最多两行、摘要最多三行,标题提示和文章页保留完整内容。图片框使用方角和主题主边框,鼠标悬停或键盘聚焦提供反馈;减少动态效果模式关闭位移动画。
|
||||
- `生活文章分类`:选择已有分类,自动读取其中的文章及子分类文章。留空时寻找名为 `生活` 或别名为 `life` 的分类;名称不同时在此明确选择即可,无需调整技术文章的分类。`首页生活文章数量` 控制条数。设置文章封面后,生活列表会显示左侧小封面、右侧标题/日期/摘要;没有封面则采用纯文字布局。
|
||||
- `阅读书架`:添加书名、封面、一句话点评和可选的阅读笔记链接,每行两本。封面宽度铺满、高度按原图比例自然显示,不裁切、不添加固定比例框造成的上下留白;悬停时不放大裁切书封。通过 `首页书籍数量` 限制首页展示。“更多”默认指向 `/read`,创建别名为 `read` 的独立页面后即可访问;也可通过 `完整书架链接` 改为阅读分类或其它页面地址。
|
||||
- `首页作品来源`:自动模式读取已启用的项目集插件 `portfolio`,以封面、名称、介绍和开源仓库入口展示作品。插件未启用时使用 `手动作品`;也可直接选择手动模式。GitHub 仓库会显示 GitHub 链接。“更多”默认指向 `/portfolio`,可通过 `完整作品集链接` 修改。
|
||||
|
||||
未配置书籍、尚无生活文章或作品时显示简短的空状态。首页沿用主题现有字体、配色、标题分隔线和图片边框;其它页面保持原有布局宽度。
|
||||
|
||||
| 页面 | 可配置内容 |
|
||||
|-----|-----------------------------------|
|
||||
| 首页 | 公告标题, 公告内容, 社交资料, 置顶图标, 图标位置和文章标签 |
|
||||
| 首页 | 公告标题, 公告内容, 个人简介与照片, 社交资料, 置顶图标, 图标位置和文章标签 |
|
||||
| 文章页 | 文章目录, 目录默认状态和文章标签 |
|
||||
| 归档页 | 页面标题, 文章标签, 分页和年份展开模式 |
|
||||
| 分类页 | 分类列表标题和分类详情标题 |
|
||||
@@ -63,6 +87,8 @@
|
||||
|
||||
文章目录会读取正文中的 `h1` 到 `h4`. “自动”模式在普通布局中默认展开, 在全屏布局中默认收起; 目录也会根据浏览器宽度和正文右侧空间调整位置.
|
||||
|
||||
在 `主题设置 → 文章页` 中,`目录边框粗细(px)` 单独控制目录外框,默认 1px,支持小数和 0(隐藏外框)。`目录边框颜色` 留空时,按当前配色自动生成浅色线条,随明暗模式切换;也可选择固定颜色。目录内的层级辅助线沿用这个浅色,整体轮廓更柔和。
|
||||
|
||||
### 插件与扩展页面
|
||||
|
||||
| 功能 | 使用条件 |
|
||||
@@ -142,7 +168,8 @@ html[data-theme-color-scheme='matrix'] {
|
||||
| `--color-theme-accent-muted` | 中等强度强调色 |
|
||||
| `--color-theme-accent-subtle` | 低强度强调色 |
|
||||
| `--color-theme-navigation` | 主导航文字 |
|
||||
| `--color-theme-control` | 页头控件和 Logo |
|
||||
| `--color-theme-navigation-background` | 导航栏、下拉菜单及手机菜单背景 |
|
||||
| `--color-theme-control` | 页头工具控件 |
|
||||
| `--color-theme-surface` | 代码块和组件表面 |
|
||||
| `--color-theme-surface-strong` | 对比度更高的代码和控件表面 |
|
||||
| `--color-theme-border` | 默认边框 |
|
||||
@@ -169,7 +196,7 @@ html[data-theme-color-scheme='matrix'] {
|
||||
| `--content-theme-post-meta-divider` | `"::"` |
|
||||
| `--family-theme-font` | `'JetBrains Mono'` |
|
||||
| `--list-theme-style` | `disc` |
|
||||
| `--width-theme-border` | `calc(var(--size-theme-font) * 0.125)` |
|
||||
| `--width-theme-border` | `2px` |
|
||||
| `--width-theme-table-border` | `calc(var(--size-theme-font) * 0.0625)` |
|
||||
| `--width-theme-media-max` | `60%` |
|
||||
| `--spacing-theme-container-padding` | `calc(var(--size-theme-font) * 2.5)` |
|
||||
@@ -232,7 +259,7 @@ make test
|
||||
make clean
|
||||
```
|
||||
|
||||
`make test` 会构建主题, 清理旧的测试目录并将压缩包解压到 `dist/theme-terminal-ez`
|
||||
`make test` 会构建主题, 清理旧的测试目录并将压缩包解压到 `dist/theme-terminal-witcher`
|
||||
|
||||
### 使用 pnpm
|
||||
|
||||
@@ -245,9 +272,15 @@ pnpm build
|
||||
构建产物位于:
|
||||
|
||||
```text
|
||||
dist/theme-terminal-ez-<version>.zip
|
||||
dist/theme-terminal-witcher-<version>.zip
|
||||
```
|
||||
|
||||
## 版本与源码交接
|
||||
|
||||
主题版本以 `theme.yaml` 中的 `spec.version` 为准,当前集中交付版本为 **3.1.17**。对应的 Git 标签为 `3.1.17`,安装包与校验文件见 [3.1.17 发布页](https://gitea.witchercheung.cn/witcher/halo_theme_terminal/releases/tag/3.1.17)。
|
||||
|
||||
当前 Git 远程为 [自建仓库](https://gitea.witchercheung.cn/witcher/halo_theme_terminal)。版本变化见 [CHANGELOG.md](CHANGELOG.md);新会话接手先读 [HANDOFF.md](HANDOFF.md) 与 [PROJECT_CONTEXT.md](PROJECT_CONTEXT.md)。
|
||||
|
||||
## 原主题
|
||||
|
||||
- [Terminal](https://github.com/wan92hen/theme-terminal)
|
||||
|
||||
Reference in New Issue
Block a user