je-editor 0.0.223__py3-none-any.whl → 0.0.224__py3-none-any.whl

je_editor/pyside_ui/main_ui/menu/check_style_menu/build_check_style_menu.py

@@ -1,81 +1,104 @@
-from __future__ import annotations
+from __future__ import annotations  # 啟用未來版本的型別註解功能 / Enable postponed evaluation of type annotations
 
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING  # 僅在型別檢查時使用，避免循環匯入 / Used only for type checking to avoid circular imports
 
-from je_editor.pyside_ui.main_ui.editor.editor_widget import EditorWidget
-from je_editor.utils.logging.loggin_instance import jeditor_logger
-from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
+from je_editor.pyside_ui.main_ui.editor.editor_widget import EditorWidget  # 編輯器分頁元件 / Editor tab widget
+from je_editor.utils.logging.loggin_instance import jeditor_logger  # 專案內的日誌紀錄器 / Project 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
-from PySide6.QtGui import QAction, QKeySequence
-from yapf.yapflib.yapf_api import FormatCode
+    from je_editor.pyside_ui.main_ui.main_editor import EditorMain  # 僅在型別檢查時匯入 / Import only for type checking
 
-from je_editor.utils.json_format.json_process import reformat_json
+from PySide6.QtGui import QAction, QKeySequence  # Qt 動作與快捷鍵 / Qt actions and shortcuts
+from yapf.yapflib.yapf_api import FormatCode  # YAPF 程式碼格式化工具 / YAPF code formatter
+
+from je_editor.utils.json_format.json_process import reformat_json  # JSON 格式化工具 / JSON reformatter
 
 
 def set_check_menu(ui_we_want_to_set: EditorMain) -> None:
+    """
+    建立「程式碼檢查/格式化」選單，並加入三個功能：
+    - 使用 YAPF 重新格式化 Python 程式碼
+    - 重新格式化 JSON
+    - 檢查 Python 檔案格式
+
+    Create "Check/Format Code" menu with three actions:
+    - Reformat Python code with YAPF
+    - Reformat JSON
+    - Check Python file format
+    """
     jeditor_logger.info(f"build_check_style_menu.py set_check_menu ui_we_want_to_set: {ui_we_want_to_set}")
+
+    # 在主選單中新增一個子選單 / Add submenu to main menu
     ui_we_want_to_set.check_menu = ui_we_want_to_set.menu.addMenu(
         language_wrapper.language_word_dict.get("check_code_style_menu_label"))
-    # Yapf code check
+
+    # === 1. Yapf Python 程式碼格式化 / Yapf Python code reformat ===
     ui_we_want_to_set.check_menu.yapf_check_python_action = QAction(
         language_wrapper.language_word_dict.get("yapf_reformat_label"))
     ui_we_want_to_set.check_menu.yapf_check_python_action.setShortcut(
-        QKeySequence("Ctrl+Shift+Y"))
+        QKeySequence("Ctrl+Shift+Y"))  # 設定快捷鍵 / Set shortcut
     ui_we_want_to_set.check_menu.yapf_check_python_action.triggered.connect(
-        lambda: yapf_check_python_code(
-            ui_we_want_to_set
-        )
+        lambda: yapf_check_python_code(ui_we_want_to_set)
     )
     ui_we_want_to_set.check_menu.addAction(ui_we_want_to_set.check_menu.yapf_check_python_action)
-    # Reformat JSON
+
+    # === 2. JSON 重新格式化 / Reformat JSON ===
     ui_we_want_to_set.check_menu.reformat_json_action = QAction(
         language_wrapper.language_word_dict.get("reformat_json_label"))
     ui_we_want_to_set.check_menu.reformat_json_action.setShortcut("Ctrl+j")
     ui_we_want_to_set.check_menu.reformat_json_action.triggered.connect(
-        lambda: reformat_json_text(
-            ui_we_want_to_set
-        )
+        lambda: reformat_json_text(ui_we_want_to_set)
     )
     ui_we_want_to_set.check_menu.addAction(ui_we_want_to_set.check_menu.reformat_json_action)
-    # Python formate check
+
+    # === 3. Python 格式檢查 / Python format check ===
     ui_we_want_to_set.check_menu.check_python_format = QAction(
         language_wrapper.language_word_dict.get("python_format_checker"))
     ui_we_want_to_set.check_menu.check_python_format.setShortcut("Ctrl+Alt+p")
     ui_we_want_to_set.check_menu.check_python_format.triggered.connect(
-        lambda: check_python_format(
-            ui_we_want_to_set
-        )
+        lambda: check_python_format(ui_we_want_to_set)
     )
     ui_we_want_to_set.check_menu.addAction(ui_we_want_to_set.check_menu.check_python_format)
 
 
 def yapf_check_python_code(ui_we_want_to_set: EditorMain) -> None:
+    """
+    使用 YAPF 重新格式化目前分頁中的 Python 程式碼
+    Reformat current tab's Python code using YAPF
+    """
     jeditor_logger.info(f"build_check_style_menu.py yapf_check_python_code ui_we_want_to_set: {ui_we_want_to_set}")
     widget = ui_we_want_to_set.tab_widget.currentWidget()
     if isinstance(widget, EditorWidget):
-        code_text = widget.code_edit.toPlainText()
-        widget.code_result.setPlainText("")
+        code_text = widget.code_edit.toPlainText()  # 取得編輯器文字 / Get code text
+        widget.code_result.setPlainText("")  # 清空結果區域 / Clear result area
         format_code = FormatCode(
             unformatted_source=code_text,
-            style_config="google"
+            style_config="google"  # 使用 Google 風格 / Use Google style
         )
         if isinstance(format_code, tuple):
-            widget.code_edit.setPlainText(format_code[0])
+            widget.code_edit.setPlainText(format_code[0])  # 將格式化後的程式碼寫回編輯器 / Write formatted code back
 
 
 def reformat_json_text(ui_we_want_to_set: EditorMain) -> None:
+    """
+    重新格式化目前分頁中的 JSON 文字
+    Reformat JSON text in the current editor tab
+    """
     jeditor_logger.info(f"build_check_style_menu.py reformat_json_text ui_we_want_to_set: {ui_we_want_to_set}")
     widget = ui_we_want_to_set.tab_widget.currentWidget()
     if isinstance(widget, EditorWidget):
         code_text = widget.code_edit.toPlainText()
         widget.code_result.setPlainText("")
-        widget.code_edit.setPlainText(reformat_json(code_text))
+        widget.code_edit.setPlainText(reformat_json(code_text))  # 呼叫 JSON 格式化工具 / Call JSON reformatter
 
 
 def check_python_format(ui_we_want_to_set: EditorMain) -> None:
+    """
+    呼叫 EditorWidget 的檔案格式檢查功能
+    Call EditorWidget's file format checker
+    """
     jeditor_logger.info(f"build_check_style_menu.py check_python_format ui_we_want_to_set: {ui_we_want_to_set}")
     widget = ui_we_want_to_set.tab_widget.currentWidget()
     if isinstance(widget, EditorWidget):
-        widget.check_file_format()
+        widget.check_file_format()

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

@@ -1,4 +1,4 @@
-from __future__ import annotations
+from __future__ import annotations  # 啟用未來版本的型別註解功能 / Enable postponed evaluation of type annotations
 
 from pathlib import Path
 from typing import TYPE_CHECKING
@@ -6,8 +6,9 @@ from typing import TYPE_CHECKING
 from PySide6.QtCore import Qt
 from PySide6.QtGui import QAction
 from PySide6.QtWidgets import QFileDialog
-from frontengine import FrontEngineMainUI
+from frontengine import FrontEngineMainUI  # 外部模組 FrontEngine 的主 UI / External FrontEngine main UI
 
+# 匯入專案內的各種 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.browser.main_browser_widget import MainBrowserWidget
 from je_editor.pyside_ui.code.variable_inspector.inspector_gui import VariableInspector
@@ -18,82 +19,99 @@ 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
-from je_editor.utils.logging.loggin_instance import jeditor_logger
-from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
+
+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
+    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}")
-    # Browser
+
+    # === 建立 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
+
+    # === 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
+
+    # === 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
+
+    # === 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
+
+    # === 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
+
+    # === 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
+
+    # === 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
+
+    # === 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)
-    # Dynamic Console
+
+    # === 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
+
+    # === 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(
@@ -101,51 +119,91 @@ def set_dock_menu(ui_we_want_to_set: EditorMain) -> None:
     )
     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 widget
+
+    # 建立一個可銷毀的 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())
+            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]
-            widget.code_edit.setPlainText(
-                file_content
-            )
+            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

@@ -1,70 +1,103 @@
+# 匯入未來功能，允許延遲型別註解 (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.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.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.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.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)
-    # Main UI font
+
+    # 加入字型與編碼選單
+    # Add font and encoding menus
     add_font_menu(ui_we_want_to_set)
     add_font_size_menu(ui_we_want_to_set)
-    # Encoding
     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}")
@@ -77,6 +110,8 @@ def add_encoding_menu(ui_we_want_to_set: EditorMain) -> None:
         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} "
@@ -85,6 +120,8 @@ def set_encoding(ui_we_want_to_set: EditorMain, action: QAction) -> None:
     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}")
@@ -92,6 +129,8 @@ def show_create_file_dialog(ui_we_want_to_set: EditorMain):
     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}")
@@ -103,6 +142,8 @@ def add_font_menu(ui_we_want_to_set: EditorMain) -> None:
         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}")
@@ -113,24 +154,36 @@ def set_font(ui_we_want_to_set: EditorMain, action: QAction) -> None:
     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):
+    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;"
-        f"font-family: {ui_we_want_to_set.font().family()};"
+        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

@@ -1,24 +1,47 @@
+# 匯入未來功能，允許延遲型別註解 (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(
@@ -29,6 +52,8 @@ def set_help_menu(ui_we_want_to_set: EditorMain) -> None:
     )
     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(
@@ -39,6 +64,8 @@ def set_help_menu(ui_we_want_to_set: EditorMain) -> None:
     )
     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(
@@ -47,17 +74,21 @@ def set_help_menu(ui_we_want_to_set: EditorMain) -> None:
     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),
-        f"{tab_name}{ui_we_want_to_set.tab_widget.count()}"
+        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()
@@ -67,4 +98,4 @@ JEditor
 Create by JE-Chen 2020 ~ Now
         """
     )
-    message_box.exec()
+    message_box.exec()