ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Convert​To​UTF8

by seanliang ST2/ST3 Top 25

A Sublime Text 2 & 3 plugin for editing and saving files encoded in GBK, BIG5, EUC-KR, EUC-JP, Shift_JIS, etc.

Details

  • 1.2.13
  • github.​com
  • github.​com
  • 6 months ago
  • 58 minutes ago
  • 7 years ago

Installs

  • Total 921K
  • Win 667K
  • OS X 186K
  • Linux 67K
Sep 19 Sep 18 Sep 17 Sep 16 Sep 15 Sep 14 Sep 13 Sep 12 Sep 11 Sep 10 Sep 9 Sep 8 Sep 7 Sep 6 Sep 5 Sep 4 Sep 3 Sep 2 Sep 1 Aug 31 Aug 30 Aug 29 Aug 28 Aug 27 Aug 26 Aug 25 Aug 24 Aug 23 Aug 22 Aug 21 Aug 20 Aug 19 Aug 18 Aug 17 Aug 16 Aug 15 Aug 14 Aug 13 Aug 12 Aug 11 Aug 10 Aug 9 Aug 8 Aug 7 Aug 6 Aug 5
Windows 6 542 560 490 194 207 216 386 457 546 514 295 287 545 532 477 527 597 301 250 427 449 436 457 438 237 250 339 414 456 463 485 230 257 428 400 433 427 478 261 250 396 451 495 467 498
OS X 1 111 128 109 64 42 59 95 100 138 113 53 67 104 106 103 124 117 66 67 98 106 99 107 108 69 64 101 123 104 89 99 50 62 85 108 119 104 123 54 68 114 136 110 117 129
Linux 0 29 27 24 13 13 19 18 18 38 26 14 18 20 23 32 27 24 23 15 21 22 25 21 31 10 18 25 29 28 30 29 13 11 19 18 14 26 19 15 19 27 19 34 17 33

Readme

Source
raw.​githubusercontent.​com

Description (中文说明见README.zh_CN.md)

With this plugin, you can edit and save the files which encodings are not supported by Sublime Text currently, especially for those used by CJK users, such as GB2312, GBK, BIG5, EUC-KR, EUC-JP, etc. ConvertToUTF8 supports both Sublime Text 2 and 3.

ConvertToUTF8

If you want to support this plugin, you can donate via Alipay or WeChat. Thanks! :)

Alipay QR code WeChat QR code

Note

** Windows 7 (Sublime Text 3): When Windows DPI Scaling is set to a value higher than 100%, the file name might not be displayed correctly, please try to add "dpi_scale": 1 to User Settings of Sublime Text.

** Linux (Sublime Text 2 & 3) and OSX (Sublime Text 3): You will need to install an extra plugin to make ConvertToUTF8 work properly: Codecs26 for Sublime Text 2 or Codecs33 for Sublime Text 3.

Installation

Using Package Control to find, install and upgrade ConvertToUTF8 is the recommended method to install this plug-in.

Otherwise, you can download this repository as a zip file, unzip it, and rename the new folder to ConvertToUTF8, then move this folder to Packages folder of Sublime Text (You can find the Packages folder by clicking “Preferences > Browse Packages” menu entry in Sublime Text).

Your folder hierarchy should look like this:

Folder Hierarchy

Configuration

Please check ConvertToUTF8.sublime-settings file for details. You should save your personal settings in a file named “ConvertToUTF8.sublime-settings” under “User” folder. You can set project-specific settings (except encoding_list and max_cache_size) in the .sublime-project file which can be opened via “Project > Edit Project” menu.

  • encoding_list: encoding selection list when detection is failed
  • reset_diff_markers: reset diff markers after converting (default: true)
  • max_cache_size: maximum encoding cache size, 0 means no cache (default: 100)
  • max_detect_lines: maximum detection lines, 0 means unlimited (default: 600)
  • preview_action: convert the file's content to UTF-8 when previewing it (default: false)
  • default_encoding_on_create: specific the default encoding for newly created file (such as “GBK”), empty value means using sublime text's “default_encoding” setting (default: “”)
  • convert_on_load: convert the file's content to UTF-8 when it is loaded (default: true)
  • convert_on_save: convert the file's content from UTF-8 to its original (or specific) encoding when it is saved (default: true)
  • convert_on_find: convert the text in Find Results view to UTF-8 (default: false)
  • lazy_reload: save file to a temporary location, and reload it in background when switching to other windows or tabs (default: false)
  • confidence: the minimum confidence rate which the converting will be performed automatic. (default: 0.95)

Usage

In most cases, this plug-in will take care of encoding issues automatically.

You can also use the “File > Set File Encoding to” menu entry to transform between different encodings. For example, you can open a UTF-8 file, and save it to GBK, and vice versa.

Note: * if convert_on_save is set to false, the file will NEVER be saved to the selected encoding * please do not edit the file before the encoding detection process is finished * please try either increasing the value of max_detect_lines or set the encoding manually if the detection result is not accurate * due to limitation of API, when lazy_reload is set to true, quit Sublime Text immediately after saving a file will cause the file to be saved as UTF-8, the correct content will be reload next time Sublime Text starts

Q & A

  • Q: It is not working after installation, how do I fix it?

A: Please try the following steps: 1. Restart Sublime Text 2. Make sure the plug-in folder is named “ConvertToUTF8” (skip this step if you install via “Package Control”) 3. See Note section above 4. Disable other encoding related plug-ins 5. Contact me

  • Q: Which encodings are supported?

A: Any encoding supported by Python will be fine, other encodings like EUC-TW will not be supported.

  • Q: Why does the content become a mess when the window is re-activated?

A: This is caused by reloading and has been fixed, please update your ConvertToUTF8 to latest version.

  • Q: Why does ST2 ask me that file “Has changed on disk. Do you want to reload it?” when the window is re-activated.

A: Same reason as above. Please choose “Cancel” if you have unsaved changes to the file.

  • Q: When saving the file, Sublime Text tells me the file is saved as UTF-8, why?

A: Don't worry, the plug-in will convert your file to original encoding.

  • Q: My file was saved as UTF-8 and it's in a mess, how can I recover it?

A: Please open the file and make sure its encoding is UTF-8, then choose the menu entry “File > Save with Encoding > Western (Windows 1252)”, close and reopen this file.

Contact me

Please send me your questions or suggestions: sunlxy (at) yahoo.com or http://weibo.com/seanliang