From be2ce64287db6bbb40f0fd43a41a8ef8fcf84d90 Mon Sep 17 00:00:00 2001 From: Yiming Zhang Date: Mon, 7 Jul 2025 20:20:58 +0800 Subject: [PATCH 1/5] Add documentation for stress testing --- content/docs/preferences/actions/_index.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/content/docs/preferences/actions/_index.md b/content/docs/preferences/actions/_index.md index dcd65c653..e1b6c4d34 100644 --- a/content/docs/preferences/actions/_index.md +++ b/content/docs/preferences/actions/_index.md @@ -128,3 +128,25 @@ If you switch to the correct tab when solving a problem, with this setting enabl Hide the time of the stopwatch and only show the time when the "Show" button is pressed. This may reduce distractions caused by stopwatch updates. + +## Stress Testing + +### Programming language for the generator template + +The programming language used for the generator template. + +### Path to the generator template file + +See [Template Path](../language/#template-path). + +### Template Cursor Position Regex + +See [Template Cursor Position](../language/#template-cursor-position). + +### Template Cursor Position Offset Type + +Whether the offset is relative to the start of the regex or the end of the regex. + +### Template Cursor Position Offset Characters + +The offset relative to the match of the regex in the number of characters, including white spaces. \ No newline at end of file From 16763c8a4bb291ca52b798bc30fb68f8325c738a Mon Sep 17 00:00:00 2001 From: Yiming Zhang Date: Mon, 7 Jul 2025 20:23:11 +0800 Subject: [PATCH 2/5] Format markdown --- content/docs/preferences/actions/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/preferences/actions/_index.md b/content/docs/preferences/actions/_index.md index e1b6c4d34..7125842aa 100644 --- a/content/docs/preferences/actions/_index.md +++ b/content/docs/preferences/actions/_index.md @@ -149,4 +149,4 @@ Whether the offset is relative to the start of the regex or the end of the regex ### Template Cursor Position Offset Characters -The offset relative to the match of the regex in the number of characters, including white spaces. \ No newline at end of file +The offset relative to the match of the regex in the number of characters, including white spaces. From 8a8ea0307a43151e6a41e3e2fbb6daab7109963d Mon Sep 17 00:00:00 2001 From: Yiming Zhang Date: Mon, 7 Jul 2025 21:51:58 +0800 Subject: [PATCH 3/5] Add chinese translation --- content/docs/preferences/actions/_index.md | 8 +++---- content/docs/preferences/actions/_index.zh.md | 22 +++++++++++++++++++ 2 files changed, 26 insertions(+), 4 deletions(-) diff --git a/content/docs/preferences/actions/_index.md b/content/docs/preferences/actions/_index.md index 7125842aa..b5b8bbdde 100644 --- a/content/docs/preferences/actions/_index.md +++ b/content/docs/preferences/actions/_index.md @@ -131,11 +131,11 @@ This may reduce distractions caused by stopwatch updates. ## Stress Testing -### Programming language for the generator template +### Programming language for the template The programming language used for the generator template. -### Path to the generator template file +### Path to the template file See [Template Path](../language/#template-path). @@ -145,8 +145,8 @@ See [Template Cursor Position](../language/#template-cursor-position). ### Template Cursor Position Offset Type -Whether the offset is relative to the start of the regex or the end of the regex. +See [Template Cursor Position](../language/#template-cursor-position). ### Template Cursor Position Offset Characters -The offset relative to the match of the regex in the number of characters, including white spaces. +See [Template Cursor Position](../language/#template-cursor-position). diff --git a/content/docs/preferences/actions/_index.zh.md b/content/docs/preferences/actions/_index.zh.md index 6f502b8eb..a23adfa33 100644 --- a/content/docs/preferences/actions/_index.zh.md +++ b/content/docs/preferences/actions/_index.zh.md @@ -126,3 +126,25 @@ weight: 40 隐藏计时结果，只在“显示”按钮按下时显示。 这或许可以避免计时结果更新使人分心。 + +## 对拍 + +### 模版使用的编程语言 + +数据生成器模版使用的编程语言 + +### 模板路径 + +参见 [模板路径](../language/#template-path)。 + +### 使用模板时光标初始位置定位使用的正则表达式 + +参见 [使用模板时的光标初始位置](../language/#使用模板时的光标初始位置)。 + +### 使用模板时光标初始位置的偏移类型 + +参见 [使用模板时的光标初始位置](../language/#使用模板时的光标初始位置)。 + +### 使用模板时光标初始位置的偏移字符量 + +参见 [使用模板时的光标初始位置](../language/#使用模板时的光标初始位置)。 From dec74697044dbd825523a36c19ef83cd252c243c Mon Sep 17 00:00:00 2001 From: Ashar Date: Sun, 5 Apr 2026 18:29:01 +0530 Subject: [PATCH 4/5] docs: update build-from-source instructions for ECM/KSH submodule removal extra-cmake-modules and syntax-highlighting are no longer bundled as submodules starting from v7.1. Users must install them from package managers or clone and build them manually. --- .../installation/build-from-source/_index.md | 15 ++++++++----- .../build-from-source/_index.ru.md | 22 ++++++++++++++++++- .../build-from-source/_index.zh.md | 15 ++++++++----- .../build-from-source/_index.zh_tw.md | 22 ++++++++++++++++++- 4 files changed, 62 insertions(+), 12 deletions(-) diff --git a/content/docs/installation/build-from-source/_index.md b/content/docs/installation/build-from-source/_index.md index ca282213c..7148bea47 100644 --- a/content/docs/installation/build-from-source/_index.md +++ b/content/docs/installation/build-from-source/_index.md @@ -24,19 +24,24 @@ description: In this way, you can get the latest unreleased features and get rea 3. If CMake can't find the Qt installation path, you should set the environment variable: `CMAKE_PREFIX_PATH=%QtPath%/%QtVersion%/%Compiler%/lib/cmake`. For example, on macOS, you can run something like `export CMAKE_PREFIX_PATH="/usr/local/Cellar/qt/5.15.2"`. -4. Install KDE (kf5) Syntax Highlighting. +4. Install [Extra CMake Modules](https://github.com/KDE/extra-cmake-modules) and [KDE (kf5) Syntax Highlighting](https://github.com/KDE/syntax-highlighting). These are **not** bundled as submodules and must be installed on the host system before building. - On some Linux distributions and macOS, you can install from your package manager. For example, `sudo pacman -S syntax-highlighting5` on Arch Linux, [Homebrew KDE](https://github.com/KDE/homebrew-kde) and then `brew install kde-mac/kde/kf5-syntax-highlighting` on macOS. - - Otherwise, you can use CMake to build and install Extra CMake Modules first and then KSH: + - Otherwise, you can clone and build them manually: ```sh - cd third_party/extra-cmake-modules + git clone --branch kf5 https://github.com/KDE/extra-cmake-modules.git + cd extra-cmake-modules cmake -B build -S . -DBUILD_HTML_DOCS=OFF -DBUILD_MAN_DOCS=OFF -DBUILD_QTHELP_DOCS=OFF -DBUILD_TESTING=OFF cmake --build build --config Release --target install # may require sudo - cd ../syntax-highlighting + cd .. + + git clone --branch kf5 https://github.com/KDE/syntax-highlighting.git + cd syntax-highlighting cmake -B build -S . -DBUILD_HTML_DOCS=OFF -DBUILD_MAN_DOCS=OFF -DBUILD_QTHELP_DOCS=OFF -DBUILD_TESTING=OFF - cmake --build build --config Release --target install + cmake --build build --config Release --target install # may require sudo + cd .. ``` ### Build diff --git a/content/docs/installation/build-from-source/_index.ru.md b/content/docs/installation/build-from-source/_index.ru.md index 4af61e97c..1439f5d00 100644 --- a/content/docs/installation/build-from-source/_index.ru.md +++ b/content/docs/installation/build-from-source/_index.ru.md @@ -18,7 +18,27 @@ description: In this way, you can get the latest unreleased features and get rea 3. If CMake can't find the Qt installation path, you should set the environment variable: `CMAKE_PREFIX_PATH=%QtPath%/%QtVersion%/%Compiler%/lib/cmake`. For example, on macOS, you can run something like `export CMAKE_PREFIX_PATH="/usr/local/Cellar/qt/5.15.1"`. -4. Run the following commands: +4. Install [Extra CMake Modules](https://github.com/KDE/extra-cmake-modules) and [KDE (kf5) Syntax Highlighting](https://github.com/KDE/syntax-highlighting). These are **not** bundled as submodules and must be installed on the host system before building. + + - On some Linux distributions and macOS, you can install from your package manager. For example, `sudo pacman -S syntax-highlighting5` on Arch Linux, [Homebrew KDE](https://github.com/KDE/homebrew-kde) and then `brew install kde-mac/kde/kf5-syntax-highlighting` on macOS. + + - Otherwise, you can clone and build them manually: + + ```sh + git clone --branch kf5 https://github.com/KDE/extra-cmake-modules.git + cd extra-cmake-modules + cmake -B build -S . -DBUILD_HTML_DOCS=OFF -DBUILD_MAN_DOCS=OFF -DBUILD_QTHELP_DOCS=OFF -DBUILD_TESTING=OFF + cmake --build build --config Release --target install # may require sudo + cd .. + + git clone --branch kf5 https://github.com/KDE/syntax-highlighting.git + cd syntax-highlighting + cmake -B build -S . -DBUILD_HTML_DOCS=OFF -DBUILD_MAN_DOCS=OFF -DBUILD_QTHELP_DOCS=OFF -DBUILD_TESTING=OFF + cmake --build build --config Release --target install # may require sudo + cd .. + ``` + +5. Run the following commands: - Linux/macOS: diff --git a/content/docs/installation/build-from-source/_index.zh.md b/content/docs/installation/build-from-source/_index.zh.md index dfe173de1..20bade628 100644 --- a/content/docs/installation/build-from-source/_index.zh.md +++ b/content/docs/installation/build-from-source/_index.zh.md @@ -23,19 +23,24 @@ description: 通过这种方式，你可以使用最新的还未发布的特性 3. 如果 CMake 提示找不到 Qt 路径，你应该设置环境变量：`CMAKE_PREFIX_PATH=%QtPath%/%QtVersion%/%Compiler%/lib/cmake`。例如，在 macOS 上，你可以运行 `export CMAKE_PREFIX_PATH="/usr/local/Cellar/qt/5.15.2"`。 -4. 安装 KDE (kf5) Extra CMake Modules。 +4. 安装 [Extra CMake Modules](https://github.com/KDE/extra-cmake-modules) 和 [KDE (kf5) Syntax Highlighting](https://github.com/KDE/syntax-highlighting)。它们**不再**作为子模块捆绑，必须在构建前安装到系统中。 - 在一些 Linux 发行版和 macOS 系统上，你可以直接使用包管理器安装它们。例如，在 Arch Linux 上可以使用 `sudo pacman -S syntax-highlighting5`，在 macOS 上可以使用 [Homebrew KDE](https://github.com/KDE/homebrew-kde) 然后 `brew install kde-mac/kde/kf5-syntax-highlighting`。 - - 否则，你需要使用 CMake 先构建并安装 Extra CMake Modules 然后再是 KSH： + - 否则，你需要手动克隆并构建安装： ```sh - cd third_party/extra-cmake-modules + git clone --branch kf5 https://github.com/KDE/extra-cmake-modules.git + cd extra-cmake-modules cmake -B build -S . -DBUILD_HTML_DOCS=OFF -DBUILD_MAN_DOCS=OFF -DBUILD_QTHELP_DOCS=OFF -DBUILD_TESTING=OFF cmake --build build --config Release --target install # 可能需要 sudo - cd ../syntax-highlighting + cd .. + + git clone --branch kf5 https://github.com/KDE/syntax-highlighting.git + cd syntax-highlighting cmake -B build -S . -DBUILD_HTML_DOCS=OFF -DBUILD_MAN_DOCS=OFF -DBUILD_QTHELP_DOCS=OFF -DBUILD_TESTING=OFF - cmake --build build --config Release --target install + cmake --build build --config Release --target install # 可能需要 sudo + cd .. ``` ### 构建 diff --git a/content/docs/installation/build-from-source/_index.zh_tw.md b/content/docs/installation/build-from-source/_index.zh_tw.md index 3f0429365..0ebce6875 100644 --- a/content/docs/installation/build-from-source/_index.zh_tw.md +++ b/content/docs/installation/build-from-source/_index.zh_tw.md @@ -18,7 +18,27 @@ description: 此方式適合想要嘗鮮最新功能的使用者、協助進行 3. 若 CMake 找不到 Qt 的安裝路徑，需要設定環境變數：`CMAKE_PREFIX_PATH=%QtPath%/%QtVersion%/%Compiler%/lib/cmake`。以 macOS 而言，執行這個命令 `export CMAKE_PREFIX_PATH="/usr/local/Cellar/qt/5.15.1"`。 -4. 執行下列命令。 +4. 安裝 [Extra CMake Modules](https://github.com/KDE/extra-cmake-modules) 和 [KDE (kf5) Syntax Highlighting](https://github.com/KDE/syntax-highlighting)。它們**不再**作為子模組捆綁，必須在建置前安裝到系統中。 + + - 在 macOS 及某些 Linux 發行版，您可以透過套件管理系統來安裝。例如在 Arch Linux 上使用 `sudo pacman -S syntax-highlighting5`，在 macOS 上使用 [Homebrew KDE](https://github.com/KDE/homebrew-kde) 然後 `brew install kde-mac/kde/kf5-syntax-highlighting`。 + + - 否則，您需要手動 clone 並建置安裝： + + ```sh + git clone --branch kf5 https://github.com/KDE/extra-cmake-modules.git + cd extra-cmake-modules + cmake -B build -S . -DBUILD_HTML_DOCS=OFF -DBUILD_MAN_DOCS=OFF -DBUILD_QTHELP_DOCS=OFF -DBUILD_TESTING=OFF + cmake --build build --config Release --target install # 可能需要 sudo + cd .. + + git clone --branch kf5 https://github.com/KDE/syntax-highlighting.git + cd syntax-highlighting + cmake -B build -S . -DBUILD_HTML_DOCS=OFF -DBUILD_MAN_DOCS=OFF -DBUILD_QTHELP_DOCS=OFF -DBUILD_TESTING=OFF + cmake --build build --config Release --target install # 可能需要 sudo + cd .. + ``` + +5. 執行下列命令。 - Linux/macOS: From 0bae5f7228d1193788943893f006c454bbd266ed Mon Sep 17 00:00:00 2001 From: Ashar Date: Sun, 5 Apr 2026 18:31:22 +0530 Subject: [PATCH 5/5] fix: correct anchor link for template-path in Chinese stress testing docs --- content/docs/preferences/actions/_index.zh.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/preferences/actions/_index.zh.md b/content/docs/preferences/actions/_index.zh.md index a23adfa33..5fc68c874 100644 --- a/content/docs/preferences/actions/_index.zh.md +++ b/content/docs/preferences/actions/_index.zh.md @@ -135,7 +135,7 @@ weight: 40 ### 模板路径 -参见 [模板路径](../language/#template-path)。 +参见 [模板路径](../language/#模板路径)。 ### 使用模板时光标初始位置定位使用的正则表达式