Introducción al Plugin ConvertToUTF8

El plugin ConvertToUTF8 está diseñado para Sublime Text 2 y 3, permitiendo editar y guardar archivos con codificacionse como GBK, BIG5, EUC-KR, EUC-JP, Shift_JIS y más de 20 formatos comunes en idiomas asiáticos. Este complemento identifica automáticamente la codificación de los archivos y realiza conversiones fluidas para evitar caracteres malformados.

Instalación del Plugin

Existen dos métodos principales para instalar ConvertToUTF8 en Sublime Text:

Instalación mediante Package Control

1. Abre la paleta de comandos con Ctrl+Shift+P en Windows/Linux o Cmd+Shift+P en Mac.
2. Escribe "Package Control: Install Package" y confirma.
3. Busca "ConvertToUTF8" en la lista de paquetes e instálalo.
4. Reinicia Sublime Text para activar el plugin.

Instalación Manual

En entornos sin acceso a Package Control, puedes clonar el repositorio desde https://gitcode.com/gh_mirrors/co/ConvertToUTF8 y copiar la carpeta ConvertToUTF8 al directorio Packages de Sublime Text. Para localizar este directorio, utiliza el menú Preferences > Browse Packages.

Configuración Esencial

Las opciones de ConvertToUTF8 se gestionan en el archivo ConvertToUTF8.sublime-settings. Configura parámetros clave como:

• convert_on_load: Convierte automáticamente archivos a UTF-8 al abrirlos (valor por defecto: true).
• convert_on_save: Restaura la codificación original al guardar (valor por defecto: true).
• confidence: Umbral de confianza para la detección de codificación (valor por defecto: 0.95).
• max_detect_lines: Número máximo de líneas analizadas para detección (valor por defecto: 600).
• max_cache_size: Tamaño del caché para codificaciones (valor por defecto: 100).

Para preservar los ajustes personalizados, guarda los cambios en el archivo de usuario correspondiente, evitando que se sobrescriban durante actualizaciones.

Técnicas para Optimizar el Manejo de Codificaciones

Si la detección automática no es precisa, asigna manualmente la codificación:

1. Navega a File > Set File Encoding to.
2. Selecciona el formato correcto; el plugin aplicará la conversión de inmediato.

Para proyectos con múltiples codificaciones, define configuraciones específicas en el archivo .sublime-project:

{
  "settings": {
    "ConvertToUTF8": {
      "encoding_list": [
        ["Chino Simplificado (GBK)", "GBK"],
        ["UTF-8", "UTF-8"]
      ]
    }
  }
}

En caso de problemas de reconocimiento, limpia la caché ejecutando "ConvertToUTF8: Clear Cache" desde la paleta de comandos.

Resolución de Problemas Comunes

El plugin no funciona tras la instalación

Verifica que la carpeta ConvertToUTF8 exista en el directorio Packages y que su nombre sea exacto. Reinicia Sublime Text si es necesario.

Errores de codificación persisten en Linux/Mac

Instala plugins adicionales como Codecs26 para Sublime Text 2 o Codecs33 para Sublime Text 3.

Problemas de visualización en Windows 7

Añade "dpi_scale": 1 a la configuración de usuario de Sublime Text.

Rendimiento lento con archivos grandes

Ajusta max_detect_lines a un valor entre 300 y 500, desactiva show_encoding_status y limpia la caché periódicamente.

Prácticas Recomendadas

Establece UTF-8 como codificación estándar en proyectos colaborativos para minimizar conflictos. Ordena la lista encoding_list por frecuencia de uso para mejorar la eficiencia de detección:

"encoding_list": [
  ["UTF-8", "UTF-8"],
  ["Chino Simplificado (GBK)", "GBK"],
  ["Chino Tradicional (BIG5)", "BIG5"],
  ["Coreano (EUC-KR)", "EUC-KR"],
  ["Japonés (EUC-JP)", "EUC-JP"]
]

Respalda el archivo ConvertToUTF8.sublime-settings en un sistema de control de versiones para restaurar configuraciones rápidamente.

Funcionamiento Técnico de ConvertToUTF8

El plugin utiliza el motor de detección chardet para analizar codificaciones mediante:

• Estadísticas de frecuencia de bytes.
• Comparación con modelos lingüísticos integrados.
• Validación de secuencias de bytes con máquinas de estados.

La lógica principal reside en ConvertToUTF8.py, mientras que los algoritmos de detección están implementados en el directorio chardet/.

Comparación con Soporte Nativo

Funcionalidades Avanzadas

Para convertir múltiples archivos, combina ConvertToUTF8 con la función "Find in Files" de Sublime Text:

1. Abre una carpeta con los archivos objetivo.
2. Usa "Find in Files" para buscar contenido específico.
3. En los resultados, abre cada archivo y aplica la conversión.

Habilita show_encoding_status para monitorizar la codificación actual en la barra de estado. Para desactivar temporalmente la conversión, establece convert_on_load en false y utiliza el menú para seleccionar codificaciones manualmente.

Errores Frecuentes y Soluciones

Archivos corruptos tras guardar

Esto ocurre por errores durante la conversión. Desactiva convert_on_save, guarda una copia de seguridad y realiza una conversión manual a UTF-8.

Conflictos con otros plugins

Deshabilita otros plugins relacionados con codificaciones y pruebas la compatibilidad de manera incremental.

Alto consumo de memoria

Reduce max_cache_size, limpia la caché regularmente y reniicia Sublime Text para liberar recursos.