Idiomas multilingües del sitio

ArtInStack puede publicar su sitio público en más de un idioma. Usted elige un idioma principal (las URLs predeterminadas sin prefijo) y locales extra opcionales. Los visitantes cambian con un Language Switcher en el encabezado o el pie. Páginas y entradas tienen controles dedicados de Languages para Generate, Preview y Publish. Portfolios, productos y pies de foto siguen los mismos locales publicados; si falta una traducción, los visitantes siguen viendo el cromado del idioma correcto y hacen soft-fall al texto principal.

Publicar locales extra requiere un plan con multilingual sites habilitado. Solo el idioma principal está disponible sin esa restricción.

Requisitos previos

Dashboard → Settings → General → Site Languages

Plan: multilingual sites habilitado si necesita más que el locale principal

Dashboard → Settings → Integrations → Translation — obligatorio antes de Generate. Puede configurar locales y el selector primero; no puede Generate extras de página o entrada sin una clave API del proveedor.

Pasos de implementación

1. Elegir idioma principal y locales publicados

1. Abra Settings → General.
2. En Site Languages, configure Primary language (las páginas nuevas y el locale público predeterminado lo usan).
3. En Published locales, añada cada idioma que quiera en el selector público. El principal siempre se incluye.
4. Guarde la configuración.

Sin extras, el sitio permanece monolingüe en URLs sin prefijo (por ejemplo /about). Con extras como el francés, los visitantes pueden abrir /fr/about, /fr/blog/…, /fr/portfolio/… y /fr/photo/….

2. Elegir un proveedor de traducción

Abra Settings → Integrations → Translation. Elija un proveedor, pegue su propia clave API (ArtInStack la almacena cifrada y nunca la vuelve a mostrar tras guardar) y guarde la configuración. Manual only no basta para Generate—necesita DeepL, Gemini u OpenAI.

Proveedor	Ideal para	Cómo obtener una clave	Límites y notas
DeepL (recomendado cuando esté disponible para su par de idiomas)	Máxima calidad en muchos idiomas europeos	Cree una cuenta API en DeepL API y copie la clave de autenticación	Los planes y cuotas de caracteres cambian—consulte los planes API actuales de DeepL. Las nuevas asignaciones Developer suelen ser un presupuesto de caracteres de una sola vez (comúnmente unos 1 millón de caracteres en total, no mensuales); los planes de pago tipo Growth añaden volumen recurrente. Confirme los límites en vivo en su consola DeepL antes de un Generate grande del sitio.
Google Gemini	Coste bajo o nulo para empezar; adecuado para borradores que revisará	Cree una clave API en Google AI Studio	Usa un modelo Gemini rápido y eficiente en coste en ArtInStack (no los modelos «pro» más pesados). La calidad puede quedar detrás de DeepL en algunos pares—siempre Preview antes de Publish. Se aplican las cuotas gratuitas de Google; consulte los límites actuales de AI Studio / Gemini API.
OpenAI	Ya tiene una cuenta OpenAI; respaldo flexible	Cree una clave en OpenAI API keys	Usa un modelo de chat ligero adecuado para textos del sitio. Se factura a su cuenta OpenAI; configure límites de uso en su panel.

Consejo práctico: prefiera DeepL para Generate público de páginas y entradas cuando sus locales estén soportados y tenga cuota. Use Gemini para probar lo multilingüe a bajo coste o cuando DeepL no encaje. Mantenga OpenAI como alternativa si ya factura allí. Tras Generate, siempre Preview—el borrador automático es un punto de partida, no una garantía de publicación.

El uso de caracteres cubre Generate de página/entrada y los rellenos automáticos de entidades (nombres de portfolio, títulos de producto, pies de foto y similares) cuando se publican extras. Los sitios grandes consumen cuota más rápido—Generate primero las páginas importantes.

3. Añadir el Language Switcher

1. Abra Settings → Header & Footer → Edit en su encabezado (o pie) predeterminado.
2. Desde Header Elements o Footer Elements, suelte Language Switcher.
3. Guarde la plantilla.

El selector lista sus Published locales. Permanece oculto cuando solo hay un locale publicado. Detalles: Encabezado, pie y navegación.

4. Traducir una página (Generate → Preview → Publish)

1. Abra Pages → Edit la página.
2. Siga editando el texto principal en el lienzo del Page Editor (Publish del principal sigue enviando ese locale).
3. Abra Page Settings → Languages.
4. Para cada locale extra: Generate un borrador (proveedor + clave ya configurados en Integrations → Translation), Preview y luego Publish cuando esté listo.
5. Unpublish un extra si necesita sacar ese locale fuera de línea sin borrar el principal.

Los cuerpos de página extra no publicados devuelven 404 en esa URL de locale (sin cuerpo en inglés silencioso bajo /fr/…). El meta título y la descripción hacen soft-fall al principal cuando los campos SEO del locale están vacíos.

El mismo patrón en Posts: abra la entrada → panel Languages → Generate / Preview / Publish para extras (/blog/… principal, /{locale}/blog/… para extras).

5. Mantener el resto del contenido sincronizado (soft-fall)

Escriba portfolios, productos, categorías y pies de foto en el idioma principal. Cuando se publican extras y hay claves de Translation configuradas, las actualizaciones pueden rellenar filas de traducción automáticamente. Hasta que exista una fila, los listados públicos y las páginas de foto muestran el texto principal con el cromado del locale del visitante (diseño, botones, migas de pan).

No necesita una lista separada de «traducir todo» antes de publicar con extras—publique primero las páginas y entradas que importan y complete el resto con el tiempo.

Qué verá

• El selector ofrece cada locale publicado (endonimos).
• Las URLs principales permanecen sin prefijo; los extras usan /{locale}/….
• Los extras de página/entrada publicados renderizan HTML traducido; los extras no publicados dan 404.
• Galerías, productos y fotos mantienen rutas de locale; los pies faltantes caen al principal.

Resolución de problemas y errores habituales

Problema	Qué comprobar
No puede añadir locales publicados	El plan debe incluir multilingual sites; solo el principal siempre funciona
Sin filas Languages en una página	Añada extras en Settings → Site Languages y vuelva a abrir Page Settings
Generate pide una clave API	Settings → Integrations → Translation — elija DeepL, Gemini u OpenAI (no Manual only) y pegue una clave
Generate falla o se detiene a mitad del sitio	Cuota del proveedor agotada o clave no válida—compruebe la consola del proveedor; los presupuestos DeepL Developer suelen ser totales de una sola vez
Selector ausente en el sitio en vivo	Plantilla guardada con Language Switcher; más de un locale publicado; republicar o hard-refresh
Página /fr/… 404	El locale francés de esa página está Missing o Draft—Publish en Languages
El título sigue en el principal en una foto francesa	Soft-fall esperado hasta que exista una traducción del pie; el cromado debería seguir en francés

Verificar su configuración

• Site Languages muestra el principal y los locales publicados previstos.
• Integrations → Translation muestra un proveedor automático con una clave guardada.
• El encabezado o pie incluye Language Switcher cuando hay extras.
• Una página tiene un locale extra Live; su URL /{locale}/… carga el cuerpo traducido.
• Abrir la misma página sin un extra publicado devuelve 404 (no HTML principal bajo la URL con prefijo).

Documentación relacionada

• Encabezado, pie y navegación — bloque Language Switcher
• Configuración de página y anulaciones — pestaña Page Settings
• Vista previa y publicación — flujo de publicación del principal
• Configuración SEO de página — campos meta (Generate rellena el SEO del locale desde el principal)
• Publicar y actualizar entradas del blog — entradas y extras