Exemplos

Exemplo de como iniciar uma tradução

O idioma francês será usado como exemplo:

   git pull
   cd webwml
   mkdir french
   cd french
   cp ../english/.wmlrc ../english/Make.* .
   echo 'include $(subst webwml/french,webwml/english,$(CURDIR))/Makefile' > Makefile
   mkdir po
   git add Make* .wmlrc
   cp Makefile po
   make -C po init-po
   git add po/Makefile po/*.fr.po

Edite o arquivo .wmlrc e altere:

'-D CUR_LANG=English' para '-D CUR_LANG=French'
'-D CUR_ISO_LANG=en' para '-D CUR_ISO_LANG=fr'
'-D CUR_LOCALE=en_US' para '-D CUR_LOCALE=fr_FR'
'-D CHARSET=iso-8859-1' para o que for apropriado.
O francês coincidentemente usa a mesma codificação de caracteres que o inglês, logo nenhuma alteração é necessária. Contudo, é provável que novos idiomas precisem ter essa configuração ajustada.

Edite o Make.lang e altere 'LANGUAGE := en' para 'LANGUAGE := fr'. Caso esteja traduzindo para um idioma que usa um conjunto de caracteres multi-byte, pode ser necessário alterar algumas outras variáveis nesse arquivo. Para mais informações leia ../Makefile.common e talvez outros exemplos funcionais (traduções como a chinesa).

Vá para french/po e traduza as entradas nos arquivos PO. Isso deve ser bastante simples.

Sempre certifique-se de copiar o Makefile para cada diretório que você traduzir. Isso é necessário porque o programa make é usado para converter os arquivos .wml em HTML, e o make usa Makefiles.

Quando terminar de adicionar e editar as páginas, faça um

   git commit -m "Adicione aqui uma messagem de commit"
   git push

a partir do diretório webwml. Você agora pode começar a traduzir as páginas.

Exemplo de tradução de uma página

Uma tradução francesa do contrato social será usada como exemplo:

   cd webwml
   ./copypage.pl english/social_contract.wml
   cd french

Isso irá automaticamente adicionar o cabeçalho translation-check, apontando para a versão do arquivo original que foi copiado. Isso também cria o diretório de destino e o Makefile, se estiver faltando.

Edite o arquivo social_contract.wml e traduza o texto. Não tente traduzir quaisquer links ou alterá-los de qualquer modo - se você deseja mudar alguma coisa, solicite-a na lista debian-www. Quando terminar, execute

   git add social_contract.wml
   git commit -m "Translated social contract to french"
   git push

Exemplo da adição de um novo diretório

Este exemplo mostra a adição do diretório intro/ na tradução francesa:

   cd webwml/french
   mkdir intro
   cd intro
   cp ../Makefile .
   git add Makefile
   git commit -m "added the intro dir to git"
   git push

Certifique-se que o novo diretório tem o Makefile e que seu commit foi feito no git. Caso contrário, executar o make dará um erro para todos os outros que tentarem.

Exemplo de um conflito

Este exemplo mostra um commit que não funcionará porque a cópia do repositório foi modificada desde seu último git pull.

Você realizou algumas alterações no arquivo foo.wml. Então:

   git add foo.wml
   git commit -m "fixed a broken link"
   git push

a saída será:

To salsa.debian.org:webmaster-team/webwml.git
 ! [rejected]                master -> master (fetch first)
error: failed to push some refs to 'git@salsa.debian.org:webmaster-team/webwml.git'

ou algo semelhante :)

Isso significa que suas alterações não foram enviadas para o repositório git, devido a conflitos.
Você precisará examinar o que deu errado, resolver os conflitos e tentar commit/push novamente.