Acerca del marco de trabajo ShipLang
La primera pila tecnológica multilingüe diseñada para la IA, que permite a los desarrolladores centrarse en el producto en sí.
Introducción al marco conceptual e ideales
ShipLang es la primera pila tecnológica desarrollada por gestores de producto, nacida de una reflexión sobre los procesos de desarrollo tradicionales. En la era de la IA, lo que necesitamos no son herramientas más complejas, sino soluciones sencillas que permitan centrarse en las ideas de producto.
La idea central de este marco es que la globalización deje de ser una carga para los productos. Una vez que hayas escrito el código en chino, los usuarios de todo el mundo podrán acceder a tu sitio web en su idioma nativo. El multilingüismo debería ser automático e inteligente, en lugar de requerir el mantenimiento manual de decenas de archivos de traducción.
ShipLang es completamente gratuito y de código abierto. No se trata solo de compartir tecnología, sino también de explorar la capacidad de acción humana en la era de la IA. La tecnología debe estar al servicio de la creación, no convertirse en un obstáculo para ella.
Nuestro sistema está diseñado para usuarios sin conocimientos de programación y es compatible tanto con los hábitos de uso del usuario como con los de la IA, como se muestra en el siguiente diagrama:
Hacer que la IA sea compatible, no al revés (haga clic para ver la imagen más grande).
Hacer que la IA sea compatible, no al revés (haga clic para ver la imagen más grande).
Sobre el autor
Principios técnicos
Mecanismo de traducción inteligente multilingüe
El objetivo del soporte multilingüe es garantizar que, cuando se escriba código chino en el backend, los usuarios vean otros idiomas.
El principio es que, cuando un usuario visita el sitio por primera vez, el sistema verifica su configuración de idioma. Si no existe un archivo de traducción para ese idioma, el sistema llama a la API de traducción, traduce el idioma, muestra el resultado traducido en la página y lo almacena en caché en el servidor para su uso posterior. Si ya existe un archivo de traducción para el idioma correspondiente, se carga directamente y la página se muestra en el idioma correcto.
Flujo de trabajo
1. Cuando un usuario visita una página, el sistema detecta automáticamente la preferencia de idioma del navegador.
2. Compruebe si el servidor ya dispone de un archivo de caché de traducción para ese idioma.
3. Si existe la caché, cárguela y renderícela directamente; de lo contrario, llame a la API de traducción de IA.
4. Tras la traducción, guárdela en la caché del servidor para su uso directo en la siguiente visita.
5. Todo el proceso es transparente para el usuario, no requiere esperas y proporciona una experiencia fluida.
Guía del usuario
Uso básico
Si hay contenido que necesita ser traducido a varios idiomas, agregue la etiqueta data-i18n al archivo PHP correspondiente.
Por ejemplo, si desea traducir el chino "欢迎用" (Bienvenido a usar) a varios idiomas en la página web langany.com/docs/lang-i18n, debe agregar lo siguiente al archivo PHP correspondiente:
<p data-i18n="welcome">欢迎使用</p>Cuando el usuario utilice la interfaz en inglés, se mostrará "Bienvenido" en la ubicación correspondiente en langany.com/docs/lang-i18n.
Mecanismo de reutilización de etiquetas
Al agregar etiquetas data-i18n multilingües, puede copiar las etiquetas que usó anteriormente y solo modificar el texto; no es necesario redefinir las etiquetas data-i18n.
Por ejemplo, si la etiqueta para "你好" se define como "k", entonces "你好" en la página se traducirá automáticamente como "hola" en inglés. Si también desea traducir "不错" (no está mal) a varios idiomas, puede copiar directamente la etiqueta:
<p data-i18n="k">你好</p>
<p data-i18n="k">不错</p>Actualmente, en todos los sistemas del mercado, la misma etiqueta se traduce al mismo contenido. Sin embargo, en ShipLang, el sistema admite la reutilización de valores de etiquetas data-i18n. Cuando varios elementos usan la misma etiqueta pero tienen contenido diferente, el sistema los convierte automáticamente a k_你好 (hola) o k_不错 (no está mal), lo que garantiza que la traducción coincida con el texto original.
Conserva el texto original
Si cierto texto de la página no necesita ser traducido y debe permanecer en su estado original en chino, entonces no se debe agregar la etiqueta data-i18n a ese texto.
Editar manualmente la traducción
Si no está satisfecho con el contenido traducido automáticamente, puede modificar la traducción manualmente:
1. Localiza el valor de la etiqueta data-i18n en el archivo HTML donde deseas modificar el contenido.
2. Busca la etiqueta en el archivo JSON del idioma correspondiente.
3. Edita la traducción y guárdala.
Por ejemplo, para modificar la traducción al inglés de "1. Hello" en https://langany.com/refund, busque la etiqueta section1_title, búsquela en lang/en/docs/refund.json y modifíquela.
Preguntas frecuentes
¿Por qué elegir PHP como lenguaje de backend?
PHP es fácil de implementar, económico y cuenta con un ecosistema consolidado, lo que lo hace ideal para la implementación e iteración rápidas. Para desarrolladores independientes y equipos pequeños, la combinación de PHP y alojamiento virtual permite atender a usuarios globales a un costo mínimo. El objetivo de ShipLang es facilitar el acceso a las nuevas tecnologías, no seguir las últimas tendencias.
¿Cómo se puede garantizar la calidad de la traducción?
ShipLang utiliza una API de traducción con IA líder en el sector, lo que garantiza una calidad de traducción profesional. Para contenido crítico, puede modificar manualmente los archivos traducidos en cualquier momento. Además, las traducciones se almacenan en caché de forma permanente tras un único envío, lo que elimina los costes adicionales por llamadas duplicadas a la API.
¿Qué idiomas son compatibles?
En teoría, admite todos los idiomas principales del mundo. El sistema se adaptará automáticamente según las preferencias de idioma del navegador del usuario, incluyendo, entre otros, inglés, japonés, coreano, francés, alemán, español, árabe y más de 100 idiomas adicionales.
¿Cuánto tiempo tarda la primera traducción?
Cuando un usuario accede por primera vez a un nuevo idioma, la traducción suele tardar entre 1 y 3 segundos. Los accesos posteriores a ese idioma se cargarán directamente desde la caché, con una velocidad idéntica a la de las páginas web habituales. Para sitios web con una gran cantidad de usuarios, se recomienda generar previamente los archivos de traducción para los idiomas más utilizados.
¿Cómo actualizo el contenido traducido?
Existen dos métodos: uno consiste en modificar directamente el archivo JSON en el idioma correspondiente, y el otro en borrar la caché de traducción anterior, de modo que el sistema la vuelva a traducir en la siguiente visita. Para páginas con contenido que se actualiza con frecuencia, se recomienda utilizar un mecanismo de gestión de versiones.
¿Cuáles son las ventajas de los mecanismos de reutilización de etiquetas?
Los sistemas multilingües tradicionales requieren que cada contenido traducido tenga una etiqueta única, lo que dificulta la asignación y gestión de nombres de etiquetas. ShipLang permite reutilizar etiquetas y el sistema identifica de forma inteligente las diferencias de contenido. Esto mejora considerablemente la eficiencia del desarrollo; ya no tendrá que preocuparse por los nombres de las etiquetas.
¿Para qué tipos de proyectos es adecuado ShipLang?
ShipLang es especialmente adecuado para proyectos que requieren una rápida globalización, como productos SaaS, páginas de destino de marketing, sitios web de comercio electrónico y plataformas de contenido. Si desea llegar al mercado global con un coste mínimo, ShipLang es la opción ideal. Para aplicaciones empresariales de gran envergadura, ShipLang también puede utilizarse como herramienta de prototipado rápido.
¿Por qué se dice que ShipLang está diseñado para la era de la IA?
En la era de la IA, la traducción ya no debería ser una tarea laboriosa. ShipLang aprovecha al máximo las capacidades de la IA para automatizar y transformar la traducción de forma inteligente. Además, su arquitectura optimizada facilita la integración de más funcionalidades de IA en el futuro, como la generación inteligente de contenido y el análisis del comportamiento del usuario.
Primeros pasos con ShipLang
El framework es completamente de código abierto; puedes usarlo, modificarlo y distribuirlo libremente. Creemos que, en la era de la IA, la tecnología debe ser abierta, fácil de usar y estar al servicio de los creadores.
Si estás de acuerdo con este concepto, te invitamos a unirte a la comunidad ShipLang y explorar nuevos paradigmas para el desarrollo de productos en la era de la IA.