Converter QCH para TS

Entendendo os formatos de arquivo QCH e TS

QCH arquivos são arquivos Qt Compressed Help, comumente usados para armazenar documentação em formato comprimido para o framework Qt. Esses arquivos geralmente são gerados a partir de arquivos QHP (Qt Help Project) e são utilizados pelo Qt Assistant e outras aplicações baseadas em Qt para fornecer conteúdo de ajuda pesquisável e estruturado.

TS arquivos são arquivos Qt Linguist Translation Source. Eles são baseados em XML e usados para armazenar traduções de textos de interface de usuário em aplicações Qt. Desenvolvedores e tradutores usam arquivos TS para gerenciar e localizar strings de aplicações.

Por que converter QCH para TS?

Converter um arquivo QCH para um arquivo TS não é um fluxo de trabalho padrão, pois esses formatos têm propósitos diferentes. Porém, você pode querer extrair texto translatável da documentação (QCH) para criar ou atualizar arquivos de tradução (TS) para fins de localização.

Como converter QCH para TS

Não existe uma ferramenta direta e automatizada para converter arquivos QCH em arquivos TS, mas você pode seguir esses passos:

1. Extrair conteúdo do QCH: Use a ferramenta qhelpgenerator (parte do Qt SDK) para extrair o conteúdo HTML do arquivo QCH. Como alternativa, utilize qch-extract (uma utilidade de código aberto) para descompactar o arquivo QCH.
2. Identificar texto translatável: Revisar os arquivos HTML extraídos e identificar o texto que precisa de tradução.
3. Criar ou atualizar arquivos TS: Use Qt Linguist ou ferramentas de linha de comando Linguist para criar um novo arquivo TS. Você pode adicionar manualmente as strings extraídas ou usar scripts para automatizar o processo.

Softwares recomendados para conversão de QCH para TS

• qch-extract: Ferramenta de código aberto para extrair HTML de arquivos QCH. Disponível no GitHub.
• Qt Linguist: Ferramenta oficial do Qt para editar e gerenciar arquivos TS.
• Ferramentas do Qt SDK: Inclui qhelpgenerator e outras utilidades para trabalhar com arquivos QCH.

Exemplo passo a passo usando qch-extract e Qt Linguist

1. Baixe e instale qch-extract do GitHub.
2. Execute qch-extract yourfile.qch -o output_folder para extrair os arquivos HTML.
3. Abra os arquivos HTML e copie o texto que deseja traduzir.
4. Abra Qt Linguist e crie um novo arquivo TS via File → New.
5. Cole o texto extraído como novas entradas de tradução.
6. Salve o arquivo TS para uso no seu projeto Qt.

Conclusão

Embora não exista um conversor direto de QCH para TS, você pode extrair o conteúdo da documentação de arquivos QCH e adicioná-lo manualmente ou semi-automaticamente aos arquivos TS usando as ferramentas recomendadas. Esse processo permite localizar a documentação ou integrar traduções do conteúdo de ajuda nas suas aplicações Qt.