182 lines
5.1 KiB
Markdown
182 lines
5.1 KiB
Markdown
# Terminal
|
|
|
|
一款 Terminal 风格的 Halo 主题, 基于 wan92hen 的 [Terminal](https://github.com/wan92hen/theme-terminal) 修改
|
|
|
|
<img src="https://raw.githubusercontent.com/Erzbir/halo-theme-terminal/refs/heads/main/preview/scheme.png" alt="scheme">
|
|
|
|
前往: https://erzbir.com 查看
|
|
|
|
## 对原主题的修改
|
|
|
|
### 新增功能
|
|
|
|
1. PJAX
|
|
2. 自定义 CSS
|
|
3. 自定义主题配色
|
|
4. 指定深色/浅色模式配色
|
|
5. 子菜单
|
|
6. 像素化开关
|
|
7. 文章目录开关
|
|
|
|
### 样式
|
|
|
|
1. 更响应式的布局
|
|
2. 去除 a 标签的下划线
|
|
3. 修改分页与评论的排列顺序
|
|
4. 修改默认字体为 JetBrains Mono
|
|
5. 修改一些固定文字
|
|
6. 修改 footer 样式并且兼容小屏
|
|
7. 修改文章之间的间隔
|
|
8. 修改滑轨颜色为透明
|
|
9. 修改滑块颜色
|
|
10. 修改文章目录样式, 去除选中时的背景色
|
|
11. 修改分页的样式, 只有一个时居中, 适配小屏端
|
|
12. 修改一些标签的大小以及间距
|
|
13. 修改标题与文章的分割线
|
|
14. 让代码块背景色适配主题
|
|
15. 让搜索组件颜色适配主题
|
|
16. 让评论颜色适配主题
|
|
17. 修改友链的样式
|
|
18. 修改标签页以及归档页及分类页的列表显示
|
|
19. 修改按扭边框样式
|
|
20. 修改代码块背景
|
|
21. 禁用字体连字
|
|
22. 在移动端菜单纵向排列
|
|
23. 调整各个元素的间距等
|
|
24. 文章目录响应式显示
|
|
25. 改变布局逻辑
|
|
26. 新增左右侧边栏
|
|
27. 页头和页脚增加插槽
|
|
|
|
### 优化
|
|
|
|
1. 防止由于滑块引起的页面抖动
|
|
|
|
### 开发相关
|
|
|
|
1. 项目迁移至 ES modules 使用原生 JS 开发
|
|
2. 删除所有工具依赖, 引入 esbuild
|
|
|
|
## 关于 PJAX
|
|
|
|
**目前 PJAX 功能需要手动开启**
|
|
|
|
### 代码注入需注意的事项
|
|
|
|
预留了一个 `.ex-pjax` 类名, 可以通过将注入的标签设置 `class="ex-pjax"` 来使用 PJAX
|
|
|
|
如果要注入 `<script>`, 根据插入的位置需要为标签添加一些属性才能保证行为正常
|
|
|
|
在 `<head>`, `<footer>`, 以及 `.content` 下的 `<script>` 会被重新执行, 行为略有不同
|
|
|
|
- `<head>`: 重新执行所有请求页面新插入的无 `no-pjax` 属性的 `<script>`
|
|
- `<footer>`: 重新执行有 `data-pjax` 属性的 `<script>`
|
|
- `.content`: 重新执行有 `data-pjax` 属性的 `<script>`
|
|
|
|
设置 `no-pjax` 属性, 可以防止 `<script>` 被 PJAX 重新执行
|
|
|
|
### 已知的问题
|
|
|
|
首屏就加载全部 css 和 script 的情况下不会出现问题, 只有在动态注入的时候会出现一些问题
|
|
|
|
- highlightjs 插件的 _复制按扭_ 数量会随页面切换增加
|
|
|
|
## 关于自定义 CSS
|
|
|
|
目前只有原始 CSS 输入, 在样式设置中可以填入原始 CSS, 主题会直接将这段 CSS 插入到 head
|
|
|
|
### 新增自定义主题配色
|
|
|
|
比如这里增加一个名字叫 `default` 的配色:
|
|
|
|
```css
|
|
html[theme-color-scheme='default'] {
|
|
--color-theme-background: #000000;
|
|
--color-theme-foreground: #4eee85;
|
|
--color-theme-accent: #4eee85;
|
|
--color-theme-tag: #4eee85;
|
|
--color-theme-title: #4eee85;
|
|
--color-theme-meta: #4eee85;
|
|
--color-theme-framed: #4eee85;
|
|
--color-theme-menu: #4eee85;
|
|
--color-theme-header: #4eee85;
|
|
}
|
|
```
|
|
|
|
将这段 CSS 代码填入 `自定义样式` 后, 在 `深色/浅色配色方案` 的下拉框中选择 `custom`, 并填入配色名: `default` 即可
|
|
|
|
也可以通过直接覆盖的方式来修改主题颜色, 比如 `深色配色方案` 是 `day`, 在代码框中填入:
|
|
|
|
```css
|
|
html[theme-color-scheme='day'] {
|
|
--color-theme-background: #000000;
|
|
--color-theme-foreground: #4eee85;
|
|
--color-theme-accent: #4eee85;
|
|
--color-theme-tag: #4eee85;
|
|
--color-theme-title: #4eee85;
|
|
--color-theme-meta: #4eee85;
|
|
--color-theme-framed: #4eee85;
|
|
--color-theme-menu: #4eee85;
|
|
--color-theme-header: #4eee85;
|
|
}
|
|
```
|
|
|
|
### 覆盖其他变量
|
|
|
|
如果要覆盖其他变量, 需要查看主题定义的 `css` 并根据需要来覆盖, 一些全局变量在 `:root` 中定义:
|
|
|
|
```css
|
|
:root {
|
|
--color-theme-background: ;
|
|
--color-theme-foreground: ;
|
|
--color-theme-accent: ;
|
|
--color-theme-tag: ;
|
|
--color-theme-title: ;
|
|
--color-theme-meta: ;
|
|
--color-theme-framed: ;
|
|
--color-theme-menu: ;
|
|
--color-theme-header: ;
|
|
--list-theme-marker: "►";
|
|
--font-theme-size: 1rem;
|
|
--line-theme-height: calc(var(--font-theme-size) * 1.54);
|
|
--radius-theme-default: 0;
|
|
--font-theme-default: 'JetBrains Mono';
|
|
--font-theme-fallback: Monaco, Consolas, -apple-system, BlinkMacSystemFont, 'segoe ui',
|
|
Roboto, Oxygen, Ubuntu, Cantarell, 'open sans', 'helvetica neue';
|
|
--scrollbar-theme-width: thin;
|
|
--scrollbar-theme-color: rgba(134, 134, 134, 0.45) rgba(255, 255, 255, 0);
|
|
--font-theme-lig: none;
|
|
}
|
|
```
|
|
|
|
比如这里要让某个配色下面的字体使用 MacOS 默认的字体
|
|
|
|
```css
|
|
html[theme-color-scheme='matrix'] {
|
|
--font-theme-default: '-apple-system'
|
|
}
|
|
```
|
|
|
|
目前尚不方便, 等待将所有变量都放到 `:root` 中方便查看并覆盖
|
|
|
|
## 构建
|
|
|
|
项目使用原生 ES 模块, 用 `esbuild` 来构建, 使用 `pnpm` 管理依赖
|
|
|
|
确保已安装 `nodejs`
|
|
|
|
执行:
|
|
|
|
```shell
|
|
make
|
|
```
|
|
|
|
## 计划
|
|
|
|
- [ ] 调整代码高亮
|
|
|
|
## 原主题
|
|
|
|
- [Terminal](https://github.com/wan92hen/theme-terminal)
|
|
- [Hugo Terminal](https://github.com/panr/hugo-theme-terminal)
|