From 9b33e8c777ac10dde9dea1c41afed13b938859ad Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sat, 28 Jun 2025 23:41:18 +0800 Subject: [PATCH 01/18] spf: add page --- 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..0ee2516958 --- /dev/null +++ b/pages.zh/common/spf.md @@ -0,0 +1,32 @@ +# spf + +> superfile – 现代终端文件管理器。 +> 更多信息：. + +- 使用指定路径启动 `spf`： + +`spf {{/path/to/start}}` + +- 使用多个路径启动 `spf`： + +`spf {{/path/to/start1}} {{/path/to/start2}}` + +- 修复快捷键设置，补全缺失的按键： + +`spf --fix-hotkeys` + +- 修复配置文件，补全缺失的项： + +`spf --fix-config-file` + +- 使用指定的配置文件与快捷键文件： + +`spf --config-file {{path/to/config.toml}} --hotkey-file {{path/to/hotkey.toml}}` + +- 设置选择器文件：将打开的路径写入该文件并退出： + +`spf --chooser-file {{/tmp/chooser-result}}` + +- 显示内部配置和数据目录路径： + +`spf path-list` diff --git a/pages.zh_TW/common/spf.md b/pages.zh_TW/common/spf.md new file mode 100644 index 0000000000..78e8d4646d --- /dev/null +++ b/pages.zh_TW/common/spf.md @@ -0,0 +1,32 @@ +# spf + +> superfile – 現代的終端機檔案管理器。 +> 更多資訊：. + +- 使用指定路徑啟動 `spf`： + +`spf {{/path/to/start}}` + +- 使用多個路徑啟動 `spf`： + +`spf {{/path/to/start1}} {{/path/to/start2}}` + +- 修復快捷鍵設定，補上缺少的按鍵： + +`spf --fix-hotkeys` + +- 修復設定檔，補上缺少的項目： + +`spf --fix-config-file` + +- 使用指定的設定檔與快捷鍵檔案： + +`spf --config-file {{path/to/config.toml}} --hotkey-file {{path/to/hotkey.toml}}` + +- 設定選擇器檔案：將開啟的路徑寫入該檔案並退出： + +`spf --chooser-file {{/tmp/chooser-result}}` + +- 顯示內部設定與資料目錄路徑： + +`spf path-list` diff --git a/pages/common/spf.md b/pages/common/spf.md new file mode 100644 index 0000000000..4872fab094 --- /dev/null +++ b/pages/common/spf.md @@ -0,0 +1,32 @@ +# spf + +> The superfile – Modern terminal file manager. +> More information: . + +- Launch `spf` with a specific path: + +`spf {{/path/to/start}}` + +- Launch `spf` with multiple paths: + +`spf {{/path/to/start1}} {{/path/to/start2}}` + +- Fix hotkey settings by appending missing keys: + +`spf --fix-hotkeys` + +- Fix the configuration file by appending missing entries: + +`spf --fix-config-file` + +- Use specific configuration and hotkey files: + +`spf --config-file {{path/to/config.toml}} --hotkey-file {{path/to/hotkey.toml}}` + +- Set a chooser file: write the opened path to this file and exit: + +`spf --chooser-file {{/tmp/chooser-result}}` + +- Show internal configuration and data directory paths: + +`spf path-list` From d1e58c6c762dac5b4ec2b41dd509e5b81921ae63 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sun, 29 Jun 2025 07:20:00 +0800 Subject: [PATCH 02/18] Update pages/common/spf.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/common/spf.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/common/spf.md b/pages/common/spf.md index 4872fab094..334b1c608d 100644 --- a/pages/common/spf.md +++ b/pages/common/spf.md @@ -13,7 +13,7 @@ - Fix hotkey settings by appending missing keys: -`spf --fix-hotkeys` +`spf {{[-fh|--fix-hotkeys]}}` - Fix the configuration file by appending missing entries: From df6013d7e18170123ab1965ee5ca1db909e7e6a4 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sun, 29 Jun 2025 07:20:08 +0800 Subject: [PATCH 03/18] Update pages/common/spf.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/common/spf.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/common/spf.md b/pages/common/spf.md index 334b1c608d..597e7acdd6 100644 --- a/pages/common/spf.md +++ b/pages/common/spf.md @@ -25,7 +25,7 @@ - Set a chooser file: write the opened path to this file and exit: -`spf --chooser-file {{/tmp/chooser-result}}` +`spf {{[--cf|--chooser-file]}} {{/tmp/chooser-result}}` - Show internal configuration and data directory paths: From 0460514ace045d644edeaa04358345bad33feeef Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sun, 29 Jun 2025 07:20:15 +0800 Subject: [PATCH 04/18] Update pages/common/spf.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/common/spf.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/common/spf.md b/pages/common/spf.md index 597e7acdd6..e4516c32d9 100644 --- a/pages/common/spf.md +++ b/pages/common/spf.md @@ -29,4 +29,4 @@ - Show internal configuration and data directory paths: -`spf path-list` +`spf {{[pl|path-list]}}` From 8361e80e6e7288bdfbc26d4e4c932416bf87d743 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sun, 29 Jun 2025 07:20:30 +0800 Subject: [PATCH 05/18] Update pages/common/spf.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/common/spf.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/common/spf.md b/pages/common/spf.md index e4516c32d9..7b91308b74 100644 --- a/pages/common/spf.md +++ b/pages/common/spf.md @@ -21,7 +21,7 @@ - Use specific configuration and hotkey files: -`spf --config-file {{path/to/config.toml}} --hotkey-file {{path/to/hotkey.toml}}` +`spf {{[-c|--config-file]}} {{path/to/config.toml}} {{[--hf|--hotkey-file]}} {{path/to/hotkey.toml}}` - Set a chooser file: write the opened path to this file and exit: From 0629dbd6766564f5c83ea1ccebc268ef5c94c2c4 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sun, 29 Jun 2025 07:20:37 +0800 Subject: [PATCH 06/18] Update pages/common/spf.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/common/spf.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/common/spf.md b/pages/common/spf.md index 7b91308b74..782814b09d 100644 --- a/pages/common/spf.md +++ b/pages/common/spf.md @@ -17,7 +17,7 @@ - Fix the configuration file by appending missing entries: -`spf --fix-config-file` +`spf {{[--fch|--fix-config-file]}}` - Use specific configuration and hotkey files: From b449299e601a931d407b4f372cd868fd302b1d33 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sun, 29 Jun 2025 07:22:26 +0800 Subject: [PATCH 07/18] Update pages/common/spf.md Co-authored-by: Wiktor Perskawiec --- pages/common/spf.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/common/spf.md b/pages/common/spf.md index 782814b09d..436bd68939 100644 --- a/pages/common/spf.md +++ b/pages/common/spf.md @@ -23,7 +23,7 @@ `spf {{[-c|--config-file]}} {{path/to/config.toml}} {{[--hf|--hotkey-file]}} {{path/to/hotkey.toml}}` -- Set a chooser file: write the opened path to this file and exit: +- Set a chooser file; write the opened path to this file and exit: `spf {{[--cf|--chooser-file]}} {{/tmp/chooser-result}}` From 3e90905724c107c2919ebec6fa889953b81b15bb Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sun, 29 Jun 2025 07:25:01 +0800 Subject: [PATCH 08/18] spf: update example command with short option --- pages.zh/common/spf.md | 10 +++++----- pages.zh_TW/common/spf.md | 10 +++++----- pages/common/spf.md | 2 +- 3 files changed, 11 insertions(+), 11 deletions(-) diff --git a/pages.zh/common/spf.md b/pages.zh/common/spf.md index 0ee2516958..7311913f68 100644 --- a/pages.zh/common/spf.md +++ b/pages.zh/common/spf.md @@ -13,20 +13,20 @@ - 修复快捷键设置，补全缺失的按键： -`spf --fix-hotkeys` +`spf {{[--fh|--fix-hotkeys]}}` - 修复配置文件，补全缺失的项： -`spf --fix-config-file` +`spf {{[--fch|--fix-config-file]}}` - 使用指定的配置文件与快捷键文件： -`spf --config-file {{path/to/config.toml}} --hotkey-file {{path/to/hotkey.toml}}` +`spf {{[-c|--config-file]}} {{path/to/config.toml}} {{[--hf|--hotkey-file]}} {{path/to/hotkey.toml}}` - 设置选择器文件：将打开的路径写入该文件并退出： -`spf --chooser-file {{/tmp/chooser-result}}` +`spf {{[--cf|--chooser-file]}} {{/tmp/chooser-result}}` - 显示内部配置和数据目录路径： -`spf path-list` +`spf {{[pl|path-list]}}` diff --git a/pages.zh_TW/common/spf.md b/pages.zh_TW/common/spf.md index 78e8d4646d..f02b1da022 100644 --- a/pages.zh_TW/common/spf.md +++ b/pages.zh_TW/common/spf.md @@ -13,20 +13,20 @@ - 修復快捷鍵設定，補上缺少的按鍵： -`spf --fix-hotkeys` +`spf {{[--fh|--fix-hotkeys]}}` - 修復設定檔，補上缺少的項目： -`spf --fix-config-file` +`spf {{[--fch|--fix-config-file]}}` - 使用指定的設定檔與快捷鍵檔案： -`spf --config-file {{path/to/config.toml}} --hotkey-file {{path/to/hotkey.toml}}` +`spf {{[-c|--config-file]}} {{path/to/config.toml}} {{[--hf|--hotkey-file]}} {{path/to/hotkey.toml}}` - 設定選擇器檔案：將開啟的路徑寫入該檔案並退出： -`spf --chooser-file {{/tmp/chooser-result}}` +`spf {{[--cf|--chooser-file]}} {{/tmp/chooser-result}}` - 顯示內部設定與資料目錄路徑： -`spf path-list` +`spf {{[pl|path-list]}}` diff --git a/pages/common/spf.md b/pages/common/spf.md index 436bd68939..5c27f21517 100644 --- a/pages/common/spf.md +++ b/pages/common/spf.md @@ -13,7 +13,7 @@ - Fix hotkey settings by appending missing keys: -`spf {{[-fh|--fix-hotkeys]}}` +`spf {{[--fh|--fix-hotkeys]}}` - Fix the configuration file by appending missing entries: From f0689306be7863fef317269e2e0365f7e1374f28 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sun, 29 Jun 2025 07:42:09 +0800 Subject: [PATCH 09/18] spf: update chooser file description --- pages.zh/common/spf.md | 2 +- pages.zh_TW/common/spf.md | 2 +- pages/common/spf.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/pages.zh/common/spf.md b/pages.zh/common/spf.md index 7311913f68..d3c2bcf3c3 100644 --- a/pages.zh/common/spf.md +++ b/pages.zh/common/spf.md @@ -23,7 +23,7 @@ `spf {{[-c|--config-file]}} {{path/to/config.toml}} {{[--hf|--hotkey-file]}} {{path/to/hotkey.toml}}` -- 设置选择器文件：将打开的路径写入该文件并退出： +- 将第一个选中的文件路径写入该文件并退出： `spf {{[--cf|--chooser-file]}} {{/tmp/chooser-result}}` diff --git a/pages.zh_TW/common/spf.md b/pages.zh_TW/common/spf.md index f02b1da022..161fd8838f 100644 --- a/pages.zh_TW/common/spf.md +++ b/pages.zh_TW/common/spf.md @@ -23,7 +23,7 @@ `spf {{[-c|--config-file]}} {{path/to/config.toml}} {{[--hf|--hotkey-file]}} {{path/to/hotkey.toml}}` -- 設定選擇器檔案：將開啟的路徑寫入該檔案並退出： +- 將第一個開啟的檔案路徑寫入該檔案並退出： `spf {{[--cf|--chooser-file]}} {{/tmp/chooser-result}}` diff --git a/pages/common/spf.md b/pages/common/spf.md index 5c27f21517..a45096b68c 100644 --- a/pages/common/spf.md +++ b/pages/common/spf.md @@ -23,7 +23,7 @@ `spf {{[-c|--config-file]}} {{path/to/config.toml}} {{[--hf|--hotkey-file]}} {{path/to/hotkey.toml}}` -- Set a chooser file; write the opened path to this file and exit: +- Write the path of the first selected file to this file and exit: `spf {{[--cf|--chooser-file]}} {{/tmp/chooser-result}}` From 3f47a3368ef90ca8b0a1ce44c9abd17776241a6b Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sun, 29 Jun 2025 20:31:48 +0800 Subject: [PATCH 10/18] Update pages/common/spf.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/common/spf.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/common/spf.md b/pages/common/spf.md index a45096b68c..3ab83023df 100644 --- a/pages/common/spf.md +++ b/pages/common/spf.md @@ -9,7 +9,7 @@ - Launch `spf` with multiple paths: -`spf {{/path/to/start1}} {{/path/to/start2}}` +`spf {{path/to/directory1 path/to/directory2 ...}}` - Fix hotkey settings by appending missing keys: From 8ba66d905b7f6c6ec863b968c6010f8f12c8c9b2 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sun, 29 Jun 2025 20:31:58 +0800 Subject: [PATCH 11/18] Update pages/common/spf.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/common/spf.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/common/spf.md b/pages/common/spf.md index 3ab83023df..a2f2d82909 100644 --- a/pages/common/spf.md +++ b/pages/common/spf.md @@ -25,7 +25,7 @@ - Write the path of the first selected file to this file and exit: -`spf {{[--cf|--chooser-file]}} {{/tmp/chooser-result}}` +`spf {{[--cf|--chooser-file]}} {{tmp/chooser-result}}` - Show internal configuration and data directory paths: From 3241b1569b0bf55f3d880f85c20dccf79f90d6fa Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sun, 29 Jun 2025 20:32:06 +0800 Subject: [PATCH 12/18] Update pages/common/spf.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages/common/spf.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages/common/spf.md b/pages/common/spf.md index a2f2d82909..a7d9ce1379 100644 --- a/pages/common/spf.md +++ b/pages/common/spf.md @@ -5,7 +5,7 @@ - Launch `spf` with a specific path: -`spf {{/path/to/start}}` +`spf {{path/to/directory}}` - Launch `spf` with multiple paths: From e2605356732374c45e33071c856804a4a8bc73e6 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sun, 29 Jun 2025 20:32:15 +0800 Subject: [PATCH 13/18] Update pages.zh_TW/common/spf.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages.zh_TW/common/spf.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages.zh_TW/common/spf.md b/pages.zh_TW/common/spf.md index 161fd8838f..618ba359ef 100644 --- a/pages.zh_TW/common/spf.md +++ b/pages.zh_TW/common/spf.md @@ -25,7 +25,7 @@ - 將第一個開啟的檔案路徑寫入該檔案並退出： -`spf {{[--cf|--chooser-file]}} {{/tmp/chooser-result}}` +`spf {{[--cf|--chooser-file]}} {{tmp/chooser-result}}` - 顯示內部設定與資料目錄路徑： From 4e2584f75eb2129f617adde6c2e189e2a7208a18 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sun, 29 Jun 2025 20:32:23 +0800 Subject: [PATCH 14/18] Update pages.zh_TW/common/spf.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages.zh_TW/common/spf.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages.zh_TW/common/spf.md b/pages.zh_TW/common/spf.md index 618ba359ef..52f558a8fd 100644 --- a/pages.zh_TW/common/spf.md +++ b/pages.zh_TW/common/spf.md @@ -9,7 +9,7 @@ - 使用多個路徑啟動 `spf`： -`spf {{/path/to/start1}} {{/path/to/start2}}` +`spf {{path/to/directory1 /path/to/directory2 ...}}` - 修復快捷鍵設定，補上缺少的按鍵： From f0b17314bde6c1769a1955a1842788250d42dab7 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sun, 29 Jun 2025 20:32:31 +0800 Subject: [PATCH 15/18] Update pages.zh/common/spf.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages.zh/common/spf.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages.zh/common/spf.md b/pages.zh/common/spf.md index d3c2bcf3c3..a4efd46e52 100644 --- a/pages.zh/common/spf.md +++ b/pages.zh/common/spf.md @@ -5,7 +5,7 @@ - 使用指定路径启动 `spf`： -`spf {{/path/to/start}}` +`spf {{path/to/directory}}` - 使用多个路径启动 `spf`： From 22143655695d333259d3e4562d12c9ca9cba6179 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sun, 29 Jun 2025 20:32:40 +0800 Subject: [PATCH 16/18] Update pages.zh/common/spf.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages.zh/common/spf.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages.zh/common/spf.md b/pages.zh/common/spf.md index a4efd46e52..40aec6429f 100644 --- a/pages.zh/common/spf.md +++ b/pages.zh/common/spf.md @@ -9,7 +9,7 @@ - 使用多个路径启动 `spf`： -`spf {{/path/to/start1}} {{/path/to/start2}}` +`spf {{path/to/directory1 path/to/directory2 ...}}` - 修复快捷键设置，补全缺失的按键： From e35793a0f4bd9e42fdf344ac08c9cc8ed3ea0f0e Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sun, 29 Jun 2025 20:32:47 +0800 Subject: [PATCH 17/18] Update pages.zh/common/spf.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages.zh/common/spf.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages.zh/common/spf.md b/pages.zh/common/spf.md index 40aec6429f..367cbe8113 100644 --- a/pages.zh/common/spf.md +++ b/pages.zh/common/spf.md @@ -25,7 +25,7 @@ - 将第一个选中的文件路径写入该文件并退出： -`spf {{[--cf|--chooser-file]}} {{/tmp/chooser-result}}` +`spf {{[--cf|--chooser-file]}} {{tmp/chooser-result}}` - 显示内部配置和数据目录路径： From 74c15e032583574b1f802840c7e19af6e6804876 Mon Sep 17 00:00:00 2001 From: Yorukot Date: Sun, 29 Jun 2025 20:32:57 +0800 Subject: [PATCH 18/18] Update pages.zh_TW/common/spf.md Co-authored-by: Managor <42655600+Managor@users.noreply.github.com> --- pages.zh_TW/common/spf.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pages.zh_TW/common/spf.md b/pages.zh_TW/common/spf.md index 52f558a8fd..c5baf07bdc 100644 --- a/pages.zh_TW/common/spf.md +++ b/pages.zh_TW/common/spf.md @@ -5,7 +5,7 @@ - 使用指定路徑啟動 `spf`： -`spf {{/path/to/start}}` +`spf {{path/to/start}}` - 使用多個路徑啟動 `spf`：