148 lines
4.3 KiB
Markdown
148 lines
4.3 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. 文章目录开关
|
|
8. 可优先使用访问者系统字体
|
|
9. 社交资料支持
|
|
10. 自定义默认页面标题
|
|
11. 时间格式自定义
|
|
|
|
## 关于 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` 即可
|
|
|
|
也可以通过直接覆盖的方式来修改主题颜色, 在自定义样式的代码框中填入:
|
|
|
|
```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;
|
|
}
|
|
```
|
|
|
|
可覆盖名为 `day` 的配色方案
|
|
|
|
### 覆盖其他变量
|
|
|
|
如果要覆盖其他变量, 需要查看主题定义的 `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: ;
|
|
--color-theme-scrollbar: rgba(134, 134, 134, 0.45) rgba(255, 255, 255, 0);
|
|
--list-theme-marker: "►";
|
|
--size-theme-font: 1rem;
|
|
--height-theme-line: calc(var(--size-theme-font) * 1.54);
|
|
--radius-theme-border: 0;
|
|
--family-theme-font: 'JetBrains Mono';
|
|
--family-theme-fallback-font: -apple-system, BlinkMacSystemFont, 'segoe ui', Roboto, Oxygen,
|
|
Ubuntu, Cantarell, 'open sans', 'helvetica neue', Arial, 'Noto Sans',
|
|
'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji';
|
|
--width-theme-scrollbar: thin;
|
|
--lig-theme-font: none;
|
|
--width-theme-border: calc(var(--size-theme-font) * 0.125);
|
|
--style-theme-border: solid;
|
|
--style-theme-title-divider: dashed;
|
|
}
|
|
```
|
|
|
|
比如这里要让某个配色下面的字体使用 MacOS 默认的字体
|
|
|
|
```css
|
|
html[theme-color-scheme='matrix'] {
|
|
--family-theme-font: '-apple-system'
|
|
}
|
|
```
|
|
|
|
## 构建
|
|
|
|
项目使用原生 ES 模块, 用 `esbuild` 来构建, 使用 `pnpm` 管理依赖
|
|
|
|
确保已安装 `nodejs`
|
|
|
|
执行:
|
|
|
|
```shell
|
|
make
|
|
```
|
|
|
|
## 计划
|
|
|
|
|
|
## 原主题
|
|
|
|
- [Terminal](https://github.com/wan92hen/theme-terminal)
|
|
- [Hugo Terminal](https://github.com/panr/hugo-theme-terminal)
|