Downloaden

Nieuw boek: GnuCash 2.4 Small Business Accounting

GnuCash 2.4 small business accounting

Het GnuCash ontwikkelteam ontving bericht over een nieuw boek, uitgegeven door PacktPub (UK):

GnuCash 2.4 Small Business Accounting, geschreven door Ashok Ramachandran.

Deze handleiding voor het beheren van uw rekeningen is geschreven voor beginners.

Onze eigen ontwikkelaar Christian Stimming heeft als proeflezer bijgedragen aan dit boek; wij kunnen de uitkomst van deze vruchtbare samenwerking van harte aanbevelen. Daarnaast heeft de uitgever toegezegd om een zeker percentage van de verkoopopbrengst ten gunste van het GnuCash-project te laten komen. Neem dus vooral even een kijkje op packtpub.com!

GnuCash-documentatie schrijven

Als u geïnteresseerd bent in het verbeteren van de GnuCash-documentatie, bent u hier aan het juiste adres. Deze pagina verschaft u de nodige informatie om te beginnen.

De documentatie is, net als de GnuCash-applicatie zelf, vrijwillig geschreven door ontwikkelaars en gebruikers om anderen te helpen te leren hoe GnuCash werkt. Dit samenwerkingsverband heeft twee belangrijke documenten opgeleverd, de Handleiding en de Conceptengids.

De GnuCash-gemeenschap verwelkomt hulp bij het onderhouden en verbeteren van zowel het programma als de bijbehorende documentatie. Als u geïnteresseerd bent in het helpen schrijven, bewerken of vertalen van de documentatie van GnuCash, helpt deze pagina u op weg om mee te doen.

De GnuCash-documentatie kan worden bekeken en gedownload van de Documentatie- pagina.

Introductie

De GnuCash documentatie wordt opgeslagen als XML-bestanden. Meer specifiek: de documentatie gebruikt het GNOME2 XML docbook-systeem, een relatief flexibel systeem dat op basis van XML-bestanden documentatie in verschillende vormen (html, pdf, ...) kan aanbieden.

Als je wil helpen met het schrijven of recenseren van GnuCash documentatie, zal je eerst met XML overweg moeten kunnen. Elementaire kennis van het docbook-systeem kan ook handig zijn

De volgende koppelingen verwijzen naar overige sites die kunnen helpen bij het documentatie- en reviewproces.

Ook adviseren wij u zich te abonneren op gnucash-devel.

Documentatierichtlijnen van Gnome

Zoals eerder vermeld is de nieuwe documentatie gebaseerd op het GNOME2 XML docbook-systeem. Iedereen die wil helpen met het schrijven en/of reviewen van de documentatie verzoeken wij om deze richtlijnen waar mogelijk te volgen.

Waar vind ik de documentatiebestanden

Je hebt een recente kopie van de documentatiebestanden nodig. Hiervoor kun je de documentatie-module uitchecken uit de GnuCash git repository. Recensenten kunnen ook vertrekken van de huidige documentatie-tarball.

Wie niet vertrouwd is met git: de GnuCash wiki heeft een toelichting, helemaal toegespitst op de GnuCash-code. Om de documentatiebestanden te krijgen in plaats van de broncode van het programma moet je 'gnucash' in de genoemde commando's vervangen door 'gnucash-docs', zoals dit:

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

Er zijn twee belangrijke GnuCash-documenten om gebruikers te helpen: de Handleiding en de Conceptengids. Met het bovenstaand commando wordt voor allebei de broncode gedownload.

Schrijvers

Maak een eigen kopie van de documentatiebestanden zoals hierboven beschreven en pas deze aan. Als je tevreden bent over de wijzigingen maak je een patchbestand door het volgende commando uit te voeren in de basismap van de documentatie (normaal gesproken gnucash-docs, tenzij je de naam hebt gewijzigd):

git diff > my-patch-name.patch

Vervolgens hang je de patch als bijlage aan een bugrapport voor de geschikte component van het "Documentation" produkt in de Bugzilla-databank van GnuCash. Voor meer details over het inzenden van patches kan je ook de GnuCash wiki pagina over Bugzilla doorlezen.

Opmerking: Hoewel dit vroeger gebruikelijk was, wordt het tegenwoordig afgeraden om je patch rechtstreeks naar de gnucash-devel mailinglijst te sturen. Door de patch aan een (nieuw of bestaand) bugrapport in Bugzilla te hangen wordt voorkomen dat de patch zoekraakt tussen alle discussies op de lijst. Als je er echt op staat om de patch naar de mailinglijst te sturen, doe het dan als bijlage, niet in de tekst van de e-mail zelf.

Laat ook aan andere schrijvers weten met welke sectie je aan de slag gaat door een e-mail te sturen naar gnucash-devel. Op die manier kunnen we dubbel werk zoveel mogelijk voorkomen.

Het is wellicht ook interessant om een lokale kopie te bewaren van de oude documentatie om dingen op te zoeken tijdens het schrijven. Deze bevat nog veel nuttige informatie die niet overgenomen is in de nieuwe documentatie

Reviewers

Maak een eigen kopie van de documentatiebestanden zoals hierboven beschreven en begin met het leveren van opmerkingen.

Deze opmerkingen moeten natuurlijk zodanig bewaard worden dat ze voor iedereen makkelijk terug te vinden zijn. De beste manier om dit te doen is om deze als bugreports in te dienen op bugs.gnucash.org (categorie: 'documentation'). Dit kan ook via het programma Bug-buddy.

Valid XHTML + RDFa

Copyright © 2001-2018 The GnuCash Project

Storingsmeldingen server & e-mail naar: gnucash-devel@gnucash.org

Vertaalproblemen? Meld het op: gnucash-devel@gnucash.org