From 5a16467e717e8b5fb237589f541c2089d394a516 Mon Sep 17 00:00:00 2001 From: Christian Visintin Date: Mon, 8 Jun 2026 09:11:23 +0200 Subject: [PATCH] docs(zh): translate usage pages --- docs/zh-CN/usage/bookmarks.md | 30 ++++++++++++++++ docs/zh-CN/usage/file-explorer.md | 17 +++++++++ docs/zh-CN/usage/file-watcher.md | 28 +++++++++++++++ docs/zh-CN/usage/keyboard-shortcuts.md | 48 ++++++++++++++++++++++++++ docs/zh-CN/usage/multiple-files.md | 31 +++++++++++++++++ docs/zh-CN/usage/open-edit-files.md | 23 ++++++++++++ docs/zh-CN/usage/synced-browsing.md | 4 +++ 7 files changed, 181 insertions(+) diff --git a/docs/zh-CN/usage/bookmarks.md b/docs/zh-CN/usage/bookmarks.md index 1c1c38b..c7cfe0c 100644 --- a/docs/zh-CN/usage/bookmarks.md +++ b/docs/zh-CN/usage/bookmarks.md @@ -1 +1,31 @@ # 书签与最近主机 + +termscp 允许你将常用的主机保存为书签，随后可从主界面快速加载它们。termscp 还会保留你最近连接过的 16 个主机。这两项功能都让你只需在认证表单下方的选项卡中选择一个条目，即可重新加载连接到某个远程所需的全部参数。 + +## 书签的存储位置 + +书签会在可能的情况下保存在配置目录中： + +- Linux/BSD 上为 `$HOME/.config/termscp/` +- macOS 上为 `$HOME/Library/Application Support/termscp` +- Windows 上为 `FOLDERID_RoamingAppData\termscp\` + +## 保存密码 + +仅对于书签，你可以选择性地保存用于认证的密码。这不适用于最近主机，它们从不保存密码。默认情况下不保存密码；在你创建新书签时，系统会提示你选择是否保存。 + +如果你担心为书签保存的密码的安全性，请参阅[我的密码安全吗？](../configuration/password-security.md) + +## 创建书签 + +1. 在认证表单中填写连接到远程服务器的参数。 +2. 按 ``。 +3. 输入你想为书签指定的名称。 +4. 选择是否记住密码。 +5. 按 `` 提交。 + +## 加载书签 + +要使用先前保存的连接，请按 `` 导航到书签列表，然后按 `` 将书签参数加载到表单中。 + +![Bookmarks](https://github.com/veeso/termscp/blob/main/assets/images/bookmarks.gif?raw=true) diff --git a/docs/zh-CN/usage/file-explorer.md b/docs/zh-CN/usage/file-explorer.md index 469e193..680c3d3 100644 --- a/docs/zh-CN/usage/file-explorer.md +++ b/docs/zh-CN/usage/file-explorer.md @@ -1 +1,18 @@ # 文件浏览器 + +当你与远程主机建立连接后，termscp 会显示文件浏览器。浏览器由三个面板组成。 + +- **本地浏览器面板**：显示在屏幕左侧。它展示本地主机上当前目录中的条目。 +- **远程浏览器面板**：显示在屏幕右侧。它展示远程主机上当前目录中的条目。 +- **查找结果面板**：在你搜索文件后显示。根据你搜索的位置（本地或远程），它会替换本地浏览器面板或远程浏览器面板，并列出与你的搜索条件匹配的条目。 + +## 在面板之间切换 + +使用以下按键在面板之间移动。 + +- ``：移动到本地浏览器面板。 +- ``：移动到远程浏览器面板。 +- ``：切换当前活动的浏览器选项卡。 +- ``：在查找结果面板中时，退出该面板并返回上一个面板。 + +如需查看浏览器中可用按键的完整列表，请参阅[键盘快捷键](keyboard-shortcuts.md)。 diff --git a/docs/zh-CN/usage/file-watcher.md b/docs/zh-CN/usage/file-watcher.md index 257cd71..2b09c2f 100644 --- a/docs/zh-CN/usage/file-watcher.md +++ b/docs/zh-CN/usage/file-watcher.md @@ -1 +1,29 @@ # 保持文件同步 + +文件监视器会将本地路径同步到远程路径。当在被监视的本地路径上检测到更改时，该更改会在大约 5 秒内传播到配置的远程路径。 + +你可以监视任意数量的路径。 + +## 监视路径 + +1. 将光标置于本地浏览器上你想保持同步的文件或目录上。 +2. 在远程面板中，导航到应报告更改的目录。 +3. 按 ``。 +4. 在弹窗中回答 ``。 + +## 取消监视路径 + +你可以通过两种方式停止监视某个路径： + +- 在被监视的本地路径（或其任意子文件夹）上按 ``。 +- 按 ``，然后在你想取消监视的路径上按 ``。 + +## 传播的更改 + +以下更改会被报告到远程主机： + +- 新建文件和文件更改 +- 文件被移动或重命名 +- 文件被删除或取消链接 + +监视器仅在单一方向上工作（从本地到远程）。在远程主机上所做的更改**不会**被同步回本地主机。 diff --git a/docs/zh-CN/usage/keyboard-shortcuts.md b/docs/zh-CN/usage/keyboard-shortcuts.md index c0c8dcb..46e8ef1 100644 --- a/docs/zh-CN/usage/keyboard-shortcuts.md +++ b/docs/zh-CN/usage/keyboard-shortcuts.md @@ -1 +1,49 @@ # 键盘快捷键 + +以下按键可在文件浏览器中使用。随时按 `` 可打开应用内帮助。 + +| 按键 | 操作 | +| -------------- | ---------------------------------------------------------------------- | +| `` | 断开与远程的连接并返回认证页面 | +| `` | 返回导航栈中的上一个目录 | +| `` | 切换当前活动的浏览器选项卡 | +| `` | 移动到远程浏览器选项卡 | +| `` | 移动到本地浏览器选项卡 | +| `` | 在所选列表中向上移动 | +| `` | 在所选列表中向下移动 | +| `` | 在所选列表中向上移动 8 行 | +| `` | 在所选列表中向下移动 8 行 | +| `` | 进入所选目录 | +| `` | 上传或下载所选文件 | +| `` | 在日志选项卡与浏览器之间切换 | +| `` | 切换是否显示隐藏文件 | +| `` | 选择文件的排序方式 | +| `` | 复制所选文件或目录 | +| `` | 新建目录 | +| `` | 删除所选文件 | +| `` | 搜索文件（支持通配符匹配） | +| `` | 跳转到指定路径 | +| `` | 显示帮助 | +| `` | 显示所选文件或目录的信息 | +| `` | 创建指向当前所选条目的符号链接 | +| `` | 重新加载当前目录的内容，或清除当前选择 | +| `` | 选择一个文件 | +| `` | 使用提供的名称创建新文件 | +| `` | 在文本编辑器中编辑所选文件 | +| `

` | 打开日志面板 | +| `` | 退出 termscp | +| `` | 重命名所选文件 | +| `` | 将所选文件另存为新名称 | +| `` | 将所选路径上的更改同步到远程 | +| `` | 进入上级目录 | +| `` | 使用该文件类型的默认程序打开所选文件 | +| `` | 使用你指定的程序打开所选文件 | +| `` | 执行命令 | +| `` | 切换同步浏览 | +| `` | 更改文件模式 | +| `` | 过滤文件（同时支持正则表达式和通配符匹配） | +| `` | 选择所有文件 | +| `` | 取消选择所有文件 | +| `` | 中止文件传输过程 | +| `` | 获取所选路径的总大小 | +| `` | 显示所有已同步的路径 | diff --git a/docs/zh-CN/usage/multiple-files.md b/docs/zh-CN/usage/multiple-files.md index 821754e..1d88b8c 100644 --- a/docs/zh-CN/usage/multiple-files.md +++ b/docs/zh-CN/usage/multiple-files.md @@ -1 +1,32 @@ # 批量操作文件 + +termscp 允许你一次对多个文件执行操作。使用以下控制方式来构建选择。 + +- ``：将高亮的文件标记为已选择。 +- ``：选择当前目录中的所有文件。 +- ``：取消选择所有文件。 + +一旦某个文件被标记为已选择，它会以高亮背景显示。 + +当存在选择时，只有被选中的文件会被纳入操作处理；当前高亮的条目会被忽略。你也可以在查找结果面板中对多个文件进行操作。 + +## 对选择执行的操作 + +所有操作在处理多个文件时都可用，但其中一些行为略有不同。当存在选择时，你输入的名称指的是目标目录，而不是单个目标文件。 + +- **复制**：系统会提示你输入目标位置。当选中多个文件时，该名称是所有文件被复制到的目标目录。 +- **重命名**：与复制相同，但文件会被移动到目标目录。 +- **另存为**：与复制相同，但文件会被写入目标目录。 + +## 传输队列 + +如果你在某个目录（例如 `/home`）中选择了一个文件，然后切换目录，该文件仍会保持被选中状态，并显示在底部面板的**传输队列**中。 + +当某个文件被选中时，当时活动的远程目录会与其条目相关联。如果该文件随后被传输，它会被传输到与之关联的远程目录。 + +### 示例 + +假设你在远程面板位于 `/tmp` 时选择了本地文件 `/home/a.txt`，然后移动到 `/var`，在远程面板位于 `/home` 时选择了 `/var/b.txt`，最后执行传输。结果是： + +- `/home/a.txt` 被传输到 `/tmp/a.txt` +- `/var/b.txt` 被传输到 `/home/b.txt` diff --git a/docs/zh-CN/usage/open-edit-files.md b/docs/zh-CN/usage/open-edit-files.md index 0ee22a7..e61e638 100644 --- a/docs/zh-CN/usage/open-edit-files.md +++ b/docs/zh-CN/usage/open-edit-files.md @@ -1 +1,24 @@ # 打开与编辑文件 + +termscp 可以使用外部应用程序打开文件，并在你配置的编辑器中编辑文本文件。本地和远程文件均受支持。 + +## 打开与使用指定程序打开 + +按 `` 可使用系统针对该文件类型的默认应用程序打开文件。termscp 依赖于你操作系统的默认打开程序（由 [open](https://docs.rs/crate/open/1.7.0) crate 提供支持），因此请确保你的系统上至少具备以下之一。 + +- **Windows**：通过 `start` 命令自动处理。 +- **macOS**：通过 `open` 自动处理，该命令已预装。 +- **Linux**：必须安装 `xdg-open`、`gio`、`gnome-open` 或 `kde-open` 之一。 +- **WSL**：需要 `wslview`。请安装 [wslu](https://github.com/wslutilities/wslu)。 + +按 `` 可使用你指定的程序打开文件。 + +## 编辑文本文件 + +按 `` 可在你配置的文本编辑器中打开文件。仅支持文本文件，不支持二进制文件。 + +如果文件位于远程主机上，它会先被下载到你的临时文件目录，然后**仅在**你对其进行了更改时才会重新上传到远程主机。termscp 通过检查文件的最后修改时间来检测更改。 + +## 编辑远程文件 + +你无法直接从远程面板就地编辑远程文件。当你打开远程文件时，它会被下载到临时目录，但 termscp 无法创建监视器来检测你用于打开它的外部程序何时关闭，因此无法判断你何时完成编辑。要编辑远程文件，请先将其下载到本地目录，在本地编辑后再重新上传。 diff --git a/docs/zh-CN/usage/synced-browsing.md b/docs/zh-CN/usage/synced-browsing.md index bb5301c..ca57176 100644 --- a/docs/zh-CN/usage/synced-browsing.md +++ b/docs/zh-CN/usage/synced-browsing.md @@ -1 +1,5 @@ # 同步浏览 + +同步浏览会让两个浏览器面板之间的导航保持同步。启用后，每当你在一个面板中更改工作目录时，相同的更改会在另一个面板中重现。 + +要启用同步浏览，请按 ``。再次按 `` 即可禁用。启用后，状态栏会将同步浏览状态显示为 `ON`。