From fb6bdabadd2cbf7dedb8c6ccf9bfbb1986cda9cf Mon Sep 17 00:00:00 2001
From: Yorukot <hi@yorukot.me>
Date: Sat, 5 Jul 2025 00:33:52 +0800
Subject: [PATCH] spf: add page and Chinese translation (#17009)

Co-authored-by: Wiktor Perskawiec <git@spageektti.cc>
Co-authored-by: Managor <42655600+Managor@users.noreply.github.com>
Co-authored-by: Wiktor Perskawiec <wiktor@perskawiec.cc>
---
 pages.zh/common/spf.md    | 32 ++++++++++++++++++++++++++++++++
 pages.zh_TW/common/spf.md | 32 ++++++++++++++++++++++++++++++++
 pages/common/spf.md       | 32 ++++++++++++++++++++++++++++++++
 3 files changed, 96 insertions(+)
 create mode 100644 pages.zh/common/spf.md
 create mode 100644 pages.zh_TW/common/spf.md
 create mode 100644 pages/common/spf.md

diff --git a/pages.zh/common/spf.md b/pages.zh/common/spf.md
new file mode 100644
index 0000000000..367cbe8113
--- /dev/null
+++ b/pages.zh/common/spf.md
@@ -0,0 +1,32 @@
+# spf
+
+> superfile – 现代终端文件管理器。
+> 更多信息：<https://github.com/yorukot/superfile>.
+
+- 使用指定路径启动 `spf`：
+
+`spf {{path/to/directory}}`
+
+- 使用多个路径启动 `spf`：
+
+`spf {{path/to/directory1 path/to/directory2 ...}}`
+
+- 修复快捷键设置，补全缺失的按键：
+
+`spf {{[--fh|--fix-hotkeys]}}`
+
+- 修复配置文件，补全缺失的项：
+
+`spf {{[--fch|--fix-config-file]}}`
+
+- 使用指定的配置文件与快捷键文件：
+
+`spf {{[-c|--config-file]}} {{path/to/config.toml}} {{[--hf|--hotkey-file]}} {{path/to/hotkey.toml}}`
+
+- 将第一个选中的文件路径写入该文件并退出：
+
+`spf {{[--cf|--chooser-file]}} {{tmp/chooser-result}}`
+
+- 显示内部配置和数据目录路径：
+
+`spf {{[pl|path-list]}}`
diff --git a/pages.zh_TW/common/spf.md b/pages.zh_TW/common/spf.md
new file mode 100644
index 0000000000..c5baf07bdc
--- /dev/null
+++ b/pages.zh_TW/common/spf.md
@@ -0,0 +1,32 @@
+# spf
+
+> superfile – 現代的終端機檔案管理器。
+> 更多資訊：<https://github.com/yorukot/superfile>.
+
+- 使用指定路徑啟動 `spf`：
+
+`spf {{path/to/start}}`
+
+- 使用多個路徑啟動 `spf`：
+
+`spf {{path/to/directory1 /path/to/directory2 ...}}`
+
+- 修復快捷鍵設定，補上缺少的按鍵：
+
+`spf {{[--fh|--fix-hotkeys]}}`
+
+- 修復設定檔，補上缺少的項目：
+
+`spf {{[--fch|--fix-config-file]}}`
+
+- 使用指定的設定檔與快捷鍵檔案：
+
+`spf {{[-c|--config-file]}} {{path/to/config.toml}} {{[--hf|--hotkey-file]}} {{path/to/hotkey.toml}}`
+
+- 將第一個開啟的檔案路徑寫入該檔案並退出：
+
+`spf {{[--cf|--chooser-file]}} {{tmp/chooser-result}}`
+
+- 顯示內部設定與資料目錄路徑：
+
+`spf {{[pl|path-list]}}`
diff --git a/pages/common/spf.md b/pages/common/spf.md
new file mode 100644
index 0000000000..a7d9ce1379
--- /dev/null
+++ b/pages/common/spf.md
@@ -0,0 +1,32 @@
+# spf
+
+> The superfile – Modern terminal file manager.
+> More information: <https://github.com/yorukot/superfile>.
+
+- Launch `spf` with a specific path:
+
+`spf {{path/to/directory}}`
+
+- Launch `spf` with multiple paths:
+
+`spf {{path/to/directory1 path/to/directory2 ...}}`
+
+- Fix hotkey settings by appending missing keys:
+
+`spf {{[--fh|--fix-hotkeys]}}`
+
+- Fix the configuration file by appending missing entries:
+
+`spf {{[--fch|--fix-config-file]}}`
+
+- Use specific configuration and hotkey files:
+
+`spf {{[-c|--config-file]}} {{path/to/config.toml}} {{[--hf|--hotkey-file]}} {{path/to/hotkey.toml}}`
+
+- Write the path of the first selected file to this file and exit:
+
+`spf {{[--cf|--chooser-file]}} {{tmp/chooser-result}}`
+
+- Show internal configuration and data directory paths:
+
+`spf {{[pl|path-list]}}`