Internacionalização

O explorador pode ser traduzido em diferentes línguas. Para fazer isso, no caso de uma customização do portal, para adicionar uma nova linguagem, é necessário aplicar alterações no web-theme e também as seguintes alterações no explorador:

Adicionando uma nova língua

Para fazer isso, 2 dois arquivos precisam ser adicionados e traduzidos a partir de um arquivo de língua já existente

• src/main/resources/ApplicationResources_LANG.properties
• src/main/resources/urlResource_LANG.properties

Onde "LANG" representa o código ISO 639-1 da nova língua.

Observação importante: o arquivo de properties urlResource_LANG.properties trabalha com um bundle invertido. Ou seja, ao invés do tradicional formato chave=valor, o arquivo emprega o formato inverso valor=chave, cujo valor padrão para a chave é sempre o inglês.

Por exemplo, o arquivo urlResource_en.properties inglês:

search=search
resources=resources
occurrences=occurrences

Em português, o arquivo urlResource_pt.properties será:

busca=search
recursos=resources
ocorrencias=occurrences

web-theme

Para conlcuir a customização da língua, no projeto web-theme, você também deve fornecer os recursos para o seu tema.

URLs internacionalizadas

O explorador está utilizando de URLs i18n, o que significa, por exemplo, que a URL da página de busca é /en/search para o inglês e /pt/busca para o português.

Detalhes

Internamente, todos os pedidos são convertidos para /search?lang=pt ou /search?lang=en. Por exemplo: “/fr/rechercher” -> “/search?lang=fr”

Está técnica se preocupa com a parte do caminho URL que contém a língua e o nome do recurso i18n. O mapeamento URL da aplicação pode então ignorar a língua e a tradução.

Exceções

• Parâmetros de busca
• Caminhos que começam com /assets/ (recursos estáticos, como JavaScript, CSS e arquivos de imagens)
• Caminhos que comecem com /ws/ (end-point de web service)

Bibliotecas

A biblioteca utilizada para mapear o caminho recebido para o caminho de um recurso é a OCPSoft Rewrite.