Sobre o framework ShipLang
A primeira plataforma tecnológica multilíngue projetada para IA, permitindo que os desenvolvedores se concentrem no produto em si.
Introdução e Ideais da Estrutura
ShipLang é a primeira pilha de tecnologia desenvolvida por gerentes de produto, fruto de uma reflexão sobre os processos de desenvolvimento tradicionais. Na era da IA, o que precisamos não são ferramentas mais complexas, mas sim soluções simples que permitam às pessoas se concentrarem nas ideias de produto.
O principal objetivo dessa estrutura é fazer com que a globalização deixe de ser um fardo para os produtos. Depois de escrever o código em chinês, usuários do mundo todo poderão acessar seu site em seu idioma nativo. O multilinguismo deve ser automático e inteligente, em vez de exigir a manutenção manual de dezenas de arquivos de tradução.
ShipLang é totalmente gratuito e de código aberto. Não se trata apenas de compartilhar tecnologia, mas também de uma tentativa de explorar a capacidade de ação humana na era da IA. A tecnologia deve servir à criação, e não se tornar um obstáculo a ela.
Nosso sistema foi projetado para usuários sem conhecimento de programação e é compatível com os hábitos de uso tanto do usuário comum quanto da IA, conforme mostrado no diagrama abaixo:
Tornar a IA compatível, e não o contrário (clique para ver a imagem ampliada)
Tornar a IA compatível, e não o contrário (clique para ver a imagem ampliada)
Sobre o autor
Princípios técnicos
Mecanismo de tradução inteligente multilíngue
O objetivo do suporte multilíngue é garantir que, ao digitar chinês no código do sistema, os usuários vejam outros idiomas.
O princípio é o seguinte: quando um usuário visita o site pela primeira vez, o sistema verifica as configurações de idioma do usuário. Se não existir um arquivo de tradução para esse idioma, o sistema chama a API de tradução, traduz o idioma, exibe o resultado traduzido na página e armazena o resultado em cache no servidor para uso futuro. Se já existir um arquivo de tradução para o idioma correspondente, ele é carregado diretamente e o idioma da página é exibido automaticamente.
Fluxo de trabalho
1. Quando um usuário visita uma página, o sistema detecta automaticamente a preferência de idioma do navegador.
2. Verifique se o servidor já possui um arquivo de cache de tradução para esse idioma.
3. Se o cache existir, carregue e renderize-o diretamente; caso contrário, chame a API de tradução de IA.
4. Após a tradução, salve-a no cache do servidor para uso direto na próxima visita.
5. Todo o processo é transparente para o usuário, não requer espera e proporciona uma experiência tranquila.
Guia do Usuário
Uso básico
Se houver conteúdo que precise ser traduzido para vários idiomas, adicione a tag data-i18n ao arquivo PHP correspondente.
Por exemplo, se você quiser traduzir o texto chinês "欢迎用" (Bem-vindo ao uso) para vários idiomas na página langany.com/docs/lang-i18n, você precisa adicionar o seguinte ao arquivo PHP correspondente:
<p data-i18n="welcome">欢迎使用</p>Quando o usuário estiver utilizando a interface em inglês, a mensagem "Bem-vindo" será exibida no local correspondente em langany.com/docs/lang-i18n.
Mecanismo de reutilização de tags
Ao adicionar tags data-i18n multilíngues, você pode copiar as tags usadas anteriormente e modificar apenas o texto; não é necessário redefinir as tags data-i18n.
Por exemplo, se a tag para "你好" estiver definida como "k", então "你好" na página será automaticamente traduzido como "hello" em inglês. Se você também quiser traduzir "不错" (nada mal) para vários idiomas, basta copiar a tag:
<p data-i18n="k">你好</p>
<p data-i18n="k">不错</p>Atualmente, em todos os sistemas disponíveis no mercado, a mesma tag é traduzida para o mesmo conteúdo. No entanto, no ShipLang, o sistema suporta a reutilização de valores de tags data-i18n. Quando vários elementos usam a mesma tag, mas têm conteúdo diferente, o sistema os converte automaticamente para k_你好 (olá) ou k_不错 (nada mal), garantindo que a tradução corresponda com precisão ao texto original.
Mantenha o texto original
Se determinado texto na página não precisar ser traduzido e deva permanecer em seu estado original em chinês, então a tag data-i18n não deve ser adicionada a esse texto.
Editar manualmente a tradução
Se você não estiver satisfeito com o conteúdo traduzido automaticamente, poderá modificar a tradução manualmente:
1. Localize o valor da tag data-i18n no arquivo HTML onde você deseja modificar o conteúdo.
2. Procure a tag no arquivo JSON do idioma correspondente.
3. Edite a tradução e salve.
Por exemplo, para modificar a tradução em inglês de "1. Olá" em https://langany.com/refund, encontre a tag section1_title, procure por ela em lang/en/docs/refund.json e modifique-a.
Perguntas frequentes
Por que escolher PHP como linguagem de backend?
O PHP é fácil de implementar, econômico e possui um ecossistema maduro, o que o torna ideal para implantação e iteração rápidas. Para desenvolvedores independentes e pequenas equipes, a combinação de PHP e hospedagem virtual permite atender usuários globais a um custo mínimo. O objetivo da ShipLang é reduzir as barreiras de entrada, não seguir tendências tecnológicas.
Como garantir a qualidade da tradução?
A ShipLang utiliza uma API de tradução com IA líder de mercado, alcançando qualidade de tradução profissional. Para conteúdo crítico, você pode modificar manualmente os arquivos traduzidos a qualquer momento. É importante ressaltar que as traduções são armazenadas em cache permanentemente após um único envio, eliminando cobranças duplicadas de chamadas à API.
Quais idiomas são suportados?
Teoricamente, ele suporta todos os principais idiomas do mundo. O sistema fará a correspondência automaticamente com base nas preferências de idioma do navegador do usuário, incluindo, entre outros, inglês, japonês, coreano, francês, alemão, espanhol, árabe e mais de 100 outros idiomas.
Quanto tempo demora a primeira tradução?
Quando um usuário acessa um novo idioma pela primeira vez, a tradução geralmente leva de 1 a 3 segundos. Acessos subsequentes a esse idioma serão carregados diretamente do cache, com velocidades idênticas às das páginas da web comuns. Para sites com uma grande base de usuários, recomenda-se pré-gerar arquivos de tradução para os idiomas mais usados.
Como faço para atualizar o conteúdo traduzido?
Existem dois métodos: um é modificar diretamente o arquivo JSON no idioma correspondente, e o outro é excluir o cache de tradução antigo, fazendo com que o sistema traduza novamente na próxima visita. Para páginas com conteúdo atualizado frequentemente, recomenda-se o uso de um mecanismo de controle de versão.
Quais são as vantagens dos mecanismos de reutilização de tags?
Os sistemas multilíngues tradicionais exigem que cada conteúdo traduzido tenha uma etiqueta única, o que dificulta a nomeação e o gerenciamento dessas etiquetas. O ShipLang permite reutilizar etiquetas, e o sistema identifica de forma inteligente as diferenças entre os conteúdos. Isso melhora significativamente a eficiência do desenvolvimento; você não precisa mais quebrar a cabeça pensando em nomes de etiquetas.
Para que tipos de projetos o ShipLang é adequado?
ShipLang é particularmente adequado para projetos que exigem rápida globalização, como produtos SaaS, páginas de destino de marketing, sites de comércio eletrônico e plataformas de conteúdo. Se você deseja alcançar o mercado global com o mínimo custo, ShipLang é a escolha ideal. Para grandes aplicações corporativas, ShipLang também pode ser usado como uma ferramenta de prototipagem rápida.
Por que se diz que a ShipLang foi projetada para a era da IA?
Na era da IA, a tradução não precisa mais ser uma tarefa árdua e trabalhosa. O ShipLang aproveita ao máximo os recursos da IA para automatizar e transformar traduções de forma inteligente. Além disso, sua arquitetura simplificada facilita a integração de mais funcionalidades de IA no futuro, como geração inteligente de conteúdo e análise do comportamento do usuário.
Primeiros passos com ShipLang
A estrutura é totalmente de código aberto; você tem a liberdade de usá-la, modificá-la e distribuí-la. Acreditamos que, na era da IA, a tecnologia deve ser aberta, fácil de usar e servir aos criadores.
Se você concorda com esse conceito, seja bem-vindo(a) à comunidade ShipLang e explore novos paradigmas para o desenvolvimento de produtos na era da IA.