El multilingüismo no se termina con añadir un código de idioma. El cambio en el sitio público, la traducción del contenido, los textos de la interfaz y el glosario son independientes entre sí; lo más fácil de confundir es qué controlan exactamente «Traducción con un clic» y «Autocompletar». Este artículo lo explica según el flujo real del panel de administración.

KingCMS X1 前台首页示例
Tras activar idiomas extranjeros, aparece un botón de cambio de idioma en la cabecera del sitio público y el contenido se lee en el idioma seleccionado.

1. Activación de idiomas y cambio en el sitio público

En «Configuración → Contenido y medios → Multilingüe» (/admin/settings/content/i18n), rellena «Idiomas activados» separados por comas inglesas, por ejemplo zh-CN,en,ja. Debe incluir zh-CN; de lo contrario, no se puede guardar. El código debe empezar por 2–3 letras y puede llevar un sufijo de región; los duplicados se eliminan automáticamente. Si solo se activa un idioma, el sitio público no muestra el botón de cambio.

El formulario de cambio se envía a POST /locale, establece una cookie kc_lang válida durante un año y vuelve a la página actual sin cambiar la ruta. El orden de determinación del idioma es: ?lang= en la dirección, la cookie y el idioma predeterminado. El sistema no lee el Accept-Language del navegador, así que la primera visita se muestra en chino de forma predeterminada; para abrir directamente una página en inglés, usa /about?lang=en, lo que también actualiza la cookie.

2. Qué campos se pueden traducir

ContenidoCampos traducibles
ArtículosTítulo, resumen, cuerpo, título SEO, descripción SEO
CategoríasNombre, título SEO, descripción SEO
Páginas individualesNombre, cuerpo, título SEO, descripción SEO

El nombre de la ruta y las palabras clave SEO no participan en la traducción; todos los idiomas comparten la misma dirección. La traducción solo se guarda al guardar el formulario principal; si sales sin guardar, no se conserva. Si borras la traducción y guardas, se elimina la traducción de ese campo y el sitio público vuelve al texto original en chino.

KingCMS X1 AI 助手示例
La traducción con un clic utiliza el servicio de IA configurado en el panel de administración; si falla, no borra el contenido existente.

3. Límites de la traducción con un clic

  1. Primero rellena y guarda el chino; después, haz clic en «Traducir». El sistema envía el chino a la IA de una vez y traduce al mismo tiempo todos los idiomas extranjeros activados.
  2. Sobrescribe el contenido actual del área de traducción, incluidas las traducciones editadas manualmente.
  3. El resultado de la traducción no se guarda automáticamente; hay que hacer clic de nuevo en «Guardar».
  4. La traducción del cuerpo limpia el HTML según las reglas del cuerpo.
  5. Si el texto original en chino cambió después de la última vez que se guardó la traducción, al lado se muestra «Chino modificado»; al guardar, prevalece el contenido actual del campo de entrada.
  6. Si no hay un servicio de IA configurado o la llamada falla, solo se muestra un error; el contenido existente no se borra.

El nombre del sitio y el título/descripción para compartir también tienen un área de traducción por idioma, pero la «Traducción con un clic» de ahí solo traduce el idioma actual y solo rellena las traducciones que aún están vacías, sin sobrescribir el contenido ya rellenado. El META predeterminado solo existe en una versión y no se divide por idioma.

4. «Actualizar traducción» y «Autocompletar» no son lo mismo

Al guardar un artículo, si marcas «Actualizar traducción», se generan tareas de traducción para todos los idiomas activados; solo se traducen los campos con contenido y los campos vacíos no generan traducción. En cambio, el interruptor «Autocompletar traducción» de la página «Idiomas y países» solo afecta a los textos de la interfaz del sistema y a la ayuda, no al contenido publicado; esta es la confusión más habitual.

5. Retorno al original, textos de interfaz y glosario

Los campos sin traducción muestran automáticamente el texto original en chino; se trata de un retorno campo por campo, no de toda la página. Los textos fijos como la navegación y los botones del sitio público se mantienen en «Textos de interfaz» (/admin/ui-strings); al hacer clic en «Traducir» solo se rellenan las celdas vacías. Las traducciones fijas de nombres propios se guardan en el «Glosario de traducción» (/admin/glossary); dentro de un mismo idioma, el término original en chino no puede repetirse, y la IA prioriza las traducciones del glosario al traducir.

6. Errores habituales

  • Cambiaste el idioma pero el contenido no cambia: primero comprueba si ese campo tiene traducción; si falta, se vuelve al chino.
  • Acabas de traducir y al actualizar vuelve a aparecer en chino: el resultado de la traducción no se guardó.
  • Modificaste el chino y la traducción no cambia: revisa la marca «Chino modificado», vuelve a traducir o edítala a mano.
  • Desactivaste un idioma, ¿se perdió la traducción?: no, sigue ahí cuando lo vuelvas a activar.
  • Quieres usar «Autocompletar» para traducir artículos: no sirve; ese interruptor solo afecta a la interfaz y a la ayuda.

Resumen

El multilingüismo debe entenderse por partes: el interruptor de idiomas determina si el sitio público puede cambiar de idioma, el área de traducción determina qué muestra el contenido, el servicio de IA determina si la traducción con un clic está disponible y el glosario determina cómo se traducen los nombres propios. Si separas la «traducción de contenido» del «autocompletado de interfaz», en general no caerás en errores.