Letöltések

New Book: GnuCash 2.4 Small Business Accounting

GnuCash 2.4 small business accounting

The GnuCash development team received notice about a new book published by PacktPub, UK:

GnuCash 2.4 Small Business Accounting, by Ashok Ramachandran.

This is a Beginner's Guide for managing your accounts.

Our own developer Christian Stimming has been contributing to this book as a reviewer, and we can wholeheartly recommend the outcome of this fruitful collaboration. Feel free to have a look at this book over at packtpub.com, and, best of all, the publisher has committed to allocate some percentage of the book sales back to the GnuCash project. Have fun with this book!

Writing GnuCash Documentation

If you are interested in improving the GnuCash documentation, you have come to the right place. This page will provide you with the necessary information to get started.

Just as the GnuCash application has been developed over time by volunteers, so too has the documentation been written by volunteer developers and users to help others learn how GnuCash works. This collaborative effort has resulted in the creation of two major documents, the Help Manual and the Tutorial and Concepts Guide.

The GnuCash community welcomes assistance in maintaining and improving both the program and its documentation. If you are interested in helping write, edit or translate GnuCash's documentation, this page gives guidance on how to get set up to join the effort.

The GnuCash documentation can be viewed and downloaded from the Documentation page.

Introduction

The GnuCash documentation is stored in xml files. More precisely, it uses the GNOME2 XML docbook system. This is a relatively flexible system that takes xml files as input and can generate documentation in several different output formats (html, pdf,...).

If you wish to review or write GnuCash documentation, you will need to know xml. Some basic knowledge of the docbook system may be useful as well

The following links are for further sites that can help with the documentation and review process.

We suggest also subscribing to gnucash-devel.

Gnome Documentation guidelines

As stated earlier, the new docs are based on the GNOME2 XML docbook system. Everyone wishing to help please follow these guides where possible when reviewing and/or writing docs.

Hol található a dokumentáció forrása

You will need a recent copy of the documentation source. For this you can check out the documentation module from the gnucash-docs git repository. Reviewers could also start from the current docs tarball.

For those not familiar with git, the GnuCash wiki has a description tailored to the GnuCash code. To get the documentation source instead of the program source, replace 'gnucash' with 'gnucash-docs' in the mentioned git commands, like this:

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

There are two major GnuCash documentation packages to help users: the Help Manual and the Tutorial and Concepts Guide. With the above command, the source code of both will be downloaded.

szerkesztők

Get a copy of the documentation source as described above and start making changes. When you are satisfied with your changes you can create a patch by running the following command in the base directory of the documentation (usually gnucash-docs, unless you renamed it):

git diff > my-patch-name.patch

Next attach your patch to a bug report against the documentation component for the GnuCash project in Gnome's bugzilla database and send an email to gnucash-devel mailing list to inform other developers on your work. See also GnuCash' wiki page on bugzilla for more details about patch submission.

NOTE: It used to be ok also to send your patch directly to the gnucash-devel list. This is discouraged now, as a patch is easily forgotten between the many list discussions. Attach patches to bugs in Bugzilla instead (either an existing bug or a new one). If you insist on sending a patch to gnucash-devel, it should be attached, not inlined.

Please let other writers know which section you wish to tackle. Please forward this to gnucash-devel so that people can say 'hey I'm doing that already' or 'go ahead and do it'.

You may also want to retain a local copy of the old documentation to refer to when writing. This still has a lot of useful information in it which hasn't been transferred to the new docs

Reviewers

Get a copy of the documentation source as described above and start commenting on it.

The best way of retaining comments about docs in an easy to find way for everyone would be to use bugzilla.gnome.org to file the bugs under documentation. This can also be done using bug-buddy.

Valid XHTML + RDFa

Copyright © 2001-2014 The GnuCash Project

Server & email outage reports to: gnucash-devel@gnucash.org

Fordítási problémák? Kapcsolat: gnucash-devel@gnucash.org