js lingui

Lingui _JS

? Uma internacionalização legível, automatizada e otimizada (3 KB) para JavaScript

---

Documentação · QuickStart · Exemplo · Suporte · Contribuir · Licença

A internacionalização é o design e o desenvolvimento de um produto, aplicação ou conteúdo de documentos que permite uma localização fácil para o público -alvo que variam em cultura, região ou idioma.

--- FAQ de internacionalização da Web W3C

Lingui é uma estrutura fácil, mas poderosa de internacionalização (I18N) para projetos globais.

• Limpo e legível - mantenha seu código limpo e legível, enquanto a biblioteca usa um poderoso formato de mensagem de UTI testado e poderoso sob o capô.

• Universal - use -o em todos os lugares. @lingui/core fornece a funcionalidade INTL essencial que funciona em qualquer projeto JavaScript, enquanto @lingui/react oferece componentes para alavancar a renderização do React, incluindo o suporte ao React Server (RSC).

• Suporte completo de texto rico - use componentes do React dentro de mensagens localizadas sem nenhuma limitação. Escrever mensagens de texto rico é tão fácil quanto escrever JSX.

• Ferramentas poderosas - gerencie seu fluxo de trabalho INTL com o Lingui CLI, o plug -in de vite e o plug -in ESLint. A CLI extrai, compila e valida mensagens, enquanto o plug -in Vite compila catálogos em tempo real, e o plug -in ESLint ajuda a capturar erros de uso comuns.

• Não -opinado - integrar Lingui ao seu fluxo de trabalho existente. Ele suporta chaves de mensagem e mensagens geradas automaticamente. As traduções são armazenadas em arquivos JSON ou PO padrão, que são suportados em quase todas as ferramentas de tradução.

• A biblioteca de núcleo leve e otimizada é inferior a 3 KB Gzipped, os componentes do React são adicionais de 1,4 kb.

• Comunidade ativa - junte -se à crescente comunidade de desenvolvedores que estão usando Lingui para construir produtos globais.

• Compatível com a API React-Intl -de baixo nível é muito semelhante ao React-Intl e o formato da mensagem é o mesmo. É fácil migrar um projeto existente.

Investir rápido

1. Introdução
2. Instalação e configuração

Tutoriais

• Reagir
• Componentes do servidor react
• Reagir nativo
• JavaScript

Exemplo

Exemplo curto como o I18N olha com o JSX:

 import { Trans } from "@lingui/react/macro"

function App ( ) {
  return (
    < Trans id = "msg.docs" /* id is optional */ >
      Read the < a href = "https://lingui.dev" > documentation </ a >
      for more info.
    </ Trans >
  )
}

A mensagem deste componente será extraída no seguinte formato:

 msgid "msg.docs"
msgstr "Read the <0>documentation</0> for more info."

Para mais exemplo, consulte o diretório exemplos.

Apoiar

Se você está tendo problemas, informe -nos.

• Junte -se a nós na Discord para conversar com a comunidade.
• Faça perguntas no Stackoverflow e marque -o com a tag linguijs .
• Se algo não funcionar como documentado, a documentação está ausente ou se você deseja apenas sugerir um novo recurso, crie um problema.
• Você também pode perguntar a Lingui JS Guru, é uma IA focada em Lingui JS para responder às suas perguntas.

Contribuir

A contribuição para o projeto de código aberto é de tudo, desde espalhar a palavra, escrever documentação para implementar recursos e corrigir bugs.

• Você usa Lingui no site de produção? Deixe -nos saber!
• Você já viu alguma conversa ou artigo interessante sobre I18n ? Compartilhe!
• Você encontrou um bug ou deseja sugerir um novo recurso? Crie um problema!
• Deseja melhorar os documentos e escrever algum código? Leia o guia dos colaboradores e envie um PR!

Colaboradores

Este projeto existe graças a todas as pessoas que contribuem. [Contribuir].

Licença

O projeto está licenciado sob a licença do MIT.