| Informações | CVS |
Ferramentas e Configuração
As ferramentas que você precisa dependem do sistema operacional que você utiliza, basicamente são as mesmas ferramentas em versões diferentes.
Importante: estas ferramentas são mais importantes a partir do ponto onde você tenha uma conta de cvs e possa alterar diretamente o manual. Caso você não utilize uma conta de cvs tudo pode ser mais simples. Bastando que você tenha apenas um editor de texto. Todas as outras ferramentas podem ser deixadas de lado até que você tenha mais intimidade com o funcionamento da tradução.
Você precisa de um editor de texto puro (de preferência com destaque para xml), um programa de cliente para o cvs, e as ferramentas necessárias para compilar o manual
Ferramentas para o Linux
Estas ferramentas são para a geração do manual, isto é, converter os arquivos XML para HTML. Provavelmente você já tenha algumas destas ferramentas instaladas. Basicamente você precisa dos arquivos do docbook e do jade. A maneira mais simples é procurar nos CDs da distribuição os arquivos sobre o jade ou openjade, a parte de docbook e de sgml.
Você também terá que instalar o CVS, que é utilizado para receber e enviar os arquivos originais e traduzidos. Você pode encontrar maiores detalhes de como usar o cvs em http://www.cvshome.org. Existem clientes gráficos para o CVS no Linux como por exemplo o Cervisia(faz parte do KDE) embora eu mesmo nunca tenha utilizado ele.
Para editar os arquivos XML, você pode utilizar qualquer editor de texto puro, por exemplo, o mesmo que você utilize para editar os seus scripts.
Ferramentas para Windows
O ambiente para se trabalhar com a tradução do manual é baseado em linux, embora existam as ferramentas e meios de se fazer o mesmo em windows(como eu mesmo fazia...). As ferramentas são as mesmas, apenas que em suas versões para windows.
CVS: você vai precisar de um cliente de cvs, você poderá encontrar um em http://www.cvshome.org. Existem também otimas ferramentas gráficas como o TortoiseCVS e o winCVS.
Quanto ao editor para os arquivos xml é uma questão de preferência pessoal, você pode encontar uma descrição mais detalhada na seção sobre os editores de texto.
Se você quiser gerar o manual em sua casa você precisará de algumas outras ferramentas. Se você ainda não tiver conta de CVS isso não é tão importante, mas se você tiver conta de isso é importante.
Você vai precisar do cygwin e do Jade. No cygwin você poderá escolher vários pacotes para instalar e infelizmente não existe uma lista mínima do que deve ser instalado. Você vai precisar de pacotes como o perl, autoconf e make. O que pode acontecer é você instalar vários pacotes e sua instalação fique grande, se você não tiver problemas de espaço não se preocupe.
Instalando as ferramentas
Para instalar o cygwin, você deverá executar o arquivo setup.exe, que você encontra no site do cygwin. Você terá que escolher vários pacotes para instalar e infelizmente não temos uma lista que contenha apenas o necessário, assim você deverá instalar o padrão do cygwin e pelo menos adicionar o autoconf(que irá adicionar outros pacotes como o perl) e o make. Ele irá fazer o download dos pacotes pela internet e instala-los.
Você agora deve criar um diretório para conter a documentação e as ferramentas. Recomendo criar um diretório chamado phpdoc dentro do seu drive C:. Dentro deste diretório você deve criar um novo diretório com o nome de phpdoc-tools (deve ter esse nome obrigatoriamente). Dentro deste diretório recem criado, crie um diretório chamado jade. Descompacte aqui dentro os arquivos do jade.
Você precisa também do PHP. No windows você deverá criar um arquivo com o nome php.bat que deverá estar dentro do diretório phpdoc-tools. Ele deve ter o seguinte conteúdo:
@"C:\php\cli\php.exe" %1 %2 %3 %4 %5 %6 %7 %8 %9
Talvés seja necessário mudar o caminho para onde o seu PHP esta instalado. A sua estrutura dos diretórios deve ser assim:
+--phpdoc-tools | +--jade | | | \--jade.exe (etc) | \--php.bat
Depois você deve abri-lo clicando em "Cygwin Bash Shell" no seu menu iniciar. Vai abrir um prompt de comando, semelhante ao DOS. Lá você deve:
autoconf ./configure --with-lang=pt_BR
| Informações | CVS |
| Indice | |