mirror of
https://github.com/veeso/termscp.git
synced 2026-07-23 16:17:22 +02:00
98 lines
4.8 KiB
Markdown
98 lines
4.8 KiB
Markdown
# 主题
|
||
|
||
termscp 允许你为应用程序中的多个组件设置颜色。有两种方式可以自定义 termscp：
|
||
|
||
- 通过 **配置菜单**
|
||
- 导入 **主题文件**
|
||
|
||
## 通过配置菜单自定义
|
||
|
||
要通过配置菜单自定义 termscp，请在认证界面按 `<CTRL+C>` 进入配置，然后按两次 `<TAB>` 到达 `themes` 面板。使用 `<UP>` 和 `<DOWN>` 移动以选择你想更改的样式，如下面的 gif 所示：
|
||
|
||
|
||
|
||
## 导入主题文件
|
||
|
||
你也可以导入主题文件。你可以从仓库 `themes/` 目录中随 termscp 附带的某个主题获取灵感，或直接使用它。通过运行以下命令导入主题：
|
||
|
||
```sh
|
||
termscp theme <theme_file>
|
||
```
|
||
|
||
如果一切正常，termscp 会确认主题已导入。
|
||
|
||
## 颜色语法
|
||
|
||
termscp 接受以下颜色格式：
|
||
|
||
- 显式十六进制：`#rrggbb`
|
||
- RGB：`rgb(r, g, b)`
|
||
- [CSS 颜色名称](https://www.w3schools.com/cssref/css_colors.asp)（例如 `crimson`）
|
||
- 特殊关键字 `Default`，它使用与情境相关的默认前景色或背景色（文本和线条使用前景色，其余使用背景色）
|
||
|
||
## 从无法加载的主题中恢复
|
||
|
||
更新后，已保存的主题可能无法加载。这发生在向主题添加新键时：之前保存的主题不再包含该键。有两种快速修复方法：
|
||
|
||
1. 重新导入官方主题。每次发布后，官方主题都会被修补，因此从仓库下载更新后的主题并重新导入：
|
||
|
||
```sh
|
||
termscp theme <theme.toml>
|
||
```
|
||
|
||
2. 手动编辑你的主题。如果你使用自定义主题，请编辑该文件并添加缺失的键。主题位于 `$CONFIG_DIR/termscp/theme.toml`，其中 `$CONFIG_DIR` 为：
|
||
|
||
- FreeBSD/Linux：`$HOME/.config/`
|
||
- macOS：`$HOME/Library/Application Support`
|
||
- Windows：`%appdata%`
|
||
|
||
缺失的键会在你刚安装的版本的 CHANGELOG 中 `BREAKING CHANGES` 部分列出。
|
||
|
||
## 样式
|
||
|
||
下面的表格描述了每个样式字段。请注意，样式 **不** 适用于配置页面，因此即使你不小心更改了某些内容，配置页面也始终保持可用。
|
||
|
||
### 认证页面
|
||
|
||
| 键 | 说明 |
|
||
| ---------------- | -------------------------- |
|
||
| `auth_address` | IP 地址输入框的颜色 |
|
||
| `auth_bookmarks` | 书签面板的颜色 |
|
||
| `auth_password` | 密码输入框的颜色 |
|
||
| `auth_port` | 端口号输入框的颜色 |
|
||
| `auth_protocol` | 协议单选框组的颜色 |
|
||
| `auth_recents` | 最近记录面板的颜色 |
|
||
| `auth_username` | 用户名输入框的颜色 |
|
||
|
||
### 传输页面
|
||
|
||
| 键 | 说明 |
|
||
| -------------------------------------- | -------------------------------------------------- |
|
||
| `transfer_local_explorer_background` | 本地主机浏览器的背景色 |
|
||
| `transfer_local_explorer_foreground` | 本地主机浏览器的前景色 |
|
||
| `transfer_local_explorer_highlighted` | 本地主机浏览器的边框及高亮颜色 |
|
||
| `transfer_remote_explorer_background` | 远程浏览器的背景色 |
|
||
| `transfer_remote_explorer_foreground` | 远程浏览器的前景色 |
|
||
| `transfer_remote_explorer_highlighted` | 远程浏览器的边框及高亮颜色 |
|
||
| `transfer_log_background` | 日志面板的背景色 |
|
||
| `transfer_log_window` | 日志面板的窗口颜色 |
|
||
| `transfer_progress_bar_partial` | 部分进度条的颜色 |
|
||
| `transfer_progress_bar_total` | 总进度条的颜色 |
|
||
| `transfer_status_hidden` | 状态栏 "hidden" 标签的颜色 |
|
||
| `transfer_status_sorting` | 状态栏 "sorting" 标签的颜色；也适用于文件排序对话框 |
|
||
| `transfer_status_sync_browsing` | 状态栏 "sync browsing" 标签的颜色 |
|
||
|
||
### 杂项
|
||
|
||
这些样式适用于应用程序的不同部分。
|
||
|
||
| 键 | 说明 |
|
||
| ------------------- | -------------------------------- |
|
||
| `misc_error_dialog` | 错误消息的颜色 |
|
||
| `misc_info_dialog` | 信息对话框的颜色 |
|
||
| `misc_input_dialog` | 输入对话框的颜色（例如复制文件） |
|
||
| `misc_keys` | 按键文本的颜色 |
|
||
| `misc_quit_dialog` | 退出对话框的颜色 |
|
||
| `misc_save_dialog` | 保存对话框的颜色 |
|
||
| `misc_warn_dialog` | 警告对话框的颜色 |
|