Sublime Plugin : Convert?To?UTF8
標簽（空格分隔）： SublimePlugin
說明
通過本插件，您可以編輯并保存目前編碼不被 Sublime Text 支持的文件，特別是中日韓用戶使用的 GB2312，GBK，BIG5，EUC-KR，EUC-JP 等。ConvertToUTF8 同時支持 Sublime Text 2 和 3。
注意
** Windows 7（Sublime Text 3）：當設置Windows自定義文本大小（DPI）超過100%時，文件名可能無法正確顯示，請嘗試在Sublime Text 3的用戶設置中添加"dpi_scale": 1。
** Linux（Sublime Text 2 & 3）及OSX（Sublime Text 3）：你需要安裝一個額外插件以便ConvertToUTF8能正常工作：Codecs26（針對 Sublime Text 2）或 Codecs33（針對 Sublime Text 3）。
安裝
推薦使用 Package Control 查找 ConvertToUTF8 進行自動下載安裝與更新。
如需手工安裝，請將本項目打包下載并解壓，將解壓后的文件夾名修改為 ConvertToUTF8 ，然后將此文件夾移動到 Sublime Text 的 Packages 文件夾下（可通過 Sublime Text 菜單中的 Preferences > Browse Packages 找到 Packages 文件夾）。
您的文件夾應該看起來是這樣的：
設置
請查看 ConvertToUTF8.sublime-settings 文件獲取詳細信息。為防止更新插件時被覆蓋，請將個人設置保存到 User 目錄中名為 ConvertToUTF8.sublime-settings 文件中。您可以在 .sublime-project 文件（可通過 Project > Edit Project 打開）中指定項目專屬設置（除 encoding_list 和 max_cache_size 外）。
- encoding_list：檢測失敗時顯示的編碼列表
- max_cache_size：最大編碼緩存數量，0 表示不緩存（默認為 100）
- max_detect_lines：最大檢測行數，0 表示不限制（默認為 600）
- preview_action：預覽文件時是否將其內容轉換為 UTF-8（默認為 false）
- default_encoding_on_create：指定新建文件的默認編碼（如 GBK），空值表示使用 Sublime Text 的 default_encoding 設置（默認為 ""）
- convert_on_load：文件裝載時是否將其內容轉換成 UTF-8（默認為 true）
- convert_on_save：文件保存時是否將其內容轉換成原有（或指定）編碼（默認為 true）
- convert_on_find：將 Find Results 窗口里的內容轉換成 UTF-8（默認為 false）
- lazy_reload：將文件保存到臨時位置，并在切換窗口或標簽時在后臺自動重載（默認為 false）
- confidence：最低可信率，檢測時超過這個值將觸發自動轉換（默認為0.95）
使用說明
多數情況下，本插件將自動對處理編碼相關的事項。
您也可以通過 File > Set File Encoding to 菜單對文件編碼進行手工轉換。例如，您可以打開一個 UTF-8 編碼的文件，指定保存為 GBK，反之亦然。
注意：
- 如果 convert_on_save 被設置為
false，文件不會被保存成指定編碼 - 在文件編碼檢測過程完成前請勿編輯文件
- 若檢測結果不準確，請嘗試增大 max_detect_lines 的值或手工指定編碼
- 由于 API 限制，在 lazy_reload 設置為
true時，保存文件后立即退出 Sublime Text 將造成文件被保存為 UTF-8，正確的內容將在下次 Sublime Text 打開時重載
常見問題
-
問：安裝后無法工作，要如何修復？
答：請嘗試以下步驟：
- 重啟 Sublime Text
- 請確認插件目錄名為 ConvertToUTF8（如果是通過 Package Control 安裝的可略過此步驟）
- 參見上述“注意”條目
- 禁用其他編碼相關的插件
- 聯系我
-
問：這個插件支持哪些編碼？
答：所有 Python 支持的編碼 都可以，其他編碼如 EUC-TW 將不被支持。
-
問：為何有時重新激活窗口，里面的內容會變亂碼？
答：此問題是由重新載入引起的，且已修復，請更新 ConvertToUTF8 插件到最新版本。
-
問：為什么重新激活窗口時，ST2 問我文件“已經被修改。是否要重新載入？”
答：原因與上一條相同。如果您有未保存的修改，請選擇“取消”。
-
問：在保存文件時，Sublime Text 為什么提示將文件保存為 UTF-8？
答：沒有關系，本插件會自動將文件內容保存為原始編碼。
-
問：我的文件被保存為UTF-8，而且變成了亂碼，要如何恢復？
答：請打開這個文件，并確認它的編碼是UTF-8，然后選擇菜單項目 File > Save with Encoding > Western (Windows 1252)，關閉再重新打開該文件即可。
聯系我
請發送您的問題或建議給我：sunlxy (at) yahoo.com 或 http://weibo.com/seanliang
