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

je_editor/pyside_ui/main_ui/menu/text_menu/build_text_menu.py

@@ -1,31 +1,69 @@
 from __future__ import annotations
+# 啟用未來註解功能，允許型別提示使用字串前向參照
+# Enable future annotations, allowing forward references in type hints
 
 from typing import TYPE_CHECKING
+# TYPE_CHECKING 用於避免在執行時載入不必要的模組
+# TYPE_CHECKING prevents unnecessary imports at runtime
 
 from PySide6.QtGui import QAction
+# 匯入 QAction，用於建立選單動作
+# Import QAction for creating menu actions
 
 from je_editor.pyside_ui.main_ui.editor.editor_widget import EditorWidget
+# 匯入編輯器元件
+# Import the Editor widget
+
 from je_editor.pyside_ui.main_ui.save_settings.user_setting_file import user_setting_dict
+# 匯入使用者設定字典，用於儲存字型與字體大小
+# Import user setting dictionary to save font and size
+
 from je_editor.utils.logging.loggin_instance import jeditor_logger
+# 匯入日誌工具
+# Import logger
 
 if TYPE_CHECKING:
     from je_editor.pyside_ui.main_ui.main_editor import EditorMain
+    # 僅在型別檢查時匯入 EditorMain，避免循環依賴
+    # Import EditorMain only for type checking
+
 from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
+# 匯入多語言包裝器，用於多語系 UI
+# Import language wrapper for multilingual UI
 
 
 def set_text_menu(ui_we_want_to_set: EditorMain):
+    """
+    建立文字選單，包含字型與字體大小的子選單
+    Create the text menu, including font and font size submenus
+    """
     jeditor_logger.info(f"build_text_menu.py set_text_menu ui_we_want_to_set: {ui_we_want_to_set}")
+
+    # 建立 Text Menu
+    # Create Text Menu
     ui_we_want_to_set.text_menu = ui_we_want_to_set.menu.addMenu(
         language_wrapper.language_word_dict.get("text_menu_label"))
+
+    # === 字型選單 (Font Menu) ===
+    # === Font Menu ===
     ui_we_want_to_set.text_menu.font_menu = ui_we_want_to_set.text_menu.addMenu(
         language_wrapper.language_word_dict.get("text_menu_label_font"))
+
+    # 將系統支援的字型加入選單
+    # Add available system fonts into the menu
     for family in ui_we_want_to_set.font_database.families():
         font_action = QAction(family, parent=ui_we_want_to_set.text_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.text_menu.font_menu.addAction(font_action)
+
+    # === 字體大小選單 (Font Size Menu) ===
+    # === Font Size Menu ===
     ui_we_want_to_set.text_menu.font_size_menu = ui_we_want_to_set.text_menu.addMenu(
         language_wrapper.language_word_dict.get("text_menu_label_font_size"))
+
+    # 提供 12 ~ 36 pt 的字體大小選項 (每次增加 2)
+    # Provide font sizes from 12 to 36 pt (step = 2)
     for size in range(12, 38, 2):
         font_action = QAction(str(size), parent=ui_we_want_to_set.text_menu.font_size_menu)
         font_action.triggered.connect(
@@ -34,36 +72,62 @@ def set_text_menu(ui_we_want_to_set: EditorMain):
 
 
 def set_font(ui_we_want_to_set: EditorMain, action: QAction) -> None:
+    """
+    設定編輯器的字型
+    Set the font family for the editor
+    """
     jeditor_logger.info("build_text_menu.py set_font "
                         f"ui_we_want_to_set: {ui_we_want_to_set} "
                         f"action: {action}")
+
+    # 遍歷所有分頁，找到 EditorWidget 並套用字型
+    # Iterate through all tabs, apply font to EditorWidget
     for code_editor in range(ui_we_want_to_set.tab_widget.count()):
         widget = ui_we_want_to_set.tab_widget.widget(code_editor)
         if isinstance(widget, EditorWidget):
+            # 設定程式碼編輯區字型
+            # Set font for code editor
             widget.code_edit.setStyleSheet(
                 f"font-size: {widget.code_edit.font().pointSize()}pt;"
                 f"font-family: {action.text()};"
             )
+            # 設定輸出結果區字型
+            # Set font for result display
             widget.code_result.setStyleSheet(
                 f"font-size: {widget.code_result.font().pointSize()}pt;"
                 f"font-family: {action.text()};"
             )
+            # 更新使用者設定
+            # Update user settings
             user_setting_dict.update({"font": action.text()})
 
 
 def set_font_size(ui_we_want_to_set: EditorMain, action: QAction) -> None:
+    """
+    設定編輯器的字體大小
+    Set the font size for the editor
+    """
     jeditor_logger.info("build_text_menu.py set_font_size "
                         f"ui_we_want_to_set: {ui_we_want_to_set} "
                         f"action: {action}")
+
+    # 遍歷所有分頁，找到 EditorWidget 並套用字體大小
+    # Iterate through all tabs, apply font size to EditorWidget
     for code_editor in range(ui_we_want_to_set.tab_widget.count()):
         widget = ui_we_want_to_set.tab_widget.widget(code_editor)
         if type(widget) is EditorWidget:
+            # 設定程式碼編輯區字體大小
+            # Set font size for code editor
             widget.code_edit.setStyleSheet(
                 f"font-size: {int(action.text())}pt;"
                 f"font-family: {widget.code_edit.font().family()};"
             )
+            # 設定輸出結果區字體大小
+            # Set font size for result display
             widget.code_result.setStyleSheet(
                 f"font-size: {int(action.text())}pt;"
                 f"font-family: {widget.code_result.font().family()};"
             )
-            user_setting_dict.update({"font_size": int(action.text())})
+            # 更新使用者設定
+            # Update user settings
+            user_setting_dict.update({"font_size": int(action.text())})

je_editor/pyside_ui/main_ui/save_settings/setting_utils.py

@@ -6,11 +6,28 @@ from je_editor.utils.logging.loggin_instance import jeditor_logger
 
 
 def write_setting(save_dict: dict, file_name: str) -> None:
+    """
+    將設定資料寫入 JSON 檔案
+    Write settings dictionary into a JSON file
+    """
+    # 紀錄日誌，方便除錯與追蹤
+    # Log the action for debugging and tracking
     jeditor_logger.info("setting_utils.py write_setting "
                         f"save_dict: {save_dict} "
                         f"file_name: {file_name}")
+
+    # 建立儲存設定的資料夾路徑：當前工作目錄下的 `.jeditor`
+    # Create the save directory path: `.jeditor` under current working directory
     save_dir = Path(getcwd() + "/.jeditor")
+
+    # 如果資料夾不存在就自動建立 (parents=True 表示可遞迴建立多層資料夾)
+    # Create the directory if it does not exist (parents=True allows nested dirs)
     save_dir.mkdir(parents=True, exist_ok=True)
+
+    # 建立完整的檔案路徑，例如 `.jeditor/settings.json`
+    # Create the full file path, e.g., `.jeditor/settings.json`
     save_file = Path(getcwd() + f"/.jeditor/{file_name}")
-    write_json(str(save_file), save_dict)
 
+    # 將設定字典寫入 JSON 檔案
+    # Write the dictionary into the JSON file
+    write_json(str(save_file), save_dict)

je_editor/pyside_ui/main_ui/save_settings/user_color_setting_file.py

@@ -10,34 +10,47 @@ from je_editor.utils.logging.loggin_instance import jeditor_logger
 
 
 def update_actually_color_dict():
+    """
+    更新實際使用的顏色字典 (actually_color_dict)，
+    將 user_setting_color_dict 中的 RGB 值轉換成 QColor 物件。
+    Update the actual color dictionary (actually_color_dict),
+    converting RGB values from user_setting_color_dict into QColor objects.
+    """
     jeditor_logger.info(f"user_color_setting_file.py update_actually_color_dict")
+
     actually_color_dict.update(
         {
+            # 行號顏色 / Line number color
             "line_number_color": QColor(
                 user_setting_color_dict.get("line_number_color")[0],
                 user_setting_color_dict.get("line_number_color")[1],
                 user_setting_color_dict.get("line_number_color")[2],
             ),
+            # 行號背景顏色 / Line number background color
             "line_number_background_color": QColor(
                 user_setting_color_dict.get("line_number_background_color")[0],
                 user_setting_color_dict.get("line_number_background_color")[1],
                 user_setting_color_dict.get("line_number_background_color")[2],
             ),
+            # 當前行顏色 / Current line highlight color
             "current_line_color": QColor(
                 user_setting_color_dict.get("current_line_color")[0],
                 user_setting_color_dict.get("current_line_color")[1],
                 user_setting_color_dict.get("current_line_color")[2],
             ),
+            # 一般輸出顏色 / Normal output color
             "normal_output_color": QColor(
                 user_setting_color_dict.get("normal_output_color")[0],
                 user_setting_color_dict.get("normal_output_color")[1],
                 user_setting_color_dict.get("normal_output_color")[2],
             ),
+            # 錯誤輸出顏色 / Error output color
             "error_output_color": QColor(
                 user_setting_color_dict.get("error_output_color")[0],
                 user_setting_color_dict.get("error_output_color")[1],
                 user_setting_color_dict.get("error_output_color")[2],
             ),
+            # 警告輸出顏色 / Warning output color
             "warning_output_color": QColor(
                 user_setting_color_dict.get("warning_output_color")[0],
                 user_setting_color_dict.get("warning_output_color")[1],
@@ -47,6 +60,8 @@ def update_actually_color_dict():
     )
 
 
+# 使用者設定的顏色字典 (以 RGB list 表示)
+# User-defined color dictionary (stored as RGB lists)
 user_setting_color_dict: Dict[str, list] = {
     "line_number_color": [255, 255, 255],
     "line_number_background_color": [179, 179, 179],
@@ -56,18 +71,33 @@ user_setting_color_dict: Dict[str, list] = {
     "warning_output_color": [204, 204, 0]
 }
 
-actually_color_dict: Dict[str, QColor] = {
-}
+# 實際使用的顏色字典 (以 QColor 表示)
+# Actual color dictionary (stored as QColor objects)
+actually_color_dict: Dict[str, QColor] = {}
+
+# 初始化時先更新一次
+# Update once at initialization
 update_actually_color_dict()
 
 
 def write_user_color_setting() -> None:
+    """
+    將使用者顏色設定寫入 JSON 檔案
+    Write user color settings into a JSON file
+    """
     jeditor_logger.info("user_color_setting_file.py write_user_color_setting")
     write_setting(user_setting_color_dict, "user_color_setting.json")
 
 
 def read_user_color_setting() -> None:
+    """
+    從 JSON 檔案讀取使用者顏色設定，並更新 user_setting_color_dict
+    Read user color settings from JSON file and update user_setting_color_dict
+    """
     jeditor_logger.info("user_color_setting_file.py read_user_color_setting")
     user_color_setting_file = Path(getcwd() + "/.jeditor/user_color_setting.json")
+
+    # 如果檔案存在，就讀取並更新設定
+    # If the file exists, read and update the settings
     if user_color_setting_file.exists() and user_color_setting_file.is_file():
-        user_setting_color_dict.update(read_json(str(user_color_setting_file)))
+        user_setting_color_dict.update(read_json(str(user_color_setting_file)))

je_editor/pyside_ui/main_ui/save_settings/user_setting_file.py

@@ -2,30 +2,57 @@ from os import getcwd
 from pathlib import Path
 
 from je_editor.pyside_ui.main_ui.save_settings.setting_utils import write_setting
+# 匯入通用的設定寫入工具
+# Import utility function to write settings
+
 from je_editor.utils.json.json_file import read_json
+# 匯入 JSON 讀取工具
+# Import JSON reader utility
+
 from je_editor.utils.logging.loggin_instance import jeditor_logger
+# 匯入日誌工具
+# Import logger
+
 
+# 使用者設定字典，包含 UI 與編輯器的偏好
+# User settings dictionary, storing UI and editor preferences
 user_setting_dict = {
-    "ui_font": "Lato",
-    "ui_font_size": 12,
-    "language": "English",
-    "ui_style": "dark_amber.xml",
-    "font": "Lato",
-    "font_size": 12,
-    "encoding": "utf-8",
-    "last_file": None,
-    "python_compiler": None,
-    "max_line_of_output": 200000,
+    "ui_font": "Lato",              # UI 字型 / UI font
+    "ui_font_size": 12,             # UI 字體大小 / UI font size
+    "language": "English",          # 語言設定 / Language setting
+    "ui_style": "dark_amber.xml",   # UI 樣式檔 / UI style file
+    "font": "Lato",                 # 編輯器字型 / Editor font
+    "font_size": 12,                # 編輯器字體大小 / Editor font size
+    "encoding": "utf-8",            # 檔案編碼 / File encoding
+    "last_file": None,              # 上次開啟的檔案 / Last opened file
+    "python_compiler": None,        # Python 編譯器路徑 / Python compiler path
+    "max_line_of_output": 200000,   # 最大輸出行數限制 / Max lines of output
 }
 
 
 def write_user_setting() -> None:
+    """
+    將使用者設定寫入 JSON 檔案
+    Write user settings into a JSON file
+    """
     jeditor_logger.info("user_setting_file.py write_user_setting")
+    # 呼叫通用工具，將 user_setting_dict 寫入 `.jeditor/user_setting.json`
+    # Use utility to write user_setting_dict into `.jeditor/user_setting.json`
     write_setting(user_setting_dict, "user_setting.json")
 
 
 def read_user_setting() -> None:
+    """
+    從 JSON 檔案讀取使用者設定，並更新 user_setting_dict
+    Read user settings from JSON file and update user_setting_dict
+    """
     jeditor_logger.info("user_setting_file.py read_user_setting")
+
+    # 設定檔路徑：當前工作目錄下的 `.jeditor/user_setting.json`
+    # File path: `.jeditor/user_setting.json` under current working directory
     user_setting_file = Path(getcwd() + "/.jeditor/user_setting.json")
+
+    # 如果檔案存在，就讀取並更新設定字典
+    # If the file exists, read and update the settings dictionary
     if user_setting_file.exists() and user_setting_file.is_file():
-        user_setting_dict.update(read_json(str(user_setting_file)))
+        user_setting_dict.update(read_json(str(user_setting_file)))

je_editor/pyside_ui/main_ui/system_tray/extend_system_tray.py

@@ -1,11 +1,15 @@
 from __future__ import annotations
+# 啟用未來註解功能，允許型別提示使用字串前向參照
+# Enable future annotations, allowing forward references in type hints
 
 from typing import TYPE_CHECKING
-
 from je_editor.utils.logging.loggin_instance import jeditor_logger
 
 if TYPE_CHECKING:
     from je_editor.pyside_ui.main_ui.main_editor import EditorMain
+    # 僅在型別檢查時匯入 EditorMain，避免循環依賴
+    # Import EditorMain only for type checking
+
 import sys
 
 from PySide6.QtGui import QAction
@@ -14,38 +18,71 @@ from je_editor.utils.multi_language.multi_language_wrapper import language_wrapp
 
 
 class ExtendSystemTray(QSystemTrayIcon):
+    """
+    擴充系統匣功能，提供隱藏、最大化、還原、關閉等操作
+    Extend system tray functionality with hide, maximize, restore, and close actions
+    """
 
     def __init__(self, main_window: EditorMain):
+        # 初始化並記錄日誌
+        # Initialize and log
         jeditor_logger.info(f"Init ExtendSystemTray main_window: {main_window}")
         super().__init__(parent=main_window)
+
+        # 建立右鍵選單
+        # Create context menu
         self.menu = QMenu()
         self.main_window = main_window
+
+        # === 隱藏主視窗 / Hide main window ===
         self.hide_main_window_action = QAction(
             language_wrapper.language_word_dict.get("system_tray_hide"))
         self.hide_main_window_action.triggered.connect(self.main_window.hide)
         self.menu.addAction(self.hide_main_window_action)
+
+        # === 最大化主視窗 / Maximize main window ===
         self.maximized_main_window_action = QAction(
             language_wrapper.language_word_dict.get("system_tray_maximized"))
         self.maximized_main_window_action.triggered.connect(self.main_window.showMaximized)
         self.menu.addAction(self.maximized_main_window_action)
+
+        # === 還原主視窗 / Restore main window ===
         self.normal_main_window_action = QAction(
             language_wrapper.language_word_dict.get("system_tray_normal"))
         self.normal_main_window_action.triggered.connect(self.main_window.showNormal)
         self.menu.addAction(self.normal_main_window_action)
+
+        # === 關閉應用程式 / Close application ===
         self.close_main_window_action = QAction(
             language_wrapper.language_word_dict.get("system_tray_close"))
         self.close_main_window_action.triggered.connect(self.close_all)
         self.menu.addAction(self.close_main_window_action)
+
+        # 設定選單到系統匣圖示
+        # Attach menu to system tray icon
         self.setContextMenu(self.menu)
+
+        # 綁定點擊事件 (例如雙擊)
+        # Connect click events (e.g., double-click)
         self.activated.connect(self.clicked)
 
     def close_all(self):
+        """
+        關閉應用程式：隱藏圖示、關閉主視窗並結束程式
+        Close the application: hide tray icon, close main window, and exit program
+        """
         jeditor_logger.info("ExtendSystemTray close_all")
         self.setVisible(False)
         self.main_window.close()
         sys.exit(0)
 
     def clicked(self, reason):
+        """
+        處理系統匣點擊事件
+        Handle system tray click events
+        """
         if reason == self.ActivationReason.DoubleClick:
+            # 如果是雙擊，最大化主視窗
+            # If double-click, maximize the main window
             jeditor_logger.info("ExtendSystemTray DoubleClick")
-            self.main_window.showMaximized()
+            self.main_window.showMaximized()

je_editor/start_editor.py

@@ -8,10 +8,35 @@ from je_editor.pyside_ui.main_ui.main_editor import EditorMain
 
 
 def start_editor(debug_mode: bool = False) -> None:
+    """
+    功能說明 (Function Description):
+    啟動編輯器主程式，建立 QApplication 實例，套用主題，並顯示主視窗。
+    Start the main editor application, create QApplication instance, apply theme, and show main window.
+
+    :param debug_mode: 是否啟用除錯模式 / whether to enable debug mode
+    """
+
+    # 嘗試取得現有的 QCoreApplication 實例
+    # Try to get an existing QCoreApplication instance
     new_editor = QCoreApplication.instance()
+
+    # 如果沒有現有實例，建立新的 QApplication
+    # If no instance exists, create a new QApplication
     if new_editor is None:
         new_editor = QApplication(sys.argv)
+
+    # 建立主視窗，傳入 debug_mode
+    # Create the main editor window, passing debug_mode
     window = EditorMain(debug_mode)
+
+    # 套用 qt-material 主題 (dark amber)
+    # Apply qt-material theme (dark amber)
     apply_stylesheet(new_editor, theme='dark_amber.xml')
+
+    # 最大化顯示主視窗
+    # Show the main window maximized
     window.showMaximized()
-    sys.exit(new_editor.exec())
+
+    # 啟動事件迴圈，並在結束時退出程式
+    # Start the event loop and exit the program when it ends
+    sys.exit(new_editor.exec())

je_editor/utils/encodings/python_encodings.py

@@ -1,99 +1,102 @@
+# 定義一個 Python 支援的文字編碼清單
+# Define a list of text encodings supported by Python
+
 python_encodings_list = [
-    'ascii',
-    'big5',
-    'big5hkscs',
-    'cp037',
-    'cp273',
-    'cp424',
-    'cp437',
-    'cp500',
-    'cp720',
-    'cp737',
-    'cp775',
-    'cp850',
-    'cp852',
-    'cp855',
-    'cp856',
-    'cp857',
-    'cp858',
-    'cp860',
-    'cp861',
-    'cp862',
-    'cp863',
-    'cp864',
-    'cp865',
-    'cp866',
-    'cp869',
-    'cp874',
-    'cp875',
-    'cp932',
-    'cp949',
-    'cp950',
-    'cp1006',
-    'cp1026',
-    'cp1125',
-    'cp1140',
-    'cp1250',
-    'cp1251',
-    'cp1252',
-    'cp1253',
-    'cp1254',
-    'cp1255',
-    'cp1256',
-    'cp1257',
-    'cp1258',
-    'euc_jp',
-    'euc_jis_2004',
-    'euc_jisx0213',
-    'euc_kr',
-    'gb2312',
-    'gbk',
-    'gb18030',
-    'hz',
-    'iso2022_jp',
-    'iso2022_jp_1',
-    'iso2022_jp_2',
-    'iso2022_jp_2004',
-    'iso2022_jp_3',
-    'iso2022_jp_ext',
-    'iso2022_kr',
-    'latin_1',
-    'iso8859_2',
-    'iso8859_3',
-    'iso8859_4',
-    'iso8859_5',
-    'iso8859_6',
-    'iso8859_7',
-    'iso8859_8',
-    'iso8859_9',
-    'iso8859_10',
-    'iso8859_11',
-    'iso8859_13',
-    'iso8859_14',
-    'iso8859_15',
-    'iso8859_16',
-    'johab',
-    'koi8_r',
-    'koi8_t',
-    'koi8_u',
-    'kz1048',
-    'mac_cyrillic',
-    'mac_greek',
-    'mac_iceland',
-    'mac_latin2',
-    'mac_roman',
-    'mac_turkish',
-    'ptcp154',
-    'shift_jis',
-    'shift_jis_2004',
-    'shift_jisx0213',
-    'utf_32',
-    'utf_32_be',
-    'utf_32_le',
-    'utf_16',
-    'utf_16_be',
-    'utf_16_le',
-    'utf_7',
-    'utf_8',
-    'utf_8_sig'
-]
+    'ascii',        # ASCII 編碼 (基本的英文字符集, 7-bit) / Basic English character set
+    'big5',         # Big5 編碼 (繁體中文常用, 台灣/香港) / Traditional Chinese encoding (Taiwan/HK)
+    'big5hkscs',    # Big5-HKSCS (香港增補字集) / Big5 with Hong Kong Supplementary Character Set
+    'cp037',        # IBM EBCDIC US/Canada / IBM mainframe encoding
+    'cp273',        # IBM EBCDIC Germany / 德國 EBCDIC 編碼
+    'cp424',        # IBM EBCDIC Hebrew / 希伯來文編碼
+    'cp437',        # 原始 IBM PC 編碼 (DOS Latin US) / Original IBM PC encoding
+    'cp500',        # IBM EBCDIC International / 國際版 EBCDIC
+    'cp720',        # 阿拉伯文 (DOS) / Arabic (DOS)
+    'cp737',        # 希臘文 (DOS) / Greek (DOS)
+    'cp775',        # 波羅的海語系 (DOS) / Baltic languages (DOS)
+    'cp850',        # 西歐語系 (DOS) / Western Europe (DOS)
+    'cp852',        # 中歐語系 (DOS) / Central Europe (DOS)
+    'cp855',        # 西里爾字母 (DOS) / Cyrillic (DOS)
+    'cp856',        # 希伯來文 (DOS) / Hebrew (DOS)
+    'cp857',        # 土耳其文 (DOS) / Turkish (DOS)
+    'cp858',        # 西歐語系 (含歐元符號) / Western Europe with Euro sign
+    'cp860',        # 葡萄牙文 (DOS) / Portuguese (DOS)
+    'cp861',        # 冰島文 (DOS) / Icelandic (DOS)
+    'cp862',        # 希伯來文 (DOS) / Hebrew (DOS)
+    'cp863',        # 加拿大法文 (DOS) / Canadian French (DOS)
+    'cp864',        # 阿拉伯文 (DOS) / Arabic (DOS)
+    'cp865',        # 北歐語系 (DOS) / Nordic languages (DOS)
+    'cp866',        # 俄文 (DOS) / Russian (DOS)
+    'cp869',        # 希臘文 (DOS) / Greek (DOS)
+    'cp874',        # 泰文 (Windows) / Thai (Windows)
+    'cp875',        # IBM EBCDIC Greek / 希臘文 EBCDIC
+    'cp932',        # 日文 Shift_JIS (Windows) / Japanese Shift_JIS (Windows)
+    'cp949',        # 韓文 (Windows) / Korean (Windows)
+    'cp950',        # 繁體中文 Big5 (Windows) / Traditional Chinese Big5 (Windows)
+    'cp1006',       # 烏爾都文 (Urdu) / Urdu
+    'cp1026',       # IBM EBCDIC Turkish / 土耳其文 EBCDIC
+    'cp1125',       # 烏克蘭文 (DOS) / Ukrainian (DOS)
+    'cp1140',       # EBCDIC with Euro / EBCDIC 含歐元符號
+    'cp1250',       # 中歐語系 (Windows) / Central Europe (Windows)
+    'cp1251',       # 西里爾字母 (Windows) / Cyrillic (Windows)
+    'cp1252',       # 西歐語系 (Windows, 常見) / Western Europe (Windows, very common)
+    'cp1253',       # 希臘文 (Windows) / Greek (Windows)
+    'cp1254',       # 土耳其文 (Windows) / Turkish (Windows)
+    'cp1255',       # 希伯來文 (Windows) / Hebrew (Windows)
+    'cp1256',       # 阿拉伯文 (Windows) / Arabic (Windows)
+    'cp1257',       # 波羅的海語系 (Windows) / Baltic (Windows)
+    'cp1258',       # 越南文 (Windows) / Vietnamese (Windows)
+    'euc_jp',       # 日文 EUC 編碼 / Japanese EUC encoding
+    'euc_jis_2004', # 日文 EUC (JIS 2004) / Japanese EUC (JIS 2004)
+    'euc_jisx0213', # 日文 EUC (JIS X 0213) / Japanese EUC (JIS X 0213)
+    'euc_kr',       # 韓文 EUC 編碼 / Korean EUC encoding
+    'gb2312',       # 簡體中文 (舊標準) / Simplified Chinese (older standard)
+    'gbk',          # 簡體中文 (擴展) / Simplified Chinese (extended)
+    'gb18030',      # 簡體中文 (最新國標) / Simplified Chinese (latest national standard)
+    'hz',           # HZ-GB-2312 (簡體中文, 郵件常用) / Simplified Chinese (email encoding)
+    'iso2022_jp',   # 日文 ISO-2022-JP / Japanese ISO-2022-JP
+    'iso2022_jp_1', # 日文 ISO-2022-JP-1 / Japanese ISO-2022-JP-1
+    'iso2022_jp_2', # 日文 ISO-2022-JP-2 / Japanese ISO-2022-JP-2
+    'iso2022_jp_2004', # 日文 ISO-2022-JP-2004 / Japanese ISO-2022-JP-2004
+    'iso2022_jp_3', # 日文 ISO-2022-JP-3 / Japanese ISO-2022-JP-3
+    'iso2022_jp_ext', # 日文 ISO-2022-JP-EXT / Japanese ISO-2022-JP-EXT
+    'iso2022_kr',   # 韓文 ISO-2022-KR / Korean ISO-2022-KR
+    'latin_1',      # ISO-8859-1 (西歐語系, 常見) / Western Europe (very common)
+    'iso8859_2',    # 中歐語系 / Central Europe
+    'iso8859_3',    # 南歐語系 / South Europe
+    'iso8859_4',    # 北歐語系 / North Europe
+    'iso8859_5',    # 西里爾字母 / Cyrillic
+    'iso8859_6',    # 阿拉伯文 / Arabic
+    'iso8859_7',    # 希臘文 / Greek
+    'iso8859_8',    # 希伯來文 / Hebrew
+    'iso8859_9',    # 土耳其文 / Turkish
+    'iso8859_10',   # 北歐語系 / Nordic
+    'iso8859_11',   # 泰文 / Thai
+    'iso8859_13',   # 波羅的海語系 / Baltic
+    'iso8859_14',   # 凱爾特語 / Celtic
+    'iso8859_15',   # 西歐語系 (含歐元) / Western Europe with Euro
+    'iso8859_16',   # 東歐語系 / Eastern Europe
+    'johab',        # 韓文 Johab 編碼 / Korean Johab encoding
+    'koi8_r',       # 俄文 KOI8-R / Russian KOI8-R
+    'koi8_t',       # 塔吉克文 KOI8-T / Tajik KOI8-T
+    'koi8_u',       # 烏克蘭文 KOI8-U / Ukrainian KOI8-U
+    'kz1048',       # 哈薩克文 / Kazakh
+    'mac_cyrillic', # Mac OS 西里爾字母 / Mac Cyrillic
+    'mac_greek',    # Mac OS 希臘文 / Mac Greek
+    'mac_iceland',  # Mac OS 冰島文 / Mac Icelandic
+    'mac_latin2',   # Mac OS 中歐語系 / Mac Central Europe
+    'mac_roman',    # Mac OS 西歐語系 / Mac Roman
+    'mac_turkish',  # Mac OS 土耳其文 / Mac Turkish
+    'ptcp154',      # 中亞語系 (西里爾字母) / Central Asian Cyrillic
+    'shift_jis',  # 日文 Shift JIS 編碼 (常見於 Windows 與網頁) / Japanese Shift JIS encoding (commonly used in Windows & web)
+    'shift_jis_2004',  # 日文 Shift JIS (JIS 2004 標準) / Japanese Shift JIS (JIS 2004 standard)
+    'shift_jisx0213',  # 日文 Shift JIS (JIS X 0213 擴展) / Japanese Shift JIS (JIS X 0213 extension)
+    'utf_32',  # UTF-32 (依平台大小端序, 4 bytes per char) / UTF-32 (platform-dependent endianness, 4 bytes per char)
+    'utf_32_be',  # UTF-32 Big Endian / UTF-32 大端序
+    'utf_32_le',  # UTF-32 Little Endian / UTF-32 小端序
+    'utf_16',  # UTF-16 (依平台大小端序, 2 or 4 bytes per char) / UTF-16 (platform-dependent endianness)
+    'utf_16_be',  # UTF-16 Big Endian / UTF-16 大端序
+    'utf_16_le',  # UTF-16 Little Endian / UTF-16 小端序
+    'utf_7',  # UTF-7 (為電子郵件設計, 已過時) / UTF-7 (designed for email, obsolete)
+    'utf_8',  # UTF-8 (最常用, 網頁與跨平台標準) / UTF-8 (most common, web & cross-platform standard)
+    'utf_8_sig'  # UTF-8 with BOM (Byte Order Mark) / UTF-8 含 BOM 標記
+]