Merge pull request #2709 from xiaoyifang/release/26.3.0

schedule a Release/26.3.0

Author: xiaoyifang

.github/workflows/Release-all.yml

@@ -5,7 +5,6 @@ concurrency:
    group: ${{ github.workflow }}-${{ github.ref }}
    cancel-in-progress: true
 env:
-  version: 26.1.1
   prerelease: ${{ !contains(github.ref_name,'master') }}
   versionSuffix: ${{ !contains(github.ref_name,'master') && 'alpha' || 'Release' }}
 on:
@@ -153,6 +152,8 @@ jobs:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0 # need all tags to genearte changelog
+      - name: Load version from VERSION file
+        run: echo "version=$(xargs < VERSION)" >> $GITHUB_ENV
       - name: Get git short SHA
         id: shortSHA
         run: |

CMakeLists.txt

@@ -38,8 +38,10 @@ endif ()
 
 include(FeatureSummary)
 
+file(READ "VERSION" PROJECT_VERSION_ST)
+string(STRIP "${PROJECT_VERSION_ST}" PROJECT_VERSION_ST)
 project(goldendict-ng
-        VERSION 26.1.1
+        VERSION ${PROJECT_VERSION_ST}
         LANGUAGES CXX C)
 
 if (APPLE)
@@ -67,7 +69,7 @@ if (WITH_TTS)
     list(APPEND GD_QT_COMPONENTS TextToSpeech)
 endif ()
 
-find_package(Qt6 REQUIRED COMPONENTS ${GD_QT_COMPONENTS})
+find_package(Qt6 6.2 REQUIRED COMPONENTS ${GD_QT_COMPONENTS})
 
 qt_standard_project_setup()
 set(CMAKE_AUTORCC ON) # not included in the qt_standard_project_setup

VERSION

@@ -0,0 +1 @@
+26.3.0

cmake/Deps_Linux.cmake

@@ -1,7 +1,6 @@
 find_package(PkgConfig REQUIRED)
 
 set(Optional_Pkgs "")
-list(APPEND Optional_Pkgs "fmt")
 if (USE_SYSTEM_TOML)
     list(APPEND Optional_Pkgs "tomlplusplus")
 endif ()
@@ -31,7 +30,8 @@ pkg_check_modules(DEPS REQUIRED IMPORTED_TARGET
 
 
 find_package(BZip2 REQUIRED) # FreeBSD misses .pc file https://www.freshports.org/archivers/bzip2
-target_link_libraries(${GOLDENDICT} PRIVATE PkgConfig::DEPS BZip2::BZip2)
+find_package(fmt REQUIRED)
+target_link_libraries(${GOLDENDICT} PRIVATE PkgConfig::DEPS BZip2::BZip2 fmt::fmt)
 
 # On FreeBSD, there are two iconv, libc iconv & GNU libiconv.
 # The system one is good enough, the following is a workaround to use libc iconv on freeBSD.

cmake/Deps_macOS.cmake

@@ -7,7 +7,6 @@ target_link_libraries(${GOLDENDICT} PRIVATE ${CARBON_LIBRARY})
 find_package(PkgConfig REQUIRED)
 
 set(Optional_Pkgs "")
-list(APPEND Optional_Pkgs "fmt")
 if (USE_SYSTEM_TOML)
     list(APPEND Optional_Pkgs "tomlplusplus")
 endif ()
@@ -51,7 +50,8 @@ pkg_check_modules(DEPS REQUIRED IMPORTED_TARGET
 
 find_package(Iconv REQUIRED)
 find_package(BZip2 REQUIRED)
-target_link_libraries(${GOLDENDICT} PRIVATE PkgConfig::DEPS BZip2::BZip2 Iconv::Iconv)
+find_package(fmt REQUIRED)
+target_link_libraries(${GOLDENDICT} PRIVATE PkgConfig::DEPS BZip2::BZip2 Iconv::Iconv fmt::fmt)
 
 if (WITH_EPWING_SUPPORT)
     find_library(EB_LIBRARY eb REQUIRED)

docs/startup_optimization.md

@@ -0,0 +1,37 @@
+# GoldenDict-ng Startup Performance Optimization Record
+
+## 1. Optimization Goal
+Reduce interface stuttering during cold start, shorten the perceived time from clicking to displaying the main window, and lower the CPU and disk I/O peaks during the startup phase.
+
+## 2. Core Strategy: Deferred Loading & Staged Startup
+Decouple non-critical tasks from the `MainWindow` constructor and synchronous initialization flow. Utilize `QTimer::singleShot` to trigger these tasks in stages after the main event loop starts, achieving a "progressive startup."
+
+## 3. Optimization Item List
+
+| Task Item | Original Timing | Optimized Timing | Remarks |
+| :--- | :--- | :--- | :--- |
+| **ArticleInspector (Debugger)** | Sync creation in constructor | **Lazy creation** | Instantiated only when "Inspect Element" is triggered |
+| **ScanPopup (Scan Progress)** | Sync trigger in constructor | **Delayed 1,000ms** | Avoids QWebEngine loading blocking main window display |
+| **TrayIcon** | Sync init in constructor | **Delayed 1,000ms** | Reduces synchronous communication with system shell |
+| **GlobalHotkeys** | Sync installation in constructor | **Delayed 2,000ms** | Moves system-level hotkey registration to background |
+| **doDeferredInit (Deep Init)** | Sync execution at end of constructor | **Delayed 3,000ms** | Avoids peak I/O for file handles and abbreviation loading |
+| **FullTextSearch (FTS Indexing)** | Sync start in `makeDictionaries` | **Delayed 5,000ms** | Ensures UI is idle before starting large-scale disk scanning |
+| **New Release Check** | Immediate execution (0ms) | **Delayed 10,000ms** | Moves network requests and JSON parsing after stability |
+
+## 4. Technical Details
+
+### 4.1 Automatic Fallback Mechanism (`ensureInitDone`)
+For the `doDeferredInit` delay, existing dictionary class implementations (e.g., `DslDictionary`, `MdxDictionary`) already include `ensureInitDone()` protection logic.
+- **Safety**: If a user performs a lookup or FTS search before the delay (3s) expires, the code will automatically trigger synchronous initialization, ensuring no loss of functionality.
+- **Experience**: The delay is only to release system resources and does not cause functional deadlocks.
+
+### 4.2 UI Responsiveness Priority
+By delaying `ScanPopup` and `ArticleInspector` (both WebEngine-driven), we significantly reduce the peak frequency of VRAM and RAM allocation, allowing the main viewport (`ArticleView`) to complete its first-paint at the highest priority.
+
+## 5. Expected Results
+- **Perceived Speedup**: Main window display speed improved by 30% - 50%.
+- **I/O Peak Shaving**: Smooths the disk I/O "spike" from massive dictionary loading into a sustained "low-load" process over several seconds.
+- **Stability**: Reduces the probability of thread deadlocks or UI freezes caused by resource contention during critical startup moments.
+
+---
+*Date: 2026-02-05*

locale/ar.ts

@@ -888,10 +888,6 @@ between classic and school orthography in cyrillic)</source>
       <source>Add folder</source>
       <translation>أضف المجلد</translation>
     </message>
-    <message>
-      <source>Clear All</source>
-      <translation>Clear All</translation>
-    </message>
     <message>
       <source>Favorites:</source>
       <translation>المفضلة:</translation>
@@ -900,10 +896,6 @@ between classic and school orthography in cyrillic)</source>
       <source>All selected items will be deleted. Continue?</source>
       <translation>سيتم حذف جميع العناصر المحددة. يكمل؟</translation>
     </message>
-    <message>
-      <source>Clear All Items</source>
-      <translation>Clear All Items</translation>
-    </message>
     <message>
       <source>Are you sure you want to clear all items?</source>
       <translation>Are you sure you want to clear all items?</translation>
@@ -912,6 +904,14 @@ between classic and school orthography in cyrillic)</source>
       <source>Make this folder the target of adding/removing words actions.</source>
       <translation type="unfinished">Make this folder the target of adding/removing words actions.</translation>
     </message>
+    <message>
+      <source>Clear</source>
+      <translation>مسح</translation>
+    </message>
+    <message>
+      <source>Clear Favorites</source>
+      <translation>مسح المفضلة</translation>
+    </message>
   </context>
   <context>
     <name>Forvo::ForvoArticleRequest</name>
@@ -1113,6 +1113,14 @@ between classic and school orthography in cyrillic)</source>
       <source>Are you sure you want to remove all the groups?</source>
       <translation>هل أنت متأكد من إزالة كل المجموعات؟</translation>
     </message>
+    <message>
+      <source>Add a new dictionary group</source>
+      <translation>إضافة مجموعة قاموس جديدة</translation>
+    </message>
+    <message>
+      <source>&amp;Add group</source>
+      <translation>أ&amp;ضف مجموعة</translation>
+    </message>
   </context>
   <context>
     <name>HistoryPaneWidget</name>
@@ -2622,6 +2630,14 @@ To find &apos;*&apos;, &apos;?&apos;, &apos;[&apos;, &apos;]&apos; symbols use &
       <source>Lock Panels</source>
       <translation>تأمين اللوحات</translation>
     </message>
+    <message>
+      <source>Clear History</source>
+      <translation>مسح المحفوظات</translation>
+    </message>
+    <message>
+      <source>Are you sure you want to clear all history items?</source>
+      <translation>هل أنت متأكد من أنك تريد مسح جميع عناصر التاريخ؟</translation>
+    </message>
   </context>
   <context>
     <name>Mdx::MdxArticleRequest</name>
@@ -3296,42 +3312,6 @@ you are browsing. If some site breaks because of this, try disabling this.</sour
       <source>Disallow loading content from other sites (hides most advertisements)</source>
       <translation>امنع تحميل المحتوى من مواقع أخرى (يخفي أغلب الإعلانات)</translation>
     </message>
-    <message>
-      <source>Some sites detect GoldenDict via HTTP headers and block the requests.
-Enable this option to workaround the problem.</source>
-      <translation>بعض المواقع تكتشف القاموس الذهبي من خلال ترويسات HTTP وتمنع الطلبات.
-مكّن هذا الخيار للالتفاف حول المشكلة.</translation>
-    </message>
-    <message>
-      <source>Do not identify GoldenDict in HTTP headers</source>
-      <translation>لا تعرّف القاموس الذهبي في ترويسات HTTP</translation>
-    </message>
-    <message>
-      <source>Maximum network cache size:</source>
-      <translation>الحد الأقصى لحجم ذاكرة التخزين المؤقت للشبكة:</translation>
-    </message>
-    <message>
-      <source>Maximum disk space occupied by GoldenDict&apos;s network cache in
-%1
-If set to 0 the network disk cache will be disabled.</source>
-      <translation>الحد الأقصى لمساحة القرص الذي يشغله GoldenDict&apos;s للشبكة ذاكرة التخزين المؤقت في
-%1
-إذا تم تعيين إلى 0 سيتم تعطيل ذاكرة التخزين المؤقت لقرص الشبكة.</translation>
-    </message>
-    <message>
-      <source> MiB</source>
-      <translation> MiB</translation>
-    </message>
-    <message>
-      <source>When this option is enabled, GoldenDict
-clears its network cache from disk during exit.</source>
-      <translation>عند تمكين هذا الخيار ، يقوم GoldenDict
-بمسح ذاكرة التخزين المؤقت للشبكة من القرص أثناء الخروج.</translation>
-    </message>
-    <message>
-      <source>Clear network cache on exit</source>
-      <translation>امسح ذاكرة التخزين المؤقت للشبكة عند الخروج</translation>
-    </message>
     <message>
       <source>When this is enabled, the program periodically
 checks if a new, updated version of GoldenDict
@@ -3507,10 +3487,6 @@ from Stardict, Babylon and GLS dictionaries</source>
       <source>Save debug messages to gd_log.txt in the config folder</source>
       <translation>Save debug messages to gd_log.txt in the config folder</translation>
     </message>
-    <message>
-      <source>Open website dictionary in seperate tab</source>
-      <translation>فتح قاموس الموقع في علامة تبويب منفصلة</translation>
-    </message>
     <message>
       <source>S&amp;can</source>
       <translation>امسح</translation>
@@ -3523,6 +3499,10 @@ from Stardict, Babylon and GLS dictionaries</source>
       <source>Suppress JavaScript dialogs</source>
       <translation>قمع مربعات حوار جافا سكريبت</translation>
     </message>
+    <message>
+      <source>Open website dictionary in separate tab</source>
+      <translation>فتح قاموس الموقع في علامة تبويب منفصلة</translation>
+    </message>
   </context>
   <context>
     <name>ProgramTypeEditor</name>
@@ -3705,7 +3685,7 @@ from Stardict, Babylon and GLS dictionaries</source>
     </message>
     <message>
       <source>Can&apos;t save article: %1</source>
-      <translation type="unfinished">Can&apos;t save article: %1</translation>
+      <translation>تعذّر حفظ المقالة: %1</translation>
     </message>
     <message>
       <source>Save PDF complete</source>
@@ -3774,6 +3754,10 @@ from Stardict, Babylon and GLS dictionaries</source>
       <source>WARNING: %1</source>
       <translation>تحذير: %1</translation>
     </message>
+    <message>
+      <source>Definition</source>
+      <translation>التعريف</translation>
+    </message>
   </context>
   <context>
     <name>ScanPopupToolBar</name>
@@ -4250,6 +4234,10 @@ Full list of availiable languages can be found &lt;a href=&quot;https://linguali
       <source>Only available when opening websites in separate tabs. Can be a file path (relative to config directory or absolute) or direct script content.</source>
       <translation>متاح فقط عند فتح المواقع في علامات تبويب منفصلة. يمكن أن يكون مسار الملف (نسبة إلى مجلد التكوين أو مطلق) أو محتوى البرنامج النصي المباشر.</translation>
     </message>
+    <message>
+      <source>This column is disabled because &quot;Open website dictionary in separate tab&quot; option is not enabled in Preferences.</source>
+      <translation>هذا العمود معطل لأن &quot;فتح قاموس الموقع في علامة تبويب منفصلة&quot; لم يتم تمكينه في التفضيلات.</translation>
+    </message>
   </context>
   <context>
     <name>WordFinder</name>