Transferências

Novo livro: GnuCash 2.4 Small Business Accounting

GnuCash 2.4 small business accounting

A equipa de desenvolvimento do GnuCash recebeu notícias sobre um novo livro publicado por PacktPub, UK:

GnuCash 2.4 Small Business Accounting, by Ashok Ramachandran.

Este é um guia do principiante para gerir as suas contas.

O nosso próprio programador Christian Stimming tem contribuído para este livro como revisor e podemos apaixonadamente recomendar o resultado desta frutuosa colaboração. Sinta-se à vontade para espreitar este livro em packtpub.com e, o melhor de tudo, a editora comprometeu-se a doar uma percentagem das vendas do livro ao projeto GnuCash. Divirta-se com este livro!

Escrever documentação do GnuCash

Se está interessado em melhorar a documentação do GnuCash, veio ao sítio certo. Esta página fornece-lhe toda a informação necessária para começar..

Assim como a aplicação GnuCash foi desenvolvida por voluntários ao longo dos anos, também a documentação foi escrita por voluntários e utilizadores para ajudar outros a aprender como o GnuCash funciona. Este esforço colaborativo resultou na criação de dois documentos principais, o Manual de ajuda e o Tutorial e guia de conceitos.

A comunidade GnuCash agradece a ajuda na manutenção e melhoramento tanto do programa como da documentação. Se está interessado em escrever, editar ou traduzir a documentação do GnuCash, esta página orienta-o no sentido de se juntar a este esforço.

A documentação do GnuCash pode ser vista e transferida da página de documentação.

Introdução

A documentação do GnuCash está armazenada em ficheiros xml. Mais precisamente, utiliza o sistema GNOME" XML docbook. Este é um sistema relativamente flexível que recebe ficheiros xml como entrada e pode gerar documentação em vários formatos de saída (html, pdf,...).

Se quiser rever ou escrever documentação do GnuCash, terá de saber xml. Alguns conhecimentos básicos do sistema docbook também serão úteis.

As ligações seguintes são para mais páginas que podem ajudar com a documentação e o processo de revisão:

Também sugerimos que subscreva a lista gnucash-devel.

Linhas guia da documentação Gnome

Tal como já foi dito, a nova documentação é baseada no sistema GNOME2 WML docbook. Todos os que queiram ajudar, por favor sigam estes guias sempre que possível ao rever e/ou escrever documentação:

Onde obter a fonte da documentação

Necessitará de uma cópia recente da fonte da documentação. Para tal, pode transferir o módulo de documentação do repositório git gnucash-docs. Os revisores também podem começar a partir do tarball atual de documentação.

Para quem não está familiarizado com o git, a wiki do GnuCash tem uma descrição adaptada ao código do GnuCash. Para obter a fonte da documentação em vez da fonte do programa, substitua 'gnucash' por 'gnucash-docs' nos comandos git mencionados, assim:

git clone https://github.com/Gnucash/gnucash-docs.git

Há dois pacotes principais de documentação do GnuCash para ajudar os utilizadores: o Manual de ajuda e o Tutorial e guia de conceitos. Com o comando acima, transfere o código fonte de ambos.

Escritores

Obtenha uma cópia da fonte de documentação como descrito acima e comece a fazer alterações. Quando estiver satisfeito com o resultado, pode criar um patch executando o seguinte comando na pasta base da documentação (habitualmente gnucash-docs, se não a renomeou):

git diff > my-patch-name.patch

A seguir, anexe o seu patch num relatório de erro sobre o componente "Documentation" do projeto GnuCash na base de dados do Bugzilla do Gnome e envie um email à lista de correio gnucash-devel para informar os programadores sobre o seu trabalho. Veja também a página wiki do GnuCash no Bugzilla para mais detalhes sobre submissão de patches.

Nota: costumava ser correto enviar o patch diretamente para a lista gbucash-devel. Agora é desencorajado, dado que um patch é facilmente esquecido entre as muitas discussões da lista. Anexe antes os patches a erros no Bugzilla (ou a um relatório existente ou a um novo). Se insistir em enviar o patch para a lista gnucash-devel, anexe-o, não o insira em linha.

Por favor, avise os outros escritores sobre que secção vai trabalhar. Encaminhe este aviso para a lista gnucash-devel para que as pessoas possam dizer 'Eh, eu já estou a trabalhar nisso' ou 'Força, ande com isso'.

Pode também querer conservar uma cópia antiga da documentação, para referência enquanto escreve. Ainda tem muita informação útil que não foi transferida para a nova documentação.

Revisores

Obtenha uma cópia da fonte de documentação tal como descrito acima e comece a comentá-la.

A melhor forma de manter comentários sobre documentação com um acesso fácil para todos é usar o bugzilla para reportar os erros sob "Documentation". Também o pode fazer através do bug-buddy.

Valid XHTML + RDFa

Copyright © 2001-2017 The GnuCash Project

Relatórios de saída de servidor & email para: gnucash-devel@gnucash.org

Problemas de tradução? Contacto: gnucash-devel@gnucash.org