je-editor 0.0.104__py3-none-any.whl → 0.0.228__py3-none-any.whl

je_editor/pyside_ui/main_ui/menu/dock_menu/build_dock_menu.py

@@ -0,0 +1,208 @@
+from __future__ import annotations  # 啟用未來版本的型別註解功能 / Enable postponed evaluation of type annotations
+
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+from PySide6.QtCore import Qt
+from PySide6.QtGui import QAction
+from PySide6.QtWidgets import QFileDialog
+from frontengine import FrontEngineMainUI  # 外部模組 FrontEngine 的主 UI / External FrontEngine main UI
+
+from je_editor.pyside_ui.browser.main_browser_widget import MainBrowserWidget
+from je_editor.pyside_ui.code.variable_inspector.inspector_gui import VariableInspector
+# 匯入專案內的各種 Dockable widget / Import various dockable widgets from project
+from je_editor.pyside_ui.git_ui.code_diff_compare.code_diff_viewer_widget import DiffViewerWidget
+from je_editor.pyside_ui.git_ui.git_client.git_branch_tree_widget import GitTreeViewGUI
+from je_editor.pyside_ui.git_ui.git_client.git_client_gui import GitGui
+from je_editor.pyside_ui.main_ui.ai_widget.chat_ui import ChatUI
+from je_editor.pyside_ui.main_ui.console_widget.console_gui import ConsoleWidget
+from je_editor.pyside_ui.main_ui.dock.destroy_dock import DestroyDock
+from je_editor.pyside_ui.main_ui.editor.editor_widget_dock import FullEditorWidget
+from je_editor.pyside_ui.main_ui.ipython_widget.rich_jupyter import IpythonWidget
+from je_editor.utils.file.open.open_file import read_file  # 檔案讀取工具 / File reading utility
+from je_editor.utils.logging.loggin_instance import jeditor_logger  # 日誌紀錄器 / Logger
+from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper  # 多語系支援 / Multi-language wrapper
+
+if TYPE_CHECKING:
+    from je_editor.pyside_ui.main_ui.main_editor import EditorMain  # 僅在型別檢查時匯入 / Import only for type checking
+
+
+def set_dock_menu(ui_we_want_to_set: EditorMain) -> None:
+    """
+    建立 Dock 功能選單，並加入各種 Dock 視窗的動作 (Action)。
+    Create the Dock menu and add actions for different dockable widgets.
+    """
+    jeditor_logger.info(f"build_dock_menu.py set_dock_menu ui_we_want_to_set: {ui_we_want_to_set}")
+
+    # === 建立 Dock 主選單 / Create Dock main menu ===
+    ui_we_want_to_set.dock_menu = ui_we_want_to_set.menu.addMenu(
+        language_wrapper.language_word_dict.get("dock_menu_label"))
+
+    # === Browser Dock ===
+    ui_we_want_to_set.dock_menu.new_dock_browser_action = QAction(
+        language_wrapper.language_word_dict.get("dock_browser_label"))
+    ui_we_want_to_set.dock_menu.new_dock_browser_action.triggered.connect(
+        lambda: add_dock_widget(ui_we_want_to_set)
+    )
+    ui_we_want_to_set.dock_menu.addAction(ui_we_want_to_set.dock_menu.new_dock_browser_action)
+
+    # === Editor Dock ===
+    ui_we_want_to_set.dock_menu.new_tab_dock_editor_action = QAction(
+        language_wrapper.language_word_dict.get("dock_editor_label"))
+    ui_we_want_to_set.dock_menu.new_tab_dock_editor_action.triggered.connect(
+        lambda: add_dock_widget(ui_we_want_to_set, "editor")
+    )
+    ui_we_want_to_set.dock_menu.addAction(ui_we_want_to_set.dock_menu.new_tab_dock_editor_action)
+
+    # === FrontEngine Dock ===
+    ui_we_want_to_set.dock_menu.new_frontengine = QAction(
+        language_wrapper.language_word_dict.get("dock_frontengine_label"))
+    ui_we_want_to_set.dock_menu.new_frontengine.triggered.connect(
+        lambda: add_dock_widget(ui_we_want_to_set, "frontengine")
+    )
+    ui_we_want_to_set.dock_menu.addAction(ui_we_want_to_set.dock_menu.new_frontengine)
+
+    # === Ipython Dock ===
+    ui_we_want_to_set.dock_menu.new_ipython = QAction(
+        language_wrapper.language_word_dict.get("dock_ipython_label"))
+    ui_we_want_to_set.dock_menu.new_ipython.triggered.connect(
+        lambda: add_dock_widget(ui_we_want_to_set, "ipython")
+    )
+    ui_we_want_to_set.dock_menu.addAction(ui_we_want_to_set.dock_menu.new_ipython)
+
+    # === ChatUI Dock ===
+    ui_we_want_to_set.dock_menu.new_chat_ui = QAction(
+        language_wrapper.language_word_dict.get("chat_ui_dock_label"))
+    ui_we_want_to_set.dock_menu.new_chat_ui.triggered.connect(
+        lambda: add_dock_widget(ui_we_want_to_set, "chat_ui")
+    )
+    ui_we_want_to_set.dock_menu.addAction(ui_we_want_to_set.dock_menu.new_chat_ui)
+
+    # === Git Client Dock ===
+    ui_we_want_to_set.dock_menu.new_git_client = QAction(
+        language_wrapper.language_word_dict.get("tab_menu_git_client_tab_name"))
+    ui_we_want_to_set.dock_menu.new_git_client.triggered.connect(
+        lambda: add_dock_widget(ui_we_want_to_set, "git_client")
+    )
+    ui_we_want_to_set.dock_menu.addAction(ui_we_want_to_set.dock_menu.new_git_client)
+
+    # === Git Branch Tree View Dock ===
+    ui_we_want_to_set.dock_menu.new_git_branch_view = QAction(
+        language_wrapper.language_word_dict.get("tab_menu_git_branch_tree_view_tab_name"))
+    ui_we_want_to_set.dock_menu.new_git_branch_view.triggered.connect(
+        lambda: add_dock_widget(ui_we_want_to_set, "git_branch_tree_view")
+    )
+    ui_we_want_to_set.dock_menu.addAction(ui_we_want_to_set.dock_menu.new_git_branch_view)
+
+    # === Variable Inspector Dock ===
+    ui_we_want_to_set.dock_menu.new_variable_inspector = QAction(
+        language_wrapper.language_word_dict.get("tab_menu_variable_inspector_tab_name"))
+    ui_we_want_to_set.dock_menu.new_variable_inspector.triggered.connect(
+        lambda: add_dock_widget(ui_we_want_to_set, "variable_inspector")
+    )
+    ui_we_want_to_set.dock_menu.addAction(ui_we_want_to_set.dock_menu.new_variable_inspector)
+
+    # === Console Dock ===
+    ui_we_want_to_set.dock_menu.new_dynamic_console = QAction(
+        language_wrapper.language_word_dict.get("tab_menu_console_widget_tab_name"))
+    ui_we_want_to_set.dock_menu.new_dynamic_console.triggered.connect(
+        lambda: add_dock_widget(ui_we_want_to_set, "console_widget")
+    )
+    ui_we_want_to_set.dock_menu.addAction(ui_we_want_to_set.dock_menu.new_dynamic_console)
+
+    # === Code Diff Viewer Dock ===
+    ui_we_want_to_set.dock_menu.new_code_diff_viewer = QAction(
+        language_wrapper.language_word_dict.get("tab_code_diff_viewer_tab_name"))
+    ui_we_want_to_set.dock_menu.new_code_diff_viewer.triggered.connect(
+        lambda: add_dock_widget(ui_we_want_to_set, "code_diff_viewer")
+    )
+    ui_we_want_to_set.dock_menu.addAction(ui_we_want_to_set.dock_menu.new_code_diff_viewer)
+
+
+def add_dock_widget(ui_we_want_to_set: EditorMain, widget_type: str = None):
+    """
+    根據 widget_type 新增對應的 Dock 視窗，並加到主視窗右側。
+    Add a dock widget based on widget_type and attach it to the right side of the main window.
+    """
+    jeditor_logger.info("build_dock_menu.py add_dock_widget "
+                        f"ui_we_want_to_set: {ui_we_want_to_set} "
+                        f"widget_type: {widget_type}")
+
+    # 建立一個可銷毀的 Dock 容器
+    # Create a destroyable dock container
+    dock_widget = DestroyDock()
+
+    if widget_type == "editor":
+        # 開啟檔案選擇對話框，讓使用者選擇要打開的檔案
+        # Open file dialog for selecting a file
+        file_path = QFileDialog().getOpenFileName(
+            parent=ui_we_want_to_set,
+            dir=str(Path.cwd())  # 預設目錄為當前工作目錄 / Default directory is current working directory
+        )[0]
+        if file_path is not None and file_path != "":
+            # 建立一個完整的編輯器 Dock，並載入檔案內容
+            # Create a full editor dock and load file content
+            widget = FullEditorWidget(current_file=file_path)
+            file_content = read_file(file_path)[1]  # 讀取檔案內容 / Read file content
+            widget.code_edit.setPlainText(file_content)
+            dock_widget.setWindowTitle(language_wrapper.language_word_dict.get("dock_editor_title"))
+            dock_widget.setWidget(widget)
+
+    elif widget_type == "frontengine":
+        # 建立 FrontEngine Dock
+        # Create FrontEngine dock
+        dock_widget.setWindowTitle(language_wrapper.language_word_dict.get("dock_frontengine_title"))
+        dock_widget.setWidget(FrontEngineMainUI(redirect_output=False))
+
+    elif widget_type == "ipython":
+        # 建立 Ipython 互動式控制台 Dock
+        # Create Ipython interactive console dock
+        dock_widget.setWindowTitle(language_wrapper.language_word_dict.get("dock_ipython_title"))
+        dock_widget.setWidget(IpythonWidget(ui_we_want_to_set))
+
+    elif widget_type == "chat_ui":
+        # 建立 ChatUI Dock
+        # Create ChatUI dock
+        dock_widget.setWindowTitle(language_wrapper.language_word_dict.get("chat_ui_dock_label"))
+        dock_widget.setWidget(ChatUI(ui_we_want_to_set))
+
+    elif widget_type == "git_client":
+        # 建立 Git 客戶端 Dock
+        # Create Git client dock
+        dock_widget.setWindowTitle(language_wrapper.language_word_dict.get("tab_menu_git_client_tab_name"))
+        dock_widget.setWidget(GitGui())
+
+    elif widget_type == "git_branch_tree_view":
+        # 建立 Git 分支樹視圖 Dock
+        # Create Git branch tree view dock
+        dock_widget.setWindowTitle(language_wrapper.language_word_dict.get("tab_menu_git_branch_tree_view_tab_name"))
+        dock_widget.setWidget(GitTreeViewGUI())
+
+    elif widget_type == "variable_inspector":
+        # 建立變數檢查器 Dock
+        # Create variable inspector dock
+        dock_widget.setWindowTitle(language_wrapper.language_word_dict.get("tab_menu_variable_inspector_tab_name"))
+        dock_widget.setWidget(VariableInspector())
+
+    elif widget_type == "console_widget":
+        # 建立動態 Console Dock
+        # Create dynamic console dock
+        dock_widget.setWindowTitle(language_wrapper.language_word_dict.get("tab_menu_console_widget_tab_name"))
+        dock_widget.setWidget(ConsoleWidget())
+
+    elif widget_type == "code_diff_viewer":
+        # 建立程式碼差異比較視圖 Dock
+        # Create code diff viewer dock
+        dock_widget.setWindowTitle(language_wrapper.language_word_dict.get("tab_code_diff_viewer_tab_name"))
+        dock_widget.setWidget(DiffViewerWidget())
+
+    else:
+        # 預設為瀏覽器 Dock
+        # Default: Browser dock
+        dock_widget.setWindowTitle(language_wrapper.language_word_dict.get("dock_browser_title"))
+        dock_widget.setWidget(MainBrowserWidget())
+
+    # 如果成功建立了 widget，將其加到主視窗右側 Dock 區域
+    # If widget is created, add it to the right dock area of the main window
+    if dock_widget.widget() is not None:
+        ui_we_want_to_set.addDockWidget(Qt.DockWidgetArea.RightDockWidgetArea, dock_widget)

je_editor/pyside_ui/main_ui/menu/file_menu/build_file_menu.py

@@ -0,0 +1,186 @@
+# 匯入未來功能，允許延遲型別註解 (Python 3.7+ 常用)
+# Import future feature: postponed evaluation of type annotations
+from __future__ import annotations
+
+# 用於型別檢查 (避免循環匯入問題)
+# For type checking only (avoids circular imports)
+from typing import TYPE_CHECKING
+
+# 匯入使用者設定字典，用來保存 UI 設定
+# Import user settings dictionary for saving UI preferences
+from je_editor.pyside_ui.main_ui.save_settings.user_setting_file import user_setting_dict
+# 匯入 Python 編碼清單 (例如 utf-8, gbk 等)
+# Import list of Python encodings (e.g., utf-8, gbk, etc.)
+from je_editor.utils.encodings.python_encodings import python_encodings_list
+# 匯入日誌紀錄器
+# Import logger instance
+from je_editor.utils.logging.loggin_instance import jeditor_logger
+# 匯入多語言包裝器，用於 UI 多語言顯示
+# Import multi-language wrapper for UI localization
+from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
+
+# 僅在型別檢查時匯入 EditorMain，避免循環依賴
+# Import EditorMain only for type checking (avoids circular dependency)
+if TYPE_CHECKING:
+    from je_editor.pyside_ui.main_ui.main_editor import EditorMain
+
+# 匯入 Qt 動作與字型資料庫
+# Import QAction and QFontDatabase from PySide6
+from PySide6.QtGui import QAction, QFontDatabase
+
+# 匯入檔案對話框 (新建、開啟、儲存)
+# Import file dialogs (create, open, save)
+from je_editor.pyside_ui.dialog.file_dialog.create_file_dialog import CreateFileDialog
+from je_editor.pyside_ui.dialog.file_dialog.open_file_dialog import choose_file_get_open_file_path, \
+    choose_dir_get_dir_path
+from je_editor.pyside_ui.dialog.file_dialog.save_file_dialog import choose_file_get_save_file_path
+
+
+# 設定檔案選單 (File Menu)
+# Set up the File menu
+def set_file_menu(ui_we_want_to_set: EditorMain) -> None:
+    jeditor_logger.info("build_file_menu.py add_dock_widget "
+                        f"ui_we_want_to_set: {ui_we_want_to_set}")
+    # 建立 File 選單
+    # Create File menu
+    ui_we_want_to_set.file_menu = ui_we_want_to_set.menu.addMenu(
+        language_wrapper.language_word_dict.get("file_menu_label"))
+
+    # 新建檔案動作
+    # New File action
+    ui_we_want_to_set.file_menu.new_file_action = QAction(
+        language_wrapper.language_word_dict.get("file_menu_new_file_label"))
+    ui_we_want_to_set.file_menu.new_file_action.setShortcut("Ctrl+n")
+    ui_we_want_to_set.file_menu.new_file_action.triggered.connect(
+        lambda: show_create_file_dialog(ui_we_want_to_set)
+    )
+    ui_we_want_to_set.file_menu.addAction(ui_we_want_to_set.file_menu.new_file_action)
+
+    # 開啟檔案動作
+    # Open File action
+    ui_we_want_to_set.file_menu.open_file_action = QAction(
+        language_wrapper.language_word_dict.get("file_menu_open_file_label"))
+    ui_we_want_to_set.file_menu.open_file_action.setShortcut("Ctrl+o")
+    ui_we_want_to_set.file_menu.open_file_action.triggered.connect(
+        lambda: choose_file_get_open_file_path(parent_qt_instance=ui_we_want_to_set)
+    )
+    ui_we_want_to_set.file_menu.addAction(ui_we_want_to_set.file_menu.open_file_action)
+
+    # 開啟資料夾動作
+    # Open Folder action
+    ui_we_want_to_set.file_menu.open_folder_action = QAction(
+        language_wrapper.language_word_dict.get("file_menu_open_folder_label"))
+    ui_we_want_to_set.file_menu.open_folder_action.setShortcut("Ctrl+K")
+    ui_we_want_to_set.file_menu.open_folder_action.triggered.connect(
+        lambda: choose_dir_get_dir_path(parent_qt_instance=ui_we_want_to_set)
+    )
+    ui_we_want_to_set.file_menu.addAction(ui_we_want_to_set.file_menu.open_folder_action)
+
+    # 儲存檔案動作
+    # Save File action
+    ui_we_want_to_set.file_menu.save_file_action = QAction(
+        language_wrapper.language_word_dict.get("file_menu_save_file_label"))
+    ui_we_want_to_set.file_menu.save_file_action.setShortcut("Ctrl+s")
+    ui_we_want_to_set.file_menu.save_file_action.triggered.connect(
+        lambda: choose_file_get_save_file_path(parent_qt_instance=ui_we_want_to_set)
+    )
+    ui_we_want_to_set.file_menu.addAction(ui_we_want_to_set.file_menu.save_file_action)
+
+    # 加入字型與編碼選單
+    # Add font and encoding menus
+    add_font_menu(ui_we_want_to_set)
+    add_font_size_menu(ui_we_want_to_set)
+    add_encoding_menu(ui_we_want_to_set)
+
+
+# 建立編碼選單
+# Add Encoding menu
+def add_encoding_menu(ui_we_want_to_set: EditorMain) -> None:
+    jeditor_logger.info("build_file_menu.py add_encoding_menu "
+                        f"ui_we_want_to_set: {ui_we_want_to_set}")
+    ui_we_want_to_set.file_menu.encoding_menu = ui_we_want_to_set.file_menu.addMenu(
+        language_wrapper.language_word_dict.get("file_menu_encoding_label"))
+    for encoding in python_encodings_list:
+        encoding_action = QAction(encoding, parent=ui_we_want_to_set.file_menu.encoding_menu)
+        encoding_action.triggered.connect(
+            lambda checked=False, action=encoding_action: set_encoding(ui_we_want_to_set, action))
+        ui_we_want_to_set.file_menu.encoding_menu.addAction(encoding_action)
+
+
+# 設定編碼
+# Set encoding
+def set_encoding(ui_we_want_to_set: EditorMain, action: QAction) -> None:
+    jeditor_logger.info("build_file_menu.py set_encoding "
+                        f"ui_we_want_to_set: {ui_we_want_to_set} "
+                        f"action: {action}")
+    ui_we_want_to_set.encoding = action.text()
+    user_setting_dict.update({"encoding": action.text()})
+
+
+# 顯示新建檔案對話框
+# Show Create File dialog
+def show_create_file_dialog(ui_we_want_to_set: EditorMain):
+    jeditor_logger.info("build_file_menu.py show_create_file_dialog "
+                        f"ui_we_want_to_set: {ui_we_want_to_set}")
+    ui_we_want_to_set.create_file_dialog = CreateFileDialog()
+    ui_we_want_to_set.create_file_dialog.show()
+
+
+# 建立字型選單
+# Add Font menu
+def add_font_menu(ui_we_want_to_set: EditorMain) -> None:
+    jeditor_logger.info("build_file_menu.py add_font_menu "
+                        f"ui_we_want_to_set: {ui_we_want_to_set}")
+    ui_we_want_to_set.file_menu.font_menu = ui_we_want_to_set.file_menu.addMenu(
+        language_wrapper.language_word_dict.get("file_menu_font_label"))
+    for family in QFontDatabase().families():
+        font_action = QAction(family, parent=ui_we_want_to_set.file_menu.font_menu)
+        font_action.triggered.connect(lambda checked=False, action=font_action: set_font(ui_we_want_to_set, action))
+        ui_we_want_to_set.file_menu.font_menu.addAction(font_action)
+
+
+# 設定字型
+# Set Font
+def set_font(ui_we_want_to_set: EditorMain, action: QAction) -> None:
+    jeditor_logger.info("build_file_menu.py set_font "
+                        f"ui_we_want_to_set: {ui_we_want_to_set}")
+    ui_we_want_to_set.setStyleSheet(
+        f"font-size: {ui_we_want_to_set.font().pointSize()}pt;"
+        f"font-family: {action.text()};"
+    )
+    user_setting_dict.update({"ui_font": action.text()})
+
+
+# 建立字型大小選單
+# Add Font Size menu
+def add_font_size_menu(ui_we_want_to_set: EditorMain) -> None:
+    jeditor_logger.info("build_file_menu.py add_font_size_menu "
+                        f"ui_we_want_to_set: {ui_we_want_to_set}")
+    ui_we_want_to_set.file_menu.font_size_menu = ui_we_want_to_set.file_menu.addMenu(
+        language_wrapper.language_word_dict.get("file_menu_font_size_label"))
+    for size in range(12, 38, 2):  # 12 到 36，每次增加 2
+        font_action = QAction(str(size), parent=ui_we_want_to_set.file_menu)
+        font_action.triggered.connect(
+            lambda checked=False, action=font_action: set_font_size(ui_we_want_to_set, action))
+        ui_we_want_to_set.file_menu.font_size_menu.addAction(font_action)
+
+
+# 設定字型大小
+# Set Font Size
+def set_font_size(ui_we_want_to_set: EditorMain, action: QAction) -> None:
+    # 紀錄日誌，方便除錯與追蹤
+    # Log information for debugging and tracking
+    jeditor_logger.info("build_file_menu.py set_font_size "
+                        f"ui_we_want_to_set: {ui_we_want_to_set} "
+                        f"action: {action}")
+
+    # 使用 Qt 的 setStyleSheet 設定整體 UI 的字型樣式
+    # Apply stylesheet to set the font size and keep the current font family
+    ui_we_want_to_set.setStyleSheet(
+        f"font-size: {int(action.text())}pt;"  # 設定字型大小 (pt)
+        f"font-family: {ui_we_want_to_set.font().family()};"  # 保持目前的字型家族
+    )
+
+    # 更新使用者設定字典，保存字型大小設定
+    # Update user settings dictionary to persist font size preference
+    user_setting_dict.update({"ui_font_size": int(action.text())})

je_editor/pyside_ui/main_ui/menu/help_menu/build_help_menu.py

@@ -0,0 +1,100 @@
+# 匯入未來功能，允許延遲型別註解 (Python 3.7+ 常用)
+# Import future feature: postponed evaluation of type annotations
+from __future__ import annotations
+
+# 僅用於型別檢查，避免循環匯入
+# For type checking only (avoids circular imports)
+from typing import TYPE_CHECKING
+
+# 匯入內建瀏覽器元件，用於在程式內開啟網頁
+# Import embedded browser widget for opening web pages inside the app
+from je_editor.pyside_ui.browser.main_browser_widget import MainBrowserWidget
+# 匯入日誌紀錄器
+# Import logger instance
+from je_editor.utils.logging.loggin_instance import jeditor_logger
+
+# 僅在型別檢查時匯入 EditorMain，避免循環依賴
+# Import EditorMain only for type checking (avoids circular dependency)
+if TYPE_CHECKING:
+    from je_editor.pyside_ui.main_ui.main_editor import EditorMain
+
+# 匯入 Qt 動作與訊息框
+# Import QAction and QMessageBox from PySide6
+from PySide6.QtGui import QAction
+from PySide6.QtWidgets import QMessageBox
+
+# 匯入多語言包裝器，用於 UI 多語言顯示
+# Import multi-language wrapper for UI localization
+from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
+
+
+# 設定「說明」選單 (Help Menu)
+# Set up the Help menu
+def set_help_menu(ui_we_want_to_set: EditorMain) -> None:
+    jeditor_logger.info("build_help_menu.py set_help_menu "
+                        f"ui_we_want_to_set: {ui_we_want_to_set}")
+
+    # 建立 Help 選單
+    # Create Help menu
+    ui_we_want_to_set.help_menu = ui_we_want_to_set.menu.addMenu(
+        language_wrapper.language_word_dict.get("help_menu_label"))
+
+    # 建立「開啟 GitHub」動作
+    # Add "Open GitHub" action
+    ui_we_want_to_set.help_menu.help_github_action = QAction(
+        language_wrapper.language_word_dict.get("help_menu_open_github_label"))
+    ui_we_want_to_set.help_menu.help_github_action.triggered.connect(
+        lambda: open_web_browser(
+            ui_we_want_to_set,
+            "https://github.com/Integrated-Testing-Environment/je_editor",
+            language_wrapper.language_word_dict.get("help_menu_open_github_label"))
+    )
+    ui_we_want_to_set.help_menu.addAction(ui_we_want_to_set.help_menu.help_github_action)
+
+    # 建立「開啟文件」動作
+    # Add "Open Documentation" action
+    ui_we_want_to_set.help_menu.help_doc_action = QAction(
+        language_wrapper.language_word_dict.get("help_menu_open_doc_label"))
+    ui_we_want_to_set.help_menu.help_doc_action.triggered.connect(
+        lambda: open_web_browser(
+            ui_we_want_to_set,
+            "https://je-editor.readthedocs.io/en/latest/",
+            language_wrapper.language_word_dict.get("help_menu_open_doc_label"))
+    )
+    ui_we_want_to_set.help_menu.addAction(ui_we_want_to_set.help_menu.help_doc_action)
+
+    # 建立「關於」動作
+    # Add "About" action
+    ui_we_want_to_set.help_menu.help_about_action = QAction(
+        language_wrapper.language_word_dict.get("help_menu_open_about_label"))
+    ui_we_want_to_set.help_menu.help_about_action.triggered.connect(
+        show_about
+    )
+    ui_we_want_to_set.help_menu.addAction(ui_we_want_to_set.help_menu.help_about_action)
+
+
+# 開啟內建瀏覽器分頁
+# Open a new tab in the embedded browser
+def open_web_browser(ui_we_want_to_set: EditorMain, url: str, tab_name: str):
+    jeditor_logger.info("build_help_menu.py open_web_browser "
+                        f"ui_we_want_to_set: {ui_we_want_to_set} "
+                        f"url: {url} "
+                        f"tab_name: {tab_name}")
+    ui_we_want_to_set.tab_widget.addTab(
+        MainBrowserWidget(start_url=url),  # 建立瀏覽器元件並載入指定 URL
+        f"{tab_name}{ui_we_want_to_set.tab_widget.count()}"  # 分頁名稱 + 當前分頁數
+    )
+
+
+# 顯示「關於」訊息框
+# Show "About" message box
+def show_about():
+    jeditor_logger.info("build_help_menu.py show_about")
+    message_box = QMessageBox()
+    message_box.setText(
+        """
+JEditor
+Create by JE-Chen 2020 ~ Now
+        """
+    )
+    message_box.exec()

je_editor/pyside_ui/main_ui/menu/language_menu/build_language_server.py

@@ -0,0 +1,89 @@
+# 匯入未來功能，允許延遲型別註解 (Python 3.7+ 常用)
+# Import future feature: postponed evaluation of type annotations
+from __future__ import annotations
+
+# 僅用於型別檢查，避免循環匯入
+# For type checking only (avoids circular imports)
+from typing import TYPE_CHECKING
+
+# 匯入 Qt 動作與訊息框
+# Import QAction and QMessageBox from PySide6
+from PySide6.QtGui import QAction
+from PySide6.QtWidgets import QMessageBox
+
+# 匯入使用者設定字典，用來保存語言設定
+# Import user settings dictionary for saving language preferences
+from je_editor.pyside_ui.main_ui.save_settings.user_setting_file import user_setting_dict
+# 匯入日誌紀錄器
+# Import logger instance
+from je_editor.utils.logging.loggin_instance import jeditor_logger
+
+# 僅在型別檢查時匯入 EditorMain，避免循環依賴
+# Import EditorMain only for type checking (avoids circular dependency)
+if TYPE_CHECKING:
+    from je_editor.pyside_ui.main_ui.main_editor import EditorMain
+
+# 匯入多語言包裝器，用於 UI 多語言顯示
+# Import multi-language wrapper for UI localization
+from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
+
+
+# 設定語言選單
+# Set up the Language menu
+def set_language_menu(ui_we_want_to_set: EditorMain) -> None:
+    jeditor_logger.info(f"build_language_server.py set_language_menu ui_we_want_to_set: {ui_we_want_to_set}")
+
+    # 建立 Language 選單
+    # Create Language menu
+    ui_we_want_to_set.language_menu = ui_we_want_to_set.menu.addMenu(
+        language_wrapper.language_word_dict.get("language_menu_label")
+    )
+
+    # 建立「切換到英文」動作
+    # Add "Switch to English" action
+    ui_we_want_to_set.language_menu.change_to_english_language_action = QAction(
+        language_wrapper.language_word_dict.get("language_menu_bar_english")
+    )
+    ui_we_want_to_set.language_menu.change_to_english_language_action.triggered.connect(
+        lambda: set_language("English", ui_we_want_to_set)
+    )
+
+    # 建立「切換到繁體中文」動作
+    # Add "Switch to Traditional Chinese" action
+    ui_we_want_to_set.language_menu.change_to_traditional_chinese_language_action = QAction(
+        language_wrapper.language_word_dict.get("language_menu_bar_traditional_chinese")
+    )
+    ui_we_want_to_set.language_menu.change_to_traditional_chinese_language_action.triggered.connect(
+        lambda: set_language("Traditional_Chinese", ui_we_want_to_set)
+    )
+
+    # 將動作加入選單
+    # Add actions to the menu
+    ui_we_want_to_set.language_menu.addAction(
+        ui_we_want_to_set.language_menu.change_to_english_language_action
+    )
+    ui_we_want_to_set.language_menu.addAction(
+        ui_we_want_to_set.language_menu.change_to_traditional_chinese_language_action
+    )
+
+
+# 設定語言
+# Set the application language
+def set_language(language: str, ui_we_want_to_set: EditorMain) -> None:
+    jeditor_logger.info("build_language_server.py set_language "
+                        f"language: {language} "
+                        f"ui_we_want_to_set: {ui_we_want_to_set}")
+
+    # 重設語言 (更新多語言字典)
+    # Reset language (update multi-language dictionary)
+    language_wrapper.reset_language(language)
+
+    # 更新使用者設定，保存語言偏好
+    # Update user settings dictionary to persist language preference
+    user_setting_dict.update({"language": language})
+
+    # 顯示提示訊息，提醒使用者需要重新啟動程式
+    # Show a message box to remind user to restart the application
+    message_box = QMessageBox(ui_we_want_to_set)
+    message_box.setText(language_wrapper.language_word_dict.get("language_menu_bar_please_restart_messagebox"))
+    message_box.show()