Marcus Gama

    marcus.gama@gmail.com

Tradução

# Preferências

## Configurações globais e do projeto

Desde o KBabel 1.10 (KDE 3.4), o KBabel passou a ter o conceito de projetos e, como tal, as configurações foram divididas em duas categorias: as configurações globais e as configurações do projeto.

O 'gettext' da &GNU; usa um termo chamado "projeto", que não tem nada a ver com os projetos do KBabel. O 'gettext' da &GNU; entende como projeto uma aplicação relacionada com o arquivo PO. No caso do KBabel, um projeto é bem maior. Poderá significar um conjunto de aplicações, como o &kde;.

O KBabel tem sempre um projeto atual, mesmo que seja o projeto padrão. O KBabel não possui nenhum modo sem projeto. Um projeto funciona sempre para o editor e o gerenciador de catálogos do KBabel.

### Limitações conhecidas da implementação atual

Infelizmente, a implementação atual dos projetos possui alguns problemas conhecidos.

Um exemplo é que, nas configurações globais, não há uma configuração para o usuário padrão, seu idioma padrão e outros dados importantes do usuário a nível global. Isso significa que esses dados terão de ser inseridos novamente, sempre que é criado um novo projeto.

Outro problema é o assistente de novos projetos. Ele não solicita informações suficientes, especialmente no que diz respeito ao endereço de e-mail da equipe. Assim, recomenda-se que verifique a configuração do projeto após ter executado o assistente.

Atualmente, você não pode copiar os projetos de dentro do KBabel, assim você não poderá compartilhar de forma simples as configurações adequadas. Contudo, você está livre para copiar o projeto fora do KBabel e carregar o projeto copiado para o KBabel.

### Usando o KBabel em projetos não-&kde;

Embora a configuração padrão do &kbabel; esteja orientada para ser usada no &kde;, o &kbabel; pode ser usado para traduzir os arquivos PO de outros projetos. Contudo, você terá que ajustar a configuração de acordo com as necessidades do seu projeto. Isto é especialmente verdadeiro para os projetos da &GNU; e compatíveis com a &GNU;, que necessitam de opções bem diferentes das do &kde;.

Um problema é que o &kbabel; é relativamente agressivo ao salvar os arquivos PO e substitui a configuração dos arquivos PO por configurações dos projetos, se não for dito nada em contrário. Isto poderá ser altamente estranho para alguém que não esteja habituado ao &kde;. Contudo, o &kde; tem mais de 900 arquivos POT para traduzir, somente para as mensagens da GUI. Assim, para uma tarefa desse tipo, é desejável alguma automação. O tempo levado para configurar um projeto é bastante menor em comparação com o tempo que se ganha posteriormente. Obviamente, como não-usuário do &kde;, você poderá ter menos sorte. Terá que fazer mais configurações, uma vez que os padrões não são completamente adequados e não irá ganhar muito se fizer muitas traduções, uma vez que os projetos da &GNU; só possuem tipicamente um arquivo POT para traduzir.

## Configurações globais do &kbabel;

Para mostrar o diálogo de preferências selecione Configurações Configurar KBabel... no menu do &kbabel;. Ele usa um estruturado diálogo de configuração que torna muito fácil encontrar uma opção se ter que realizar uma intensa busca por ela.

### Editar

A categoria de preferências do editor é dividia em duas sub-janelas: Geral, Aparência, Ortografia e Fontes. Todas estas configurações personalizam como o editor se comporta e parece.

#### Geral

Janela Geral de Edição
Janela Geral de Edição

Esta seção contém um conjunto de caixas de verificação.

A primeira caixa de verificação no lado superior é se o estado aproximado é desligado automaticamente quando um caracter é inserido no editor de MsgStr. Quando esta opção estiver desabilitada você terá que selecionar manualmente Editar Desligar Estado Aproximado ou usar o atalho &Ctrl;U. Observe que isto significa que o string `, fuzzy` é removido da entrada do comentário.

A próxima opção lhe permite habilitar a edição inteligente, quando o editor automaticamente insere caracteres especiais escapados corretamente, ⪚ `\t` após pressionar Tab e isto permite manipulação especial do Enter.

As caixas de verificação inferiores são muito úteis para verificação, não para correção das traduções, se o string a ser traduzido é uma substituição apropriada para o original. Por exemplo, muitas mensagens representam ítens de menu com atalhos de teclado e strings formatados no estilo-C cuja estrutura deve permanecer intacta uma vez traduzida.

Verificar Argumentos

  Quando esta opção estiver selecionada, strings no estilo-C no original e a tradução são verificados para certificar-se de que o número de seqüências formatadas e a ordem são consistentes.

Verificar Acelerador

  Quando esta opção é selecionada, o &kbabel; verifica se a quantidade de caracteres aceleradores é idêntica, tanto na mensagem original como na traduzida. Observe que o caracter de aceleração é o & no &kde; (mas não em todas as ferramentas de programação). Veja a seção de Diversos abaixo, para saber como alterar um acelerador de teclado.

Verificar Equação

  Este é um recurso de desenvolvimento do projeto &kde;. Arquivos `.desktop` são simplesmente arquivos de texto que armazenam diversos parâmetros no formato `valor=chave`. Algumas dessas `chaves` são traduzíveis. A única imposição é manter o lado esquerdo da igualdade imutável. Verificar equação lhe permite ressaltar diversos erros determinados pelo algoritmo de aproximado do `msgmerge`. Observe que existem situações em que esta função gera erros falsos em alguns arquivos PO.

Procurar por Informações de Contexto Traduzidas

  Algumas mensagens originais contém informações de contexto para delimitar o contexto em que o string original deve ser traduzido. Isto é para evitar que muitas palavras simples, como Salvar, sejam traduzidas incorretamente em função de seu sentido amplo em muitos idiomas. Informação de contexto é marcada com `_:`. Muitos tradutores inexperientes traduzem informações de contexto e enchem seus arquivos PO com lixo. Habilite esta caixa para certificar-se que você será alertado sobre estes erros no arquivo.

Verificar Formas Plurais

  Se você estiver traduzindo o projeto do &kde;, ele usa uma forma especial de indicar as formas plurais das mensagens. Esta verificação conta automaticamente o número de formas no msgstr e compara-o com o número indicado na página de Identidade. Um número incorreto de formas plurais poderá resultar no estouro de uma aplicação.

Beep no erro

  Sua campainha de sistema tocará quando você sair de entradas com erros como os descritos acima.

Mudar cor do texto no erro

  Este é outro tipo de alerta sobre erros na mensagem atual. É uma boa solução para quem tem problemas de audição ou não gostam do barulho da campainha. Veja também a aba Aparência para ver como mudar a cor do texto em erros.

#### Aparência

Janela de Aparência da Edição
Janela de Aparência da Edição

Estas opções lhe permitem configurar a aparência do editor de mensagem. Na parte superior existem 4 caixas de verificação:

Destaque de sintaxe

  Configurar esta opção habilitará o destaque de sintaxe para caracteres especiais, aceleradores e o texto de fundo no visor de msgid e no editor de msgstr. Se você não possui um monitor monocromático ou não possua defeito visual, você deve habilitar esta opção.

Destaque de fundo

  O fundo é destacado somente para os caracteres existentes no msgid e msgstr. Isto inclui espaços. Isto é útil se você não quer ver as aspas envolventes (veja abaixo) para a entrada PO, e você quer ainda observar espaços iniciais e finais numa linha de texto.

Marcar espaços em branco com pontos

  Quando você sentir a necessidade de contar espaços e não gostar de usar o destaque de fundo então você pode habilitar esta opção para ter um pequeno ponto desenhado no meio dos caracteres de espaço em branco. Observe que o ponto é um sinal de ponto no centro da caixa do caractere e não é um ponto decimal.

Mostrar aspas envolventes

  Se você achar que ver os caracteres de terminação numa linha de texto de um msgstr ou msgid é preferível então habilite esta opção para ver as aspas envolventes em cada linha de texto.

  Se você está acostumado a editar arquivos PO com editores de texto simples você pode sentir-se mais seguro se você pode ver as aspas iniciais e finais nas linhas de entrada do PO.

Para os diferentes ítens no texto editado aqui existem diferentes escolhas de cor para tornar a edição mais fácil. As cores podem ser mudadas clicando nos botões de seleção de cor. No diálogo 'selecionar cor' você pode escolher uma das cores padronizadas, cores personalizadas ou simplesmente obter uma cor de qualquer parte de sua tela.

Cor de fundo

  Isto configura a cor de fundo para caracteres no visor da MsgID e no editor de MsgStr. Para mudar a cor de fundo geral da caixa de edição você deve usar o &kcontrolcenter;.

Cor dos caracteres escapados

  Aqui você pode ajustar a cor de caracteres escapados como (`\"`) aspas duplas ou (`\n`) nova linha.

Cor para erros de sintaxe

  Esta é a cor para toda a entrada de texto se erros são detectados quando você tenta salvar o arquivo PO. Erros são provocados por terminações não idênticas tanto do msgid como do msgstr, ou caracteres escapados incorretamente.

Cor para caracteres estilo-c

  Isto configura a cor para um seqüência de caracteres no estilo das funções `printf` ou `scanf` da linguagem C. Geralmente eles iniciam com (`%`) caracter de percentual e são continuados por um caracter.

Cor para aceleradores de teclado

  Os atalhos de teclado começam com um E comercial (&) no &kde;, mas se você estiver traduzindo outros projetos, poderá existir um caracter diferente marcando a tecla do acelerador. Veja a seção de Diversos abaixo, para saber como alterar um acelerador de teclado.

O estado da entrada atualmente editada é marcado por três LEDs. Para sua conveniência você pode escolher onde colocar estes LEDs—se na barra de estado ou na seção do editor (entre a entrada msgid e msgstr). Se tiver dificuldade de ver algumas cores ou se deseja ser capaz de acompanhar a mudança de estado do LED facilmente sem mover seus olhos você pode selecionar a cor desejada usando o botão selecionador de cores.

### Procurar

Janela de Procura
Janela de Procura

A seção procurar lhe permite personalizar várias configurações para procura em strings previamente traduzidos.

Configurações gerais são comuns para todos os tipos de busca. Se você habilitar a opção Iniciar automaticamente a busca então a busca é automaticamente iniciada sempre que você alterna para outra entrada no editor. Atualmente existem três possibilidades que você pode escolher, mas uma vez que o &kbabel; pode usar plugins de dicionário os dicionários disponíveis dependem da sua instalação. Usando Configurações Configurar Dicionário ... você pode configurar cada plugin de procura.

Os plugins de dicionário instalados por padrão são:

Motor de Busca de Banco de Dados do &kde;

  Este novo método está ainda em estágio alfa de desenvolvimento e é baseado no &kbabeldict; que acompanha o &kbabel;. Veja a documentação do &kbabeldict; para mais informações sobre a configuração deste motor de busca.

Compêndio PO

  O compêndio é um arquivo PO normal, que deve conter uma lista de traduções padrão da sua equipe de tradução. Se você não possui um, você pode também usar um arquivo que contenha todas as traduções de sua equipe (⪚ o arquivo `$lang.messages` do Projeto &kde; pode ser encontrado em i18n.kde.org).

PO Auxiliar

  O auxiliar deve ajudá-lo a encontrar o contexto da tradução procurando a mesma mensagem num catálogo de mensagens do mesmo pacote mas traduzido para outro idioma. Esta é uma maneira de você dar uma olhada em como esta mensagem foi traduzida em outro idioma.

Você pode também iniciar a busca manualmente escolhendo uma entrada no menu que aparece, seja clicando em Dicionários Procurar Texto Compêndio PO ou mantendo o botão de procurar pressionado na barra de ferramentas por algum tempo.

### Diferenças

Janela de Diferenças
Janela de Diferenças

A seção Diferenças mantém configurações sobre como exibir diferenças nas msgids.

Cada diferença pode ser exibida tanto o texto adicionado como os caracteres removidos do texto. Para ambas você pode especificar o método de exibição e a cor que será usada. Destacada significa que o fundo dos caracteres correspondentes serão mostrados na cor selecionada, enquanto Sublinhado (para caracteres adicionados) ou Riscado (para caracteres removidos) mostrará as partes mudadas com linhas coloridas.

Os modos de diferença precisam encontrar a msgid original para compará-las. Para esta finalidade, o &kbabel; pode usar o banco de dados de tradução se você ligá-lo em Usar mensagens do Banco de Dados de Traduções. Uma segunda possibilidade é usar uma árvore dos arquivos PO originais e especificar a raiz da árvore em Pasta base para diferença dos arquivos.

### Fontes

Janela de Fontes
Janela de Fontes

Este é um diálogo padrão de escolha de fontes do &kde; com uma pequena adição. Você pode selecionar ver somente fontes fixas habilitando a opção Mostrar somente fontes fixas. Isto é altamente recomendável para uma fácil tradução. O diálogo de fonte lhe permite configurar a família da fonte, estilo, tamanho e codificação. A caixa inferior mostra uma previsão da fonte atual para sua conveniência.

## Assistente de Novo Projeto

### Página 1

Página 1 do Assistente de Projetos
Página 1 do Assistente de Projetos

A primeira página do assistente solicita-lhe os dados básicos do projeto.

Nome do projeto

  Insira aqui o nome do projeto, como será apresentado no menu do &kbabel;.

Nome do arquivo de configuração

  Selecione aqui um arquivo para guardar a configuração do seu projeto.

Idioma

  Selecione ou insira aqui o nome do idioma usado por este projeto.

Tipo de projeto

  Selecione aqui o tipo do seu projeto.

### Página 2

Página 2 do Assistente de Projetos
Página 2 do Assistente de Projetos

A segunda página do assistente solicita as configurações relacionadas com o gerenciador de Catálogos.

Pasta base dos arquivos PO

  Selecione a pasta base onde se encontram os seus arquivos PO.

Pasta base para os arquivos POT

  Selecione a pasta base onde se encontram os seus arquivos POT.

Digite as pastas que contém todos os seus arquivos PO e os respectivos POT. Os arquivos e as pastas dentro dessas pastas serão então mesclados em uma árvore da janela do &catalogmanager;.

### Verificando as Configurações do Projeto

Como foi escrito anteriormente neste capítulo, infelizmente, o assistente é muito simples e, como tal, não solicita algumas informações importantes.

Agora que você terminou o seu projeto novo, deverá verificar as configurações principais em Projeto Configurar.... Em especial, selecione a pasta de Identidade e corrija o endereço de e-mail da equipe na Lista de correio do idioma. (A que é criada por padrão no assistente só é útil se fizer parte de um projeto da &GNU;.)

Se o projeto não for o KDE, é recomendável que você verifique a página Salvar e verifique as suas opções.

## Configurações do Projeto

Para mostrar a janela de configurações escolha a opção Projeto Configurar... do menu do &kbabel;. Ele usa uma janela de configuração estruturada que torna muito fácil encontrar uma opção sem ter que fazer uma pesquisa intensiva por ela.

O lado esquerdo do diálogo de preferências lista as categorias dos ítens personalizáveis e o lado direito mostra a correspondente aba para a categoria selecionada. O &kbabel; mantém as modificações se você mover-se entre as categorias, logo quando você estiver finalmente satisfeito clique no botão OK. A qualquer momento você pode usar a ajuda rápida — basta clicar no ponto de interrogação da barra de título e, após o cursor mudar de uma seta para uma seta com um ponto de interrogação, clicar num botão, rótulo, ou entrada de preferência para encontrar mais informações sobre ela.

As páginas de configuração do &kbabel; (o editor) e do &catalogmanager; estão na lista.

### Identidade

Esta configuração diz respeito ao &kbabel;.

Esta seção permite-lhe definir os campos padrão para cada arquivo PO traduzido. Eles são o nome, o endereço de e-mail, o nome completo do idioma, o endereço de e-mail de sua equipe de traduções. Existe também um campo de fuso-horário que lhe permite registrar a sua hora da última modificação para os arquivos PO. Você poderá indicá-lo como uma seqüência de texto do tipo EEST ou um deslocamento em relação ao GMT do tipo -0300 (&ie; para o Brasil). Esta informação é usada ao atualizar os cabeçalhos dos arquivos. Você poderá encontrar as opções que controlam os campos do cabeçalho que deverão ser atualizados na seção Salvar da janela de Preferências.

As seqüências de caracteres para os fusos-horários não são padronizadas. Por isso, você não deverá usar o texto aqui para a especificação da hora de salvamento na página Salvar. Você deverá usar o `%z` nesse caso.

Número de formas de singular/plural

  Use isto para configurar o número de formas de plural para seu idioma. Por exemplo, isto é 2 para o Português Brasileiro (uma para a forma singular e uma para a forma plural).

  Este recurso só está implementado atualmente para o formato das formas plurais usado no &kde;. Não funciona com as formas plurais do 'gettext' da &GNU;.

### Salvar

Esta configuração diz respeito ao &kbabel;.

POR FAZER Isto parece documentar apenas a página "Geral", mas não as do "Cabeçalho" e "Direitos Autorais"

Esta seção lhe permite editar as opções para salvamento de arquivos PO. O primeiro grupo de caixas de verificação controla o comportamento geral para as ações executadas no salvamento do arquivo PO.

Atualizar cabeçalho quando salvar

  Habilite este botão para atualizar as informações de cabeçalho do arquivo cada vez que ele for salvo. O cabeçalho normalmente mantém informações sobre a data e hora que o arquivo foi atualizado, o último tradutor, etc. Você pode escolher quais informações você deseja atualizar na área de caixas de verificação Campos a atualizar abaixo. Campos que não existem podem ser adicionados ao cabeçalho. Se você deseja adicionar campos ao cabeçalho você pode editar o cabeçalho manualmente escolhendo Editar Editar Cabeçalho na janela do editor.

Verificar sintaxe do arquivo ao salvar

  Assinale esta opção para verificar automaticamente a sintaxe do arquivo ao salvar, utilizando ``msgfmt` --statistics`. Você só receberá uma mensagem se ocorrer um erro. Você deve manter esta validação ativa a não ser que saiba o que está fazendo.

Se você não quiser mexer em alguns dos campos do cabeçalho do arquivo PO, ou se quiser forçar a atualização de alguns campos específicos, existem cinco opções que controlam isso: a data da revisão, o idioma do arquivo PO, a codificação do texto, o nome do último tradutor e a codificação. Se um dos campos não existir, será adicionado ao cabeçalho. Se você quiser adicionar outras informações ao cabeçalho, você terá de editá-lo manualmente, escolhendo para isso a opção Editar Editar Cabeçalho na janela do editor. Desative a opção atualizar o cabeçalho ao salvar acima, se não quiser que o cabeçalho seja atualizado.

Para a data e hora do campo do cabeçalho PO-Revision-Date (Data de Revisão do PO), você poderá escolher um dos formatos: Padrão, Local, Personalizado.

Você deverá manter a configuração Padrão. As outras duas opções fazem com que o arquivo PO gerado não seja mais um arquivo PO normal do 'gettext' da &GNU;, assim isto deverá ser evitado.

- Padrão é o formato normalmente usado em arquivos PO.

- Local é o formato especificado para seu país.

- Personalizado lhe permite definir seu próprio formato, onde você pode usar os seguintes strings no formato do estilo-C:

  Ano

  Formato | Significado | Intervalo
  --- | --- | ---
  %a | ano | 00 à 99
  %A | ano | 0001 à 9999

  Mês

  Formato | Significado | Intervalo
  --- | --- | ---
  %m | mês do ano | 01 à 12
  %f | mês do ano | 1 à 12
  %b,%h | abreviatura do mês | Jan à Dez

  Dia

  Formato | Significado | Intervalo
  --- | --- | ---
  %j | dia do ano | 001 à 366
  %d | dia do mês | 01 à 31
  %e | dia do mês | 1 à 31
  %a | abreviatura do dia da semana | Dom à Sab

  Hora

  Formato | Significado | Intervalo
  --- | --- | ---
  %H | hora | 00 à 23
  %k | hora | 0 à 23
  %i | hora | 1 à 12
  %I | hora | 01 à 12
  %p |  | AM ou PM

  Minuto, Segundo, Fuso Horário

  Formato | Significado | Intervalo
  --- | --- | ---
  %M | minuto | 00 à 59
  %S | segundo | 00 à 59
  %Z | fuso horário | (fornecido nas configurações de identidade)
  %z | fuso horário | (diferença numérica como especificada pelas configurações do sistema)

A opção para selecionar o formato de datas para o arquivo PO considera-se desatualizada e, provavelmente, será removida numa versão futura do KBabel.

O grupo inferior cobre as opções do arquivo PO ao salvar. Se você estiver trabalhando no projeto do &kde;, você precisa saber que pelo menos o arquivo `desktop.po` precisa de estar codificado em UTF-8. A lista permite-lhe selecionar a codificação das mensagens. Pelo menos, terá de constar a configuração referente ao seu idioma e o UTF-8. Se, por alguma razão, você não quiser mudar acidentalmente a codificação do arquivo PO, ative a opção Manter a codificação do arquivo.

Por razões de intercâmbio de informação, o 'gettext' da &GNU; limita as codificações permitidas para um arquivo PO. O &kbabel; ignora esta restrição, assim a codificação correspondente ao seu local poderá não ser adequada. (O UTF-8 é sempre suportado pelo 'gettext' da &GNU;.)

### Ortografia

Esta configuração diz respeito ao &kbabel;.

Aqui você pode configurar suas preferências de ortografia. Isto é para o caso de você ter um arquivo de dicionário para seu idioma de tradução. Abaixo estão os ítens para a configuração considerada:

Criar combinações de raiz/afixo não existentes no dicionário

  Para novas palavras adicionadas ao seu dicionário pessoal, o motor de verificação ortográfica criará combinações de raiz/afixo para corresponder mais de uma palavra (variações).

Considerar palavras juntas como erros ortográficos

  Se isto estiver ligado, palavras juntas são tratadas como erros. No entanto, algumas palavras são muito comuns no idioma Alemão, que possuem um grande número de palavras componentes, logo isto deve ser deixado desligado neste caso.

Dicionário

  Na lista você pode escolher qual dicionário usar. Observe que você deve instalar um dicionário apropriado para seu idioma. Verifique sua distribuição do ispell ou aspell para saber se existe um.

Codificação

  Aqui você escolhe a codificação para seu texto. Esta opção é passada para o verificador ortográfico, e é usada como a codificação para seu dicionário de palavras. Veja a documentação do kspell para mais detalhes.

  A codificação aqui selecionada não está associada às codificações dos arquivos PO. Dependendo do verificador ortográfico (especialmente no caso do `ispell`), você poderá não ter grandes escolhas para a codificação. (Por exemplo, alguns idiomas da Europa Ocidental só poderão funcionar com o `ispell`, ao usar o ISO-8859-1.)

Cliente

  Programa de backend para usar na verificação ortográfico. Atualmente pode ser tanto o `ispell` (International Ispell) ou o aspell.

Lembrar palavras ignoradas

  Mantém uma memória das palavras ignoradas pelo usuário durante a verificação ortográfica dos arquivos PO. Isto é muito conveniente para ignorar as abreviaturas ou combinações estranhas de letras que você encontra em interfaces &GUI;.

Arquivo para armazenar as palavras ignoradas

  Aqui você poderá indicar a localização do arquivo com as palavras ignoradas. Clique no ícone da pasta à direita do campo de texto. O valor padrão é o `$`HOME`/.kde/share/apps/kbabel/spellignores`, em que a `$`HOME`` é a sua pasta pessoal.

### Referência de origem

Esta configuração diz respeito ao &kbabel;.

Configurações do Projeto, referência da origem
Configurações do Projeto, referência da origem

Esta janela serve para configurar a forma como o KBabel deverá construir a localização completa para cada referência de origem, referência essa que está descrita no comentário de cada item de um arquivo PO.

#### Elementos da janela

No campo de texto Pasta base do código-fonte, você poderá definir uma pasta base onde se encontra o código-fonte do seu projeto. Isto define o valor da variável `@CODEROOT@`, que está descrito abaixo.

No grupo de Padrões de Localização, você poderá definir padrões ou regras para construir as localizações, com a ajuda de algumas variáveis: a `@CODEROOT@`, a `@PACKAGEDIR@`, a `@PACKAGE@`, a `@COMMENTPATH@`, a `@POFILEDIR@`, que estão descritas abaixo.

A variável `@PODIRFILE@` foi introduzida no &kbabel; versão 1.11.1 (para o &kde; 3.5.1).

Com o botão Adicionar, você poderá acrescentar a linha do campo de texto à lista de padrões usados. Com o botão Remover, poderá retirar o padrão selecionado da lista. Com os botões Subir e Descer, você poderá alterar a prioridade dos padrões de localizações.

#### As variáveis

- `@CODEROOT@`: A pasta base do código-fonte.

- `@PACKAGEDIR@`: A pasta do pacote (i.e., do arquivo PO).

- `@PACKAGE@`: O nome do pacote (i.e. nome do arquivo PO sem extensão).

- `@POFILEDIR@`: A pasta do arquivo PO.

- `@COMMENTPATH@`: O local relativo, dado como referência de origem no comentário de um item do arquivo PO.

As variáveis `@PACKAGEDIR@` e `@POFILEDIR@` possuem um significado semelhante, mas nem sempre o mesmo resultado. A variável `@POFILEDIR@` terá sempre a pasta do arquivo PO, enquanto o `@PACKAGEDIR@` poderá não ter. Se o arquivo PO foi carregado com a ajuda do &catalogmanager;, o `@PACKAGEDIR@` terá só a parte da pasta, com base na pasta de base do PO, definida para o &catalogmanager; (veja abaixo).

As variáveis `@CODEROOT@` e `@POFILEDIR@` só poderão ser usados no início de um padrão para serem úteis. A variável `@COMMENTPATH@` só poderá ser usada no fim de um padrão, e é praticamente obrigatória. As variáveis `@PACKAGEDIR@` e `@POFILEDIR@` não deverão ser usadas no mesmo padrão. As variáveis `@CODEROOT@` e `@POFILEDIR@` também não deverão ser usados no mesmo padrão.

#### Os padrões de localizações pré-definidos

Desde o &kbabel; 1.11.1 (do &kde; 3.5.1), passaram a existir cinco padrões de localizações pré-definidos:

- `@PACKAGEDIR@`/`@PACKAGE@`/`@COMMENTPATH@`

- `@CODEROOT@`/`@PACKAGEDIR@`/`@PACKAGE@`/`@COMMENTPATH@`

- `@CODEROOT@`/`@PACKAGE@`/`@COMMENTPATH@`

- `@POFILEDIR@`/`@COMMENTPATH@`

- `@POFILEDIR@`/../`@COMMENTPATH@`

Os projetos do &kde; necessitam tipicamente do terceiro padrão. O último padrão é típico dos projetos da &GNU;, onde as referências de origem são relacionadas com o pai da pasta em que se encontra o arquivo PO.

#### Criando Novos Padrões de Localização

Na maioria dos casos, os padrões de localização pré-definidos deverão ser suficientes, quer o projeto seja para o KDE (assumindo que tenha definido a pasta de base correta) quer se for um da &GNU; (ou com uma estrutura de projeto da &GNU;).

No caso do &kde;, alguns arquivos PO não possuem informações suficientes (incluindo o local e o nome do arquivo) do &kbabel; para encontrar o arquivo de origem correto que supostamente referencia. Para corrigir isso, você precisará de padrões de localizações precisos para esses arquivos, o que é praticamente impossível de definir, pela quantidade destes arquivos no &kde;. Mas se lidar freqüentemente com um desses arquivos, poderá valer a pena definir um padrão de localização explicitamente para suportar esse arquivo PO.

Para criar os seus próprios padrões de localizações, você poderá usar as variáveis definidas acima, se bem que, fora o `@COMMENTPATH@`, não existem mais variáveis obrigatórias. Para ser mais exato, o `@COMMENTPATH@` também não é obrigatório, mas se não usá-lo, provavelmente não irá obter resultados.)

Um exemplo de padrões de localizações poderá ocorrer quando você desejar mostrar a referência de origem do arquivo do &kde; 'desktop_kdebase.po'. No caso de necessitar de um padrão de localizações do tipo: `@CODEROOT@`/`@PACKAGEDIR@`/kdebase/`@COMMENTPATH@` (em comparação com um dos padrões de localização pré-definidos, a seqüência `@PACKAGE@` foi substituída por 'kdebase').

No caso de problemas realmente complexos você poderá, obviamente, definir uma localização absoluta sem quaisquer variáveis, além da `@COMMENTPATH@`, como por exemplo: '/home/usuario/codigo-kde/kdebase/`@COMMENTPATH@`', assumindo que a '/home/usuario/codigo-kde/kdebase' é o local onde o módulo de código 'kdebase' se encontra.

### Miscelânea

Esta configuração diz respeito ao &kbabel;.

A seção Diversos contém as opções do &kbabel; que não se encaixam em mais nenhum lugar.

Marca do acelerador de teclado

  Aqui você pode selecionar seu próprio caracter para servir como indicador de acelerador de teclado numa &GUI;. Por padrão é o & (ampersand), mas em algumas ferramentas de programação isto pode variar. Por exemplo, nas traduções Gnome/GTK o caracter sublinhado _ é a marca para o acelerador de teclado.

Expressão regular para informação de contexto

  Para usuários inexperientes "expressão regular" pode soar estranho. No entanto, você será alertado para mudar o valor padrão somente se você souber o que está fazendo. Algumas ferramentas de programação de &GUI; fornecem seus próprios métodos de descrição de informações de contexto. Consulte um desenvolvedor experiente se você traduz arquivos PO diferentes dos arquivos &kde; padrão. Para ser mais exato eu "traduzirei" para você o que a expressão regular padrão significa: "o texto corresponde se ele inicia com _: e é seguido por um ou mais caracteres e termina com uma nova linha".

### Pastas do projeto

Esta configuração diz respeito ao &catalogmanager;.

Aqui estão dois campos de texto com botões de pastas. Indique as pastas que contém todos os seus arquivos PO e os respectivos POT. Os arquivos e as pastas dentro dessas pastas serão então mesclados em uma árvore da janela do gerenciador de Catálogo.

Abaixo você pode tanto desligar como ligar:

Abrir arquivos numa nova janela

  Se isto estiver ativado todos os arquivos que serão abertos a partir do Gerenciador de Catálogo serão abertos numa nova janela.

Matar processos ao sair

  Se você habilitar isto o &kbabel; tenta matar os processos que não foram terminados quando o programa fechar, enviando um sinal de kill para eles.

  Isto não é uma garantia que os processos serão mortos.

Criar índice para o conteúdo do arquivo

  Se você habilitar isto o &kbabel; criará um índice para cada arquivo na árvore. Este índice é então usado nas operações de procura/substituição.

  Há uma grande velocidade nestas operações. Se você habilitar Criar índice para conteúdo do arquivo, a atualização das informações dos arquivos será bem menor. Por outro lado, as operações de procura/substituição aumentam de velocidade consideravelmente.

### Comandos de Pasta

Esta configuração diz respeito ao &catalogmanager;.

Configurações do Projeto, comandos de pastas
Configurações do Projeto, comandos de pastas

Aqui você pode inserir comandos que você deseja executar nas pastas do Gerenciador de Catálogo. Os comandos são mostrados no submenu Comandos no menu de contexto do Gerenciador de Catálogo.

Insira no campo Legenda do Comando o nome do comando. O nome poderá ser escolhido livremente e só é usado para ser apresentado no menu. No campo Comando, insira o comando que você deseja executar quando selecionar o item de menu correspondente. Clique depois no botão Adicionar para adicionar o comando aos já disponíveis. Para editar um comando, selecione-o, clique em Editar e depois em Adicionar, depois de ter terminado. Para remover um comando, selecione-o na lista e clique no botão Remover. Se você quiser uma ordem diferente no sub-menu de contexto, você poderá usar os botões para subir e descer.

O comando é executado pelo seu shell padrão, logo você pode executar comandos múltiplos ao mesmo tempo separando-os com um ponto e vírgula, e você pode configurar variáveis de ambiente, se necessário. Os comandos são executados na pasta (de arquivo PO) pasta que você selecionar no Gerenciador de Catálogo.

Os seguintes strings serão substituídos num comando:

- `@PACKAGE@`: O nome da pasta sem caminho

- `@PODIR@`: O nome da pasta `PO` com caminho

- `@POTDIR@`: O nome da pasta de modelos com caminho

Por exemplo: Se você deseja executar `make` e então `make install` você pode inserir `Make install` no campo Nome, e `make; make install` no campo Comando. Se você então selecionar Comandos Make install no menu de contexto para uma pasta, o comando listado acima será executado nesta pasta.

### Comandos de Arquivo

Esta configuração diz respeito ao &catalogmanager;.

Configurações do Projeto, comandos de arquivos
Configurações do Projeto, comandos de arquivos

Aqui você pode inserir os comandos que você deseja executar em arquivos a partir do Gerenciador de Catálogo. Os comandos são então mostrados no submenu Comandos no menu de contexto do Gerenciador de Catálogo.

Insira no campo Legenda do Comando o nome do comando. O nome poderá ser escolhido livremente e só é usado para ser apresentado no menu. No campo Comando, introduza o comando que você deseja executar quando selecionar o item de menu correspondente. Clique depois no botão Adicionar para adicionar o comando aos já disponíveis. Para editar um comando, selecione-o, clique em Editar e depois em Adicionar, depois de ter terminado. Para remover um comando, selecione-o na lista e clique no botão Remover. Se você quiser uma ordem diferente no menu de contexto, você poderá usar os botões para subir e descer.

O comando é executado pelo seu shell padrão, logo você pode executar comandos múltiplos ao mesmo tempo separando-os com um ponto e vírgula, e você pode configurar variáveis de ambiente, se necessário. Os comandos são executados na pasta (de arquivo PO) que você selecionar no Gerenciador de Catálogo.

Os seguintes strings serão substituídos num comando:

- `@PACKAGE@`: O nome do arquivo sem caminho e extensão

- `@POFILE@`: O nome do arquivo `PO` com caminho e extensão

- `@POTFILE@`: O nome do arquivo de modelo correspondente com caminho e extensão

- `@PODIR@`: O nome da pasta, onde arquivo `PO` está, com caminho

- `@POTDIR@`: O nome da pasta, onde o arquivo modelo está, com caminho

Por exemplo, se você deseja mesclar o arquivo modelo em seu arquivo PO você pode inserir no campo Nome `Mesclar` e no campo Comando `msgmerge @POFILE@ @POTFILE@ > @PACKAGE@.new && mv @PACKAGE@.new "@PACKAGE@.po`. Se você então selecionar Comandos Mesclar no menu de contexto do arquivo, o arquivo PO será mesclado com seu arquivo de modelo.

### Gerenciador de Catálogos

Esta configuração diz respeito ao &catalogmanager;.

Configurações do Projeto, &catalogmanager;
Configurações do Projeto, &catalogmanager;

As opções ativam ou desativam a coluna correspondente à área do &catalogmanager;.

### Diferenças

Esta configuração diz respeito ao &catalogmanager;.

Configurações do Projeto, diferenças
Configurações do Projeto, diferenças

A FAZER