Gestinux Wiki - User contributions [en]

UnexpectedError

2013-02-04T20:35:58Z

HowardPC:

{{#CustomTitle:An unexpected error occurred}}

== You encountered an unexpected error ==

The Gestinux program failed to gracefully handle an unexpected condition.

We try to foresee every possible eventuality, and show an appropriate message explaining the error condition, but it is possible that you have encountered a type of error that has never arisen before.

Please tell us about the issue you have. Check that you are definitely using the [[CurrentVersion|latest release]], and give the developers as much information as you can, including details of your operating system (Windows, Linux...), and the steps that led up to the error. Give your feedback:

* either directly in the [https://sourceforge.net/tracker/?group_id=320994&atid=1349206 bug tracker]
* or, if you find that too complex, by writing in the [http://gestinux.net/forum/viewforum.php?f=8 help forum].

Thank you for your patience and for helping to improve Gestinux.

UnexpectedError

2013-02-04T20:35:14Z

HowardPC:

{{#CustomTitle:An unexpected error occurred}}

== You encountered an unexpected error ==

The Gestinux program failed to gracefully handle an unexpected condition.

We try to foresee every possible eventuality, and show an appropriate message explaining the error condition, but it is possible that you have encountered a type of error that has never arisen before.

Please tell us about the issue you have. Checking that you were using the [[CurrentVersion|latest release]], and give the developers as much information as you can, including details of your operating system (Windows, Linux...), and the steps that led up to the error. Give your feedback:

* either directly in the [https://sourceforge.net/tracker/?group_id=320994&atid=1349206 bug tracker]
* or, if you find that too complex, by writing in the [http://gestinux.net/forum/viewforum.php?f=8 help forum].

Thank you for your patience and for helping to improve Gestinux.

UnexpectedError

2013-02-04T20:34:03Z

HowardPC: minor edit

{{#CustomTitle:An unexpected error occurred}}

== You encountered an unexpected error ==

The Gestinux program failed to gracefully handle an unexpected condition.

We try to foresee every possible eventuality, and show an appropriate message explaining the error condition, but it is possible that some types of error have not ever arisen before.

Please tell us about the issue you have. Checking that you were using the [[CurrentVersion|latest release]], and give the developers as much information as you can, including details of your operating system (Windows, Linux...), and the steps that led up to the error. Give your feedback:

* either directly in the [https://sourceforge.net/tracker/?group_id=320994&atid=1349206 bug tracker]
* or, if you find that too complex, by writing in the [http://gestinux.net/forum/viewforum.php?f=8 help forum].

Thank you for your patience and for helping to improve Gestinux.

Translating

2013-02-04T16:18:57Z

HowardPC: /* Initial translation of the French page into English */

{{#CustomTitle:How to translate Gestinux}}

This page explains how to translate Gestinux without knowing much about Pascal or other programming languages or the Lazarus IDE.

We ask that you translate only into your native language. Ideally, you should understand French because Gestinux was originally written in French.

== Where do you start translating, and what should you then move on to translate thereafter? ==

Ideally, you should start [[Translating / en # translate software | to translate the software]] itself, before starting to translate any documentation.

The translated software will be used to [[Translating / en # Provide translations Policy | create a set of test data]] and make fresh screenshots showing the newly translated language.

Then you can gradually [[Translating / en # Translate documentation | translate the documentation]].

== Translating the software ==

Only version 1.0 of Gestinux needs to be translated. The following paragraphs cover the various steps involved in completing your translation task.

If you understand English, you can consult the [[internationalization Programming | internal translation mechanism]] for more information.

=== The code for your language ===

Before starting a new translation, you must discover what code applies to the language you are translating.

Languages are identified in accordance with standard Gestinux [http://www.gnu.org/software/gettext/manual/html_node/Locale-Names.html POSIX] codes, which all have the double xx_YY format.

The lowercase xx part of the code identifies the primary language, according to the [http://fr.wikipedia.org/wiki/Liste_des_codes_ISO_639-2 ISO-639-1] standard.
The uppercase YY part identifies any possible language variant (usually with a country code), according to the [ISO-3166 http://fr.wikipedia.org/wiki/ISO_3166-1] standard.

You should use the referenced ISO codes. If you invent a new code, the risk is that they may be formalized differently later.

Language code examples:

* Fr_FR: French "de France"
* Fr_CA: Quebec
* En_US: English (United States of America)
* Sv_SE: Sweden "Sweden"

If you are in any doubt, ask for confirmation on the [http://gestinux.net/forum/viewforum.php?f=2 forum].

=== The source file to translate ===

Gestinux 1.0 supports translations in a "text" xx_YY.ini file.

In general, these files are in a folder named ''languages'' at the same level as the executable Gestinux.
However, to comply with Debian Linux rules (including Ubuntu), the files for these distributions are in / usr / share / gestinux / languages

These files are installed as write-only. Do not try to modify or unprotect them at this location. If you want to improve an existing (perhaps partial) translation, you should copy that file to a folder you choose, where you have write permissions.

You can also create a file within your personal documents. The first three lines must read:

[General]

LanguageCode ='''xx_YY'''

LanguageName ='''name of language (in English)'''

Once you have created this file, you should put it in the Gestinux directory sources (managed by SVN) and lock it to prevent anyone else editing the same file simultaneously.
This must be done before you complete the translation, and the earlier the better.

If you know how to use SVN, ask to be given a "developer" profile, otherwise explain what you are doing on the forum and attach the file to your message translation. Other developers will use SVN directly. In either case, use the [http://gestinux.net/forum/viewforum.php?f=2 forum] to communicate with the other developers.

=== Initial Setup ===

From the Gestinux menu choose '''Settings''' '''Languages''' tab and '''Add a translation:'''

[[File: Languages-logo.png]]

* The language reference is necessarily one of the languages installed with gestinux. It will be your source. If possible, choose French, since the English pages are currently not complete.
* Find your translation file (created as described in the previous section) by clicking the selection button.
* Check the box "Use translation" for translations of this file to be used. Otherwise the reference language will be used.

=== Entering a new translation ===

You can translate globally by clicking the '''Translate''' button. In this case, you will have a list (to the left) of the various application windows, as well as some sections unrelated to a window. Global translation is required for sections that do not correspond to a window, and to check you have not overlooked any section. You can use the '''Next Missing''' button to find the first missing translation.

It is also possible to press CTRL+F4 from any application window to view and translate the section corresponding to that window. In this case, you will see only that window listed at the left. This method has the advantage that once the translation you can use the F4 key to toggle between viewing the base language and your language translation (and vice versa).

[[File: GTranslator.png]]

Anyway, for the selected section, a list of key translation is displayed. The reference translation (which cannot be changed) is displayed below, and you can enter or edit the translation in your language. Registration is automatic when you change key.

The symbol <CR> skips a line, and should be used for messages.

=== Installing new translations ===

If possible, get another native speaker to read and check your work. Once the translation is complete, unlock the file in SVN if you know how, or ask via the [http://gestinux.net/forum/viewforum . php? forum f = 6] for another developer to do this for you.

If you contribute a commonly used language, your translation will be added to the next version of Gestinux.

If you contribute a rare language translation, or you don't want to wait for the next Gestinux version, it is possible to make a package that includes an additional language for various target systems (Windows, Debian, ...). You can figure out how to do this yourself or ask a developer.

When you run it for the first time on a workstation, Gestinux tries to activate the correct translation automatically, depending on the computer's language. Unfortunately, Windows does not know the POSIX language codes, and there are cases where this is not automatic. A slight software modification is required that can be obtained from the developers. This problem does not exist on Linux systems.

== Providing translation data ==

A country list has to be created for each language available in Gestinux. This is contained in the xx_YY_countries.txt file that Gestinux loads automatically when its database is created (or audited) provided that you have earlier selected the appropriate language.

It is also helpful if you can create test cases in the language translated for the country (or countries) that use that language. You can export the database so that it can be hosted on gestinux.net and so become accessible to anyone worldwide.

If your country has state-specific tax(es), these can also be integrated into the software. If you do not make a [[Customized_Reports / en | about editing]], ask a developer on the forum, sending examples.

== Translating the documentation ==

Having translated the program software (or possibly before) it will also be helpful if you can translate the documentation (which is in the form of a wiki).

Currently there are about 100 pages to translate, but some are more important than others.

See [[Help: Contents / fr | how to create or edit pages]] of this wiki.

There is a way to list the remaining untranslated pages (or those whose original has been modified after translation). For now, this method is not available online, so if you would value this facility, ask on the [http://gestinux.net/forum forum].

Translating

2013-02-04T16:16:05Z

HowardPC:

{{#CustomTitle:How to translate Gestinux}}

This page explains how to translate Gestinux without knowing much about Pascal or other programming languages or the Lazarus IDE.

We ask that you translate only into your native language. Ideally, you should understand French because Gestinux was originally written in French.

== Where do you start translating, and what should you then move on to translate thereafter? ==

Ideally, you should start [[Translating / en # translate software | to translate the software]] itself, before starting to translate any documentation.

The translated software will be used to [[Translating / en # Provide translations Policy | create a set of test data]] and make fresh screenshots showing the newly translated language.

Then you can gradually [[Translating / en # Translate documentation | translate the documentation]].

== Translating the software ==

Only version 1.0 of Gestinux is to be translated and the following description covers how to go about your task.

If you are a developer who understands English, you can consult the [[internationalization Programming | internal translation mechanism]] for more information.

=== The code for your language ===

Before starting a new translation, you must discover what code applies to the language you are translating.

Languages are identified in accordance with standard Gestinux [http://www.gnu.org/software/gettext/manual/html_node/Locale-Names.html POSIX] codes, which all have the double xx_YY format.

The lowercase xx part of the code identifies the primary language, according to the [http://fr.wikipedia.org/wiki/Liste_des_codes_ISO_639-2 ISO-639-1] standard.
The uppercase YY part identifies any possible language variant (usually with a country code), according to the [ISO-3166 http://fr.wikipedia.org/wiki/ISO_3166-1] standard.

You should use the referenced ISO codes. If you invent a new code, the risk is that they may be formalized differently later.

Language code examples:

* Fr_FR: French "de France"
* Fr_CA: Quebec
* En_US: English (United States of America)
* Sv_SE: Sweden "Sweden"

If you are in any doubt, ask for confirmation on the [http://gestinux.net/forum/viewforum.php?f=2 forum].

=== The source file to translate ===

Gestinux 1.0 supports translations in a "text" xx_YY.ini file.

In general, these files are in a folder named ''languages'' at the same level as the executable Gestinux.
However, to comply with Debian Linux rules (including Ubuntu), the files for these distributions are in / usr / share / gestinux / languages

These files are installed as write-only. Do not try to modify or unprotect them at this location. If you want to improve an existing (perhaps partial) translation, you should copy that file to a folder you choose, where you have write permissions.

You can also create a file within your personal documents. The first three lines must read:

[General]

LanguageCode ='''xx_YY'''

LanguageName ='''name of language (in English)'''

Once you have created this file, you should put it in the Gestinux directory sources (managed by SVN) and lock it to prevent anyone else editing the same file simultaneously.
This must be done before you complete the translation, and the earlier the better.

If you know how to use SVN, ask to be given a "developer" profile, otherwise explain what you are doing on the forum and attach the file to your message translation. Other developers will use SVN directly. In either case, use the [http://gestinux.net/forum/viewforum.php?f=2 forum] to communicate with the other developers.

=== Initial Setup ===

From the Gestinux menu choose '''Settings''' '''Languages''' tab and '''Add a translation:'''

[[File: Languages-logo.png]]

* The language reference is necessarily one of the languages installed with gestinux. It will be your source. If possible, choose French, since the English pages are currently not complete.
* Find your translation file (created as described in the previous section) by clicking the selection button.
* Check the box "Use translation" for translations of this file to be used. Otherwise the reference language will be used.

=== Entering a new translation ===

You can translate globally by clicking the '''Translate''' button. In this case, you will have a list (to the left) of the various application windows, as well as some sections unrelated to a window. Global translation is required for sections that do not correspond to a window, and to check you have not overlooked any section. You can use the '''Next Missing''' button to find the first missing translation.

It is also possible to press CTRL+F4 from any application window to view and translate the section corresponding to that window. In this case, you will see only that window listed at the left. This method has the advantage that once the translation you can use the F4 key to toggle between viewing the base language and your language translation (and vice versa).

[[File: GTranslator.png]]

Anyway, for the selected section, a list of key translation is displayed. The reference translation (which cannot be changed) is displayed below, and you can enter or edit the translation in your language. Registration is automatic when you change key.

The symbol <CR> skips a line, and should be used for messages.

=== Installing new translations ===

If possible, get another native speaker to read and check your work. Once the translation is complete, unlock the file in SVN if you know how, or ask via the [http://gestinux.net/forum/viewforum . php? forum f = 6] for another developer to do this for you.

If you contribute a commonly used language, your translation will be added to the next version of Gestinux.

If you contribute a rare language translation, or you don't want to wait for the next Gestinux version, it is possible to make a package that includes an additional language for various target systems (Windows, Debian, ...). You can figure out how to do this yourself or ask a developer.

When you run it for the first time on a workstation, Gestinux tries to activate the correct translation automatically, depending on the computer's language. Unfortunately, Windows does not know the POSIX language codes, and there are cases where this is not automatic. A slight software modification is required that can be obtained from the developers. This problem does not exist on Linux systems.

== Providing translation data ==

A country list has to be created for each language available in Gestinux. This is contained in the xx_YY_countries.txt file that Gestinux loads automatically when its database is created (or audited) provided that you have earlier selected the appropriate language.

It is also helpful if you can create test cases in the language translated for the country (or countries) that use that language. You can export the database so that it can be hosted on gestinux.net and so become accessible to anyone worldwide.

If your country has state-specific tax(es), these can also be integrated into the software. If you do not make a [[Customized_Reports / en | about editing]], ask a developer on the forum, sending examples.

== Translating the documentation ==

Having translated the program software (or possibly before) it will also be helpful if you can translate the documentation (which is in the form of a wiki).

Currently there are about 100 pages to translate, but some are more important than others.

See [[Help: Contents / fr | how to create or edit pages]] of this wiki.

There is a way to list the remaining untranslated pages (or those whose original has been modified after translation). For now, this method is not available online, so if you would value this facility, ask on the [http://gestinux.net/forum forum].

Translating

2013-02-04T16:14:03Z

HowardPC:

{{#CustomTitle:How to translate Gestinux}}

This page explains how to translate Gestinux without knowing much about Pascal or other programming languages or the Lazarus IDE.

We ask that you translate only into your native language. Ideally, you should understand French because Gestinux was originally written in French.

== Where do you start translating, and what should you then move on to translate thereafter? ==

Ideally, you should start [[Translating / en # translate software | to translate the software]] itself, before starting to translate any documentation.

The translated software will be used to [[Translating / en # Provide translations Policy | create a set of test data]] and make fresh screenshots showing the newly translated language.

Then you can gradually [[Translating / en # Translate documentation | translate the documentation]].

== Translating the software ==

Only version 1.0 of Gestinux is to be translated and the following description covers how to go about your task.

If you are a developer who understands English, you can consult the [[internationalization Programming | internal translation mechanism]] for more information.

=== The code for your language ===

Before starting a new translation, you must discover what code applies to the language you are translating.

Languages are identified in accordance with standard Gestinux [http://www.gnu.org/software/gettext/manual/html_node/Locale-Names.html POSIX] codes, which all have the double xx_YY format.

The lowercase xx part of the code identifies the primary language, according to the [http://fr.wikipedia.org/wiki/Liste_des_codes_ISO_639-2 ISO-639-1] standard.
The uppercase YY part identifies any possible language variant (usually with a country code), according to the [ISO-3166 http://fr.wikipedia.org/wiki/ISO_3166-1] standard.

You should use the referenced ISO codes. If you invent a new code, the risk is that they may be formalized differently later.

Language code examples:

* Fr_FR: French "de France"
* Fr_CA: Quebec
* En_US: English (United States of America)
* Sv_SE: Sweden "Sweden"

If you are in any doubt, ask for confirmation on the [http://gestinux.net/forum/viewforum.php?f=2 forum].

=== The source file to translate ===

Gestinux 1.0 supports translations in a "text" xx_YY.ini file.

In general, these files are in a folder named ''languages'' at the same level as the executable Gestinux.
However, to comply with Debian Linux rules (including Ubuntu), the files for these distributions are in / usr / share / gestinux / languages

These files are installed as write-only. Do not try to modify or unprotect them at this location. If you want to improve an existing (perhaps partial) translation, you should copy that file to a folder you choose, where you have write permissions.

You can also create a file within your personal documents. The first three lines must read:

[General]

LanguageCode ='''xx_YY'''

LanguageName ='''name of language (in English)'''

Once you have created this file, you should put it in the Gestinux directory sources (managed by SVN) and lock it to prevent anyone else editing the same file simultaneously.
This must be done before you complete the translation, and the earlier the better.

If you know how to use SVN, ask to be given a "developer" profile, otherwise explain what you are doing on the forum and attach the file to your message translation. Other developers will use SVN directly. In either case, use the [http://gestinux.net/forum/viewforum.php?f=2 forum] to communicate with the other developers.

=== Initial Setup ===

From the Gestinux menu choose '''Settings''' '''Languages''' tab and '''Add a translation:'''

[[File: Languages-logo.png]]

* The language reference is necessarily one of the languages installed with gestinux. It will be your source. If possible, choose French, since the English pages are currently not complete.
* Find your translation file (created as described in the previous section) by clicking the selection button.
* Check the box "Use translation" for translations of this file to be used. Otherwise the reference language will be used.

=== Entering a new translation ===

You can translate globally by clicking the '''Translate''' button. In this case, you will have a list (to the left) of the various application windows, as well as some sections unrelated to a window. Global translation is required for sections that do not correspond to a window, and to check you have not overlooked any section. You can use the '''Next Missing''' button to find the first missing translation.

It is also possible to press CTRL+F4 from any application window to view and translate the section corresponding to that window. In this case, you will see only that window listed at the left. This method has the advantage that once the translation you can use the F4 key to toggle between viewing the base language and your language translation (and vice versa).

[[File: GTranslator.png]]

Anyway, for the selected section, a list of key translation is displayed. The reference translation (which cannot be changed) is displayed below, and you can enter or edit the translation in your language. Registration is automatic when you change key.

The symbol <CR> skips a line, and should be used for messages.

=== Installing new translations ===

If possible, get another native speaker to read and check your work. Once the translation is complete, unlock the file in SVN if you know how, or ask via the [http://gestinux.net/forum/viewforum . php? forum f = 6] for another developer to do this for you.

If you contribute a commonly used language, your translation will be added to the next version of Gestinux.

If you contribute a rare language translation, or you don't want to wait for the next Gestinux version, it is possible to make a package that includes an additional language for various target systems (Windows, Debian, ...). You can figure out how to do this yourself or ask a developer.

When you run it for the first time on a workstation, Gestinux tries to activate the correct translation automatically, depending on the computer's language. Unfortunately, Windows does not know the POSIX language codes, and there are cases where this is not automatic. A slight software modification is required that can be obtained from the developers. This problem does not exist on Linux systems.

Providing translation == data ==

A country list has to be created for each language available in Gestinux. This is contained in the xx_YY_countries.txt file that Gestinux loads automatically when its database is created (or audited) provided that you have earlier selected the appropriate language.

It is also helpful if you can create test cases in the language translated for the country (or countries) that use that language. You can export the database so that it can be hosted on gestinux.net and so become accessible to anyone worldwide.

If your country has state-specific tax(es), these can also be integrated into the software. If you do not make a [[Customized_Reports / en | about editing]], ask a developer on the forum, sending examples.

Translate == Documentation ==

Having translated the program software (or possibly before) it will also be helpful if you can translate the documentation (which is in the form of a wiki).

Currently there are about 100 pages to translate, but some are more important than others.

See [[Help: Contents / fr | how to create or edit pages]] of this wiki.

There is a way to list the remaining untranslated pages (or those whose original has been modified after translation). For now, this method is not available online, so if you would value this facility, ask on the [http://gestinux.net/forum forum].

Taxes

2013-02-02T13:17:53Z

HowardPC:

{{#CustomTitle:VAT and other taxes}}

[[Taxes | English]]

You manage VAT and other taxes via the menu options '''sales''' and then '''Taxes'''.

You can set up several '''tax groups'''. The default is a maximum of 3 groups, but you can increase this easily if needed.

Typically you will require:
* A group for VAT
* One (or two) groups for other taxes

Each tax group allows for the definition of:

* The name of the tax
* An abbreviation for the tax (perhaps a short code) which is then printed on each invoice line requiring it
* The tax rate
* The account used to track the amount of tax

Having created the different tax categories you need, you can move to managing sales [[SalesCategories / in | Categories sale]].

For each sales category, and for each tax group, you can specify whether the tax should be applied or not, whether adding tax is mandatory, and whether a tax amount should automatically be calculated and added.

These settings will be used for each product and sales category. You can specify exceptions to the settings if needed.

We hope that this system is flexible enough to accommodate the tax regimes and varied fiscal regulations of most countries. However, if it does not fit the situation where you live do not hesitate to contact the developers so it can be amended to suit your needs too.

[[Paramétrage_de_la_facturation | Billing Other settings]]

Taxes

2013-02-02T13:15:59Z

HowardPC:

[[# CustomTitle: VAT and other taxes]]

[[Taxes | English]]

You manage VAT and other taxes via the menu options '''sales''' and then '''Taxes'''.

You can set up several '''tax groups'''. The default is a maximum of 3 groups, but you can increase this easily if needed.

Typically you will require:
* A group for VAT
* One (or two) groups for other taxes

Each tax group allows for the definition of:

* The name of the tax
* An abbreviation for the tax (perhaps a short code) which is then printed on each invoice line requiring it
* The tax rate
* The account used to track the amount of tax

Having created the different tax categories you need, you can move to managing sales [[SalesCategories / in | Categories sale]].

For each sales category, and for each tax group, you can specify whether the tax should be applied or not, whether adding tax is mandatory, and whether a tax amount should automatically be calculated and added.

These settings will be used for each product and sales category. You can specify exceptions to the settings if needed.

We hope that this system is flexible enough to accommodate the tax regimes and varied fiscal regulations of most countries. However, if it does not fit the situation where you live do not hesitate to contact the developers so it can be amended to suit your needs too.

[[Paramétrage_de_la_facturation | Billing Other settings]]

Taxes

2013-02-02T13:11:36Z

HowardPC: draft translation for review

{{# CustomTitle: VAT and other taxes}}

[[Taxes | English]]

You manage VAT and other taxes via the menu options '' 'sales''' and then'' 'Taxes'''.

You can set up several'''' ''''' tax groups'. The default is a maximum of 3 groups, but you can increase this easily if needed.

Typically you will require:
* A group for VAT
* One (or two) groups for other taxes

Each tax group allows for the definition of:

* The name of the tax
* An abbreviation for the tax (perhaps a short code) which is then printed on each invoice line requiring it
* The tax rate
* The account used to track the amount of tax

Having created the different tax categories you need, you can move to managing sales [[SalesCategories / in | Categories sale]].

For each sales category, and for each tax group, you can specify whether the tax should be applied or not, whether adding tax is mandatory, and whether a tax amount must be automatically calculated and added.

Within each product and sales category, these settings will be used. You can specify exceptions to the settings if needed.

We hope that this system is flexible enough to accommodate the tax regimes and varied fiscal regulations of most countries. However, if it does not fit the situation where you live do not hesitate to contact the developers so it can be updated to suit your needs too.

[[Paramétrage_de_la_facturation | Billing Other settings]]

Main Page

2013-02-02T12:50:07Z

HowardPC: minor edit

{{#customtitle:Gestinux documentation}}

From here you can find information about [[installing]], [[using]], [[translating]] and [[developing]] Gestinux.

If you don't see what you are looking for, please search in the [http://gestinux.net/forum/viewforum.php?f=7 '''forum'''] and post a '''new topic''' if you are unable to find the information you need.

To contact the developers, or for any other discussion about Gestinux, the [http://gestinux.net/forum/viewforum.php?f=10 '''forum'''] is also the place to start.

AccountingEntry

2013-01-31T23:31:57Z

HowardPC: /* Minimal accounting entry */

{{#customtitle:Accounting entry and browsing}}

= Header =

First, you can complete the header fields to display existing accounting records and to filter the entries which are shown.
If you leave the header fields blank, this means "all" or "any".

== Journal ==

You can choose one or several journals, by clicking the button to the right of the field.

The list of available journals will be displayed in a new window. Double-click a line to select a journal. You can also [[Initial_setup#Journals|create or edit a journal]] if you have the correct permissions.

If you leave the field blank, accounting records for all journals will be displayed, and you will be allowed to enter any journal. This might be slow and unsafe.

== Start and end dates ==

The start date can be entered to select the first day to display. Leaving this field blank displays all accounting records from the first entry onwards.

The end date can be entered to limit the last day to display. Leaving this field blank displays all accounting records up to the last entry.

In version 1.0, you are not allowed to enter a date outside the specified range, which prevents invalid entries being made.

= Creating an accounting records =

If you have selected a journal, and if '''manual entry''' is allowed for this journal, you can enter new accounting records.
Otherwise, the display is read-only and you can't create any accounting records.

== Minimal accounting entry ==

Select '''New accounting entry''' in the drop down list at the bottom, and click '''Create'''. You can also use F12 key.

2 lines are created in the grid. You will be able to add lines as explained below.

First you enter the date of the entry (or change an existing entry date). Date entry is limited to the period between the start and end dates given in the header. The date must be also greater than the journal close date. The date format will be the default system date format. If you omit year, month or day, then the current year, month or day are inserted for you.

Then, you must enter some text describing the journal (this is required).

Next, you enter or select an account. There are several ways to do this.

* You can enter the first digits and letters of the account code, starting with digits, and click enter. The first account code starting with these characters will be selected.
* You can enter the beginning of the account name, starting with a non-numeric character. This selects the first account with a matching name.
* You can click the button on the right side of the field and choose an account from the windowed list.

Next, you enter the amount. Decimals can be added. The decimal separator is the default decimal character defined by the system.

In the second line, you enter the code or name of the corresponding double-entry account, as you did previously.
The balancing amount is filled for you, and if your accounting record has 2 lines, it is now complete.

Click on the validation button. This checks that the accounting entry is balanced and valid. If so, it will be recorded.
At any time, of course you can cancel the accounting entry and nothing will be recorded.

== Adding lines ==

* To insert a '''new line, before''' the current line, select this item in the drop down list and click '''Create'''; you can also press '''F8'''.
* To insert a '''new line, after''' the current line, select this item in the drop down list and click '''Create'''; you can also press '''F9'''.
* To delete a line added in error, click the '''Delete''' button or press '''F10'''.

== Accounting entry from a template ==

[Detailed documentation still to be added here].

AccountingEntry

2013-01-31T23:29:16Z

HowardPC: /* Journal */

{{#customtitle:Accounting entry and browsing}}

= Header =

First, you can complete the header fields to display existing accounting records and to filter the entries which are shown.
If you leave the header fields blank, this means "all" or "any".

== Journal ==

You can choose one or several journals, by clicking the button to the right of the field.

The list of available journals will be displayed in a new window. Double-click a line to select a journal. You can also [[Initial_setup#Journals|create or edit a journal]] if you have the correct permissions.

If you leave the field blank, accounting records for all journals will be displayed, and you will be allowed to enter any journal. This might be slow and unsafe.

== Start and end dates ==

The start date can be entered to select the first day to display. Leaving this field blank displays all accounting records from the first entry onwards.

The end date can be entered to limit the last day to display. Leaving this field blank displays all accounting records up to the last entry.

In version 1.0, you are not allowed to enter a date outside the specified range, which prevents invalid entries being made.

= Creating an accounting records =

If you have selected a journal, and if '''manual entry''' is allowed for this journal, you can enter new accounting records.
Otherwise, the display is read-only and you can't create any accounting records.

== Minimal accounting entry ==

In the drop down list, select '''New accounting entry''' in the drop down list in the bottom, and click '''Create'''. You can also use F12 key.

2 lines are created in the grid. You will be able to add lines as explained below.

First you enter the date of the entry (or change an existing entry date). Date entry is limited to the period between the start and end dates given in the header. The date must be also greater than the journal close date. The date format will be the default system date format. If you omit year, month or day, then the current year, month or day are inserted for you.

Then, you enter some text (this is required).

Next, you enter or select an account. There are several ways to do this.

* You can enter the first digits and letters of the account code, starting with digits, and click enter. The first account code starting with these characters will be selected.
* You can enter the beginning of the account name, starting with a non-numeric character. This selects the first account with a matching name.
* You can click the button on the right side of the field and choose an account from the windowed list.

Next, you enter the amount. Decimals can be added. The decimal separator is the default decimal character defined by the system.

In the second line, you enter the code or name of the corresponding double-entry account, as you did previously.
The balancing amount is filled for you, and if your accounting record has 2 lines, it is now complete.

Click on the validation button. This checks that the accounting entry is balanced and valid. If so, it will be recorded.
At any time, of course you can cancel the accounting entry and nothing will be recorded.

== Adding lines ==

* To insert a '''new line, before''' the current line, select this item in the drop down list and click '''Create'''; you can also press '''F8'''.
* To insert a '''new line, after''' the current line, select this item in the drop down list and click '''Create'''; you can also press '''F9'''.
* To delete a line added in error, click the '''Delete''' button or press '''F10'''.

== Accounting entry from a template ==

[Detailed documentation still to be added here].

AccountingEntry

2013-01-31T23:28:03Z

HowardPC: /* Accounting entry from a template */

{{#customtitle:Accounting entry and browsing}}

= Header =

First, you can complete the header fields to display existing accounting records and to filter the entries which are shown.
If you leave the header fields blank, this means "all" or "any".

== Journal ==

You can choose one or several journals, by clicking the button to the right of the field.

The list of available journals will be displayed in a new window. Double-click a line to select a journal. You can also [[Initial_setup#Journals|create or edit a journal]] if you have the correct permissions.

If you leave the field blank, you will display accounting records for all journals and will be allowed to enter any journal. This might be slow and unsafe.

== Start and end dates ==

The start date can be entered to select the first day to display. Leaving this field blank displays all accounting records from the first entry onwards.

The end date can be entered to limit the last day to display. Leaving this field blank displays all accounting records up to the last entry.

In version 1.0, you are not allowed to enter a date outside the specified range, which prevents invalid entries being made.

= Creating an accounting records =

If you have selected a journal, and if '''manual entry''' is allowed for this journal, you can enter new accounting records.
Otherwise, the display is read-only and you can't create any accounting records.

== Minimal accounting entry ==

In the drop down list, select '''New accounting entry''' in the drop down list in the bottom, and click '''Create'''. You can also use F12 key.

2 lines are created in the grid. You will be able to add lines as explained below.

First you enter the date of the entry (or change an existing entry date). Date entry is limited to the period between the start and end dates given in the header. The date must be also greater than the journal close date. The date format will be the default system date format. If you omit year, month or day, then the current year, month or day are inserted for you.

Then, you enter some text (this is required).

Next, you enter or select an account. There are several ways to do this.

* You can enter the first digits and letters of the account code, starting with digits, and click enter. The first account code starting with these characters will be selected.
* You can enter the beginning of the account name, starting with a non-numeric character. This selects the first account with a matching name.
* You can click the button on the right side of the field and choose an account from the windowed list.

Next, you enter the amount. Decimals can be added. The decimal separator is the default decimal character defined by the system.

In the second line, you enter the code or name of the corresponding double-entry account, as you did previously.
The balancing amount is filled for you, and if your accounting record has 2 lines, it is now complete.

Click on the validation button. This checks that the accounting entry is balanced and valid. If so, it will be recorded.
At any time, of course you can cancel the accounting entry and nothing will be recorded.

== Adding lines ==

* To insert a '''new line, before''' the current line, select this item in the drop down list and click '''Create'''; you can also press '''F8'''.
* To insert a '''new line, after''' the current line, select this item in the drop down list and click '''Create'''; you can also press '''F9'''.
* To delete a line added in error, click the '''Delete''' button or press '''F10'''.

== Accounting entry from a template ==

[Detailed documentation still to be added here].

AccountingEntry

2013-01-31T23:27:06Z

HowardPC: /* Adding lines */

{{#customtitle:Accounting entry and browsing}}

= Header =

First, you can complete the header fields to display existing accounting records and to filter the entries which are shown.
If you leave the header fields blank, this means "all" or "any".

== Journal ==

You can choose one or several journals, by clicking the button to the right of the field.

The list of available journals will be displayed in a new window. Double-click a line to select a journal. You can also [[Initial_setup#Journals|create or edit a journal]] if you have the correct permissions.

If you leave the field blank, you will display accounting records for all journals and will be allowed to enter any journal. This might be slow and unsafe.

== Start and end dates ==

The start date can be entered to select the first day to display. Leaving this field blank displays all accounting records from the first entry onwards.

The end date can be entered to limit the last day to display. Leaving this field blank displays all accounting records up to the last entry.

In version 1.0, you are not allowed to enter a date outside the specified range, which prevents invalid entries being made.

= Creating an accounting records =

If you have selected a journal, and if '''manual entry''' is allowed for this journal, you can enter new accounting records.
Otherwise, the display is read-only and you can't create any accounting records.

== Minimal accounting entry ==

In the drop down list, select '''New accounting entry''' in the drop down list in the bottom, and click '''Create'''. You can also use F12 key.

2 lines are created in the grid. You will be able to add lines as explained below.

First you enter the date of the entry (or change an existing entry date). Date entry is limited to the period between the start and end dates given in the header. The date must be also greater than the journal close date. The date format will be the default system date format. If you omit year, month or day, then the current year, month or day are inserted for you.

Then, you enter some text (this is required).

Next, you enter or select an account. There are several ways to do this.

* You can enter the first digits and letters of the account code, starting with digits, and click enter. The first account code starting with these characters will be selected.
* You can enter the beginning of the account name, starting with a non-numeric character. This selects the first account with a matching name.
* You can click the button on the right side of the field and choose an account from the windowed list.

Next, you enter the amount. Decimals can be added. The decimal separator is the default decimal character defined by the system.

In the second line, you enter the code or name of the corresponding double-entry account, as you did previously.
The balancing amount is filled for you, and if your accounting record has 2 lines, it is now complete.

Click on the validation button. This checks that the accounting entry is balanced and valid. If so, it will be recorded.
At any time, of course you can cancel the accounting entry and nothing will be recorded.

== Adding lines ==

* To insert a '''new line, before''' the current line, select this item in the drop down list and click '''Create'''; you can also press '''F8'''.
* To insert a '''new line, after''' the current line, select this item in the drop down list and click '''Create'''; you can also press '''F9'''.
* To delete a line added in error, click the '''Delete''' button or press '''F10'''.

== Accounting entry from a template ==

To be detailed later... sorry.

AccountingEntry

2013-01-31T23:26:03Z

HowardPC: /* Minimal accounting entry */

{{#customtitle:Accounting entry and browsing}}

= Header =

First, you can complete the header fields to display existing accounting records and to filter the entries which are shown.
If you leave the header fields blank, this means "all" or "any".

== Journal ==

You can choose one or several journals, by clicking the button to the right of the field.

The list of available journals will be displayed in a new window. Double-click a line to select a journal. You can also [[Initial_setup#Journals|create or edit a journal]] if you have the correct permissions.

If you leave the field blank, you will display accounting records for all journals and will be allowed to enter any journal. This might be slow and unsafe.

== Start and end dates ==

The start date can be entered to select the first day to display. Leaving this field blank displays all accounting records from the first entry onwards.

The end date can be entered to limit the last day to display. Leaving this field blank displays all accounting records up to the last entry.

In version 1.0, you are not allowed to enter a date outside the specified range, which prevents invalid entries being made.

= Creating an accounting records =

If you have selected a journal, and if '''manual entry''' is allowed for this journal, you can enter new accounting records.
Otherwise, the display is read-only and you can't create any accounting records.

== Minimal accounting entry ==

In the drop down list, select '''New accounting entry''' in the drop down list in the bottom, and click '''Create'''. You can also use F12 key.

2 lines are created in the grid. You will be able to add lines as explained below.

First you enter the date of the entry (or change an existing entry date). Date entry is limited to the period between the start and end dates given in the header. The date must be also greater than the journal close date. The date format will be the default system date format. If you omit year, month or day, then the current year, month or day are inserted for you.

Then, you enter some text (this is required).

Next, you enter or select an account. There are several ways to do this.

* You can enter the first digits and letters of the account code, starting with digits, and click enter. The first account code starting with these characters will be selected.
* You can enter the beginning of the account name, starting with a non-numeric character. This selects the first account with a matching name.
* You can click the button on the right side of the field and choose an account from the windowed list.

Next, you enter the amount. Decimals can be added. The decimal separator is the default decimal character defined by the system.

In the second line, you enter the code or name of the corresponding double-entry account, as you did previously.
The balancing amount is filled for you, and if your accounting record has 2 lines, it is now complete.

Click on the validation button. This checks that the accounting entry is balanced and valid. If so, it will be recorded.
At any time, of course you can cancel the accounting entry and nothing will be recorded.

== Adding lines ==

* To insert a '''new line, before''' the current line, select this item in the drop down list and click '''Create'''; you can also press '''F8'''.
* To insert a '''new line, after''' the current line, select this item in the drop down list and click Create; you can also press '''F9'''.
* To delete a line added by error, click the '''Delete''' button or press '''F10'''.

== Accounting entry from a template ==

To be detailed later... sorry.

AccountingEntry

2013-01-31T23:15:09Z

HowardPC: /* Journal */

{{#customtitle:Accounting entry and browsing}}

= Header =

First, you can complete the header fields to display existing accounting records and to filter the entries which are shown.
If you leave the header fields blank, this means "all" or "any".

== Journal ==

You can choose one or several journals, by clicking the button to the right of the field.

The list of available journals will be displayed in a new window. Double-click a line to select a journal. You can also [[Initial_setup#Journals|create or edit a journal]] if you have the correct permissions.

If you leave the field blank, you will display accounting records for all journals and will be allowed to enter any journal. This might be slow and unsafe.

== Start and end dates ==

The start date can be entered to select the first day to display. Leaving this field blank displays all accounting records from the first entry onwards.

The end date can be entered to limit the last day to display. Leaving this field blank displays all accounting records up to the last entry.

In version 1.0, you are not allowed to enter a date outside the specified range, which prevents invalid entries being made.

= Creating an accounting records =

If you have selected a journal, and if '''manual entry''' is allowed for this journal, you can enter new accounting records.
Otherwise, the display is read-only and you can't create any accounting records.

== Minimal accounting entry ==

In the drop down list, select '''New accounting entry''' in the drop down list in the bottom, and click '''Create'''. You can also use F12 key.

2 lines are created in the grid. You will be able to add lines as explained below.

First you must enter or change the displayed accounting record date, which must be between the start and end dates entered in the header. It must be also greater than the journal close date. The date format is given by the system. The current year, month or day are used if ommitted.

Then, you enter a mandatory text.

Next, you enter or select an account. There are several ways to do this.

* You can enter the first digits and letters of the account code, starting with digits, and click enter. The first account code starting with these characters will be select.
* You can enter the beginning of the account name, starting with a non-numeric character. The first account having a matching name will be selected.
* You can click the button on the right side of the field and choose an account in the windows.

Next, you enter the amount. Decimals can be added. The decimal separator is defined by the system.

In the second line, you enter the counterpart account, like previously.
The counterpart amount should have been filled and if your accounting record has 2 lines, it should be completed.

Click on the validation button. This will check that the accounting records is balanced and valid, and it will be recorded.
At any time, of course you can cancel the accounting entry and nothing will be recorded.

== Adding lines ==

* To insert a '''new line, before''' the current line, select this item in the drop down list and click '''Create'''; you can also press '''F8'''.
* To insert a '''new line, after''' the current line, select this item in the drop down list and click Create; you can also press '''F9'''.
* To delete a line added by error, click the '''Delete''' button or press '''F10'''.

== Accounting entry from a template ==

To be detailed later... sorry.

AccountingEntry

2013-01-31T23:13:36Z

HowardPC: /* Header */

{{#customtitle:Accounting entry and browsing}}

= Header =

First, you can complete the header fields to display existing accounting records and to filter the entries which are shown.
If you leave the header fields blank, this means "all" or "any".

== Journal ==

You can choose one or several journals, by clicking the button on the right of the field.

The list of available journals will be displayed in a new window. Double-click a line to select a journal. If you are allowed, you can also [[Initial_setup#Journals|create or edit a journal]].

If you leave the field blank, you will display accounting records for all journals and will be allowed to enter any journal. This might be slow and unsafe.

== Start and end dates ==

The start date can be entered to select the first day to display. Leaving this field blank displays all accounting records from the first entry onwards.

The end date can be entered to limit the last day to display. Leaving this field blank displays all accounting records up to the last entry.

In version 1.0, you are not allowed to enter a date outside the specified range, which prevents invalid entries being made.

= Creating an accounting records =

If you have selected a journal, and if '''manual entry''' is allowed for this journal, you can enter new accounting records.
Otherwise, the display is read-only and you can't create any accounting records.

== Minimal accounting entry ==

In the drop down list, select '''New accounting entry''' in the drop down list in the bottom, and click '''Create'''. You can also use F12 key.

2 lines are created in the grid. You will be able to add lines as explained below.

First you must enter or change the displayed accounting record date, which must be between the start and end dates entered in the header. It must be also greater than the journal close date. The date format is given by the system. The current year, month or day are used if ommitted.

Then, you enter a mandatory text.

Next, you enter or select an account. There are several ways to do this.

* You can enter the first digits and letters of the account code, starting with digits, and click enter. The first account code starting with these characters will be select.
* You can enter the beginning of the account name, starting with a non-numeric character. The first account having a matching name will be selected.
* You can click the button on the right side of the field and choose an account in the windows.

Next, you enter the amount. Decimals can be added. The decimal separator is defined by the system.

In the second line, you enter the counterpart account, like previously.
The counterpart amount should have been filled and if your accounting record has 2 lines, it should be completed.

Click on the validation button. This will check that the accounting records is balanced and valid, and it will be recorded.
At any time, of course you can cancel the accounting entry and nothing will be recorded.

== Adding lines ==

* To insert a '''new line, before''' the current line, select this item in the drop down list and click '''Create'''; you can also press '''F8'''.
* To insert a '''new line, after''' the current line, select this item in the drop down list and click Create; you can also press '''F9'''.
* To delete a line added by error, click the '''Delete''' button or press '''F10'''.

== Accounting entry from a template ==

To be detailed later... sorry.

AccountingEntry

2013-01-31T23:13:06Z

HowardPC: /* Header */

{{#customtitle:Accounting entry and browsing}}

= Header =

First, you can complete the header fields to display existing accounting records and to filter the entries.
If you leave the header fields blank, this means "all" or "any".

== Journal ==

You can choose one or several journals, by clicking the button on the right of the field.

The list of available journals will be displayed in a new window. Double-click a line to select a journal. If you are allowed, you can also [[Initial_setup#Journals|create or edit a journal]].

If you leave the field blank, you will display accounting records for all journals and will be allowed to enter any journal. This might be slow and unsafe.

== Start and end dates ==

The start date can be entered to select the first day to display. Leaving this field blank displays all accounting records from the first entry onwards.

The end date can be entered to limit the last day to display. Leaving this field blank displays all accounting records up to the last entry.

In version 1.0, you are not allowed to enter a date outside the specified range, which prevents invalid entries being made.

= Creating an accounting records =

If you have selected a journal, and if '''manual entry''' is allowed for this journal, you can enter new accounting records.
Otherwise, the display is read-only and you can't create any accounting records.

== Minimal accounting entry ==

In the drop down list, select '''New accounting entry''' in the drop down list in the bottom, and click '''Create'''. You can also use F12 key.

2 lines are created in the grid. You will be able to add lines as explained below.

First you must enter or change the displayed accounting record date, which must be between the start and end dates entered in the header. It must be also greater than the journal close date. The date format is given by the system. The current year, month or day are used if ommitted.

Then, you enter a mandatory text.

Next, you enter or select an account. There are several ways to do this.

* You can enter the first digits and letters of the account code, starting with digits, and click enter. The first account code starting with these characters will be select.
* You can enter the beginning of the account name, starting with a non-numeric character. The first account having a matching name will be selected.
* You can click the button on the right side of the field and choose an account in the windows.

Next, you enter the amount. Decimals can be added. The decimal separator is defined by the system.

In the second line, you enter the counterpart account, like previously.
The counterpart amount should have been filled and if your accounting record has 2 lines, it should be completed.

Click on the validation button. This will check that the accounting records is balanced and valid, and it will be recorded.
At any time, of course you can cancel the accounting entry and nothing will be recorded.

== Adding lines ==

* To insert a '''new line, before''' the current line, select this item in the drop down list and click '''Create'''; you can also press '''F8'''.
* To insert a '''new line, after''' the current line, select this item in the drop down list and click Create; you can also press '''F9'''.
* To delete a line added by error, click the '''Delete''' button or press '''F10'''.

== Accounting entry from a template ==

To be detailed later... sorry.

Initial setup

2013-01-31T23:06:46Z

HowardPC: /* Journals */

{{#CustomTitle:Initial setup}}

Before using Gestinux, you must enter a minimal set of parameters.

# [[Glanguage|Confirm the language]]
# [[Gdatabase|Define and possibly create the database]] to use.

== Company ==

It might be useful to enter some information about the company or organization you want to manage.
This data can be printed on reports.

Note that there is only one company in one database.
Go to the '''Parameters''' menu option and then choose '''Company'''.

== Fiscal periods ==

Go to the '''Parameters''' menu option and then '''Periods''' and click the "+" sign to create at least one active fiscal period.
Dates should be entered in your system's date format.

== Journals ==

Before you can make any accounting entries, you will have to create some journals.

They can be imported from a file or from an accounts database produced by other accounting software. For evaluation purposes, it is advisable to start by importing a set of test data. Please read the page explaining how to [[Import journals/fr|import journals]].

Some example [https://sourceforge.net/projects/gestinux/files/Imports%20for%20test/ sets of test data] which can be imported produced by some French software ([https://sourceforge.net/projects/gestinux/files/Imports%20for%20test/French/Sage%20Ligne%20100%20%28BIJOU%20S.A%29/ SAGE Ligne 100] and [https://sourceforge.net/projects/gestinux/files/Imports%20for%20test/French/APISoft%20Expert%20%28Promatex%29/ APISoft Expert]), are available.

If you can provide other test data (especially in English or languages other than French) please contact the developers on the [http://gestinux.net/forum/viewforum.php?f=10 forum].

You can also define journals manually, from the menu ('''Parameters''', '''Journals'''), or in [[AccountingEntry|Accounting entry]] before selecting a journal.

The data you have to provide is as follows :
* A journal code (10 characters or digits) as a short identifier. It must be unique (i. e. distinct from all other journal codes).
* The journal name (there is a 50 character maximum length) giving the full name of the journal.
* The journal type (''Cash'' to [[BankStatements|match bank statements]], other journal types are not used).
* The account number (For cash journal only)
* Manual entry : if you uncheck this option, this journal will only accept imported data. You will not be able to key data in manually.
* Close date : no import or entry will be possible before this date. If the date is left empty there is no date restriction.

The Close date can be edited (or erased).

== Chart of Accounts ==

Then you have to import or create some ''accounts''. (More documentation will be soon available...)

It is possible to import all this data from separate files, produced by other applications (provided it is in the correct format).
For initial testing, this is the easiest way to begin exploring Gestinux.

Currently, files produced by French accounting software (SAGE 100) are [https://sourceforge.net/projects/gestinux/files/Imports%20for%20test/French/Sage%20Ligne%20100/ provided] which you can import to set up a test accounts database.
If you can provide export files from other accounts software, (originating outside France or in languages other than French), you are welcome to contact the developers.

== Ready to go ==

You can then start [[Using|using Gestinux]]

Initial setup

2013-01-31T23:05:01Z

HowardPC: /* Journals */

{{#CustomTitle:Initial setup}}

Before using Gestinux, you must enter a minimal set of parameters.

# [[Glanguage|Confirm the language]]
# [[Gdatabase|Define and possibly create the database]] to use.

== Company ==

It might be useful to enter some information about the company or organization you want to manage.
This data can be printed on reports.

Note that there is only one company in one database.
Go to the '''Parameters''' menu option and then choose '''Company'''.

== Fiscal periods ==

Go to the '''Parameters''' menu option and then '''Periods''' and click the "+" sign to create at least one active fiscal period.
Dates should be entered in your system's date format.

== Journals ==

Before you can make any accounting entries, you will have to create some journals.

They can be imported from a file or from an accounts database produced by other accounting software. For evaluation purposes, it is advisable to start by importing a set of test data. Please read the page explaining how to [[Import journals/fr|import journals]].

Some example [https://sourceforge.net/projects/gestinux/files/Imports%20for%20test/ sets of test data] which can be imported produced by some French software ([https://sourceforge.net/projects/gestinux/files/Imports%20for%20test/French/Sage%20Ligne%20100%20%28BIJOU%20S.A%29/ SAGE Ligne 100] et [https://sourceforge.net/projects/gestinux/files/Imports%20for%20test/French/APISoft%20Expert%20%28Promatex%29/ APISoft Expert]), are available.

If you can provide other test data (especially in English or languages other than French) please contact the developers on the [http://gestinux.net/forum/viewforum.php?f=10 forum].

You can also define journals manually, from the menu ('''Parameters''', '''Journals'''), or in [[AccountingEntry|Accounting entry]] before selecting a journal.

The data you have to provide is as follows :
* A journal code (10 characters or digits) as a short identifier. It must be unique (i. e. distinct from all other journal codes).
* The journal name (there is a 50 character maximum length) giving the full name of the journal.
* The journal type (''Cash'' to [[BankStatements|match bank statements]], other journal types are not used).
* The account number (For cash journal only)
* Manual entry : if you uncheck this option, this journal will only accept imported data. You will not be able to key data in manually.
* Close date : no import or entry will be possible before this date. If the date is left empty there is no date restriction.

The Close date can be edited (or erased).

== Chart of Accounts ==

Then you have to import or create some ''accounts''. (More documentation will be soon available...)

It is possible to import all this data from separate files, produced by other applications (provided it is in the correct format).
For initial testing, this is the easiest way to begin exploring Gestinux.

Currently, files produced by French accounting software (SAGE 100) are [https://sourceforge.net/projects/gestinux/files/Imports%20for%20test/French/Sage%20Ligne%20100/ provided] which you can import to set up a test accounts database.
If you can provide export files from other accounts software, (originating outside France or in languages other than French), you are welcome to contact the developers.

== Ready to go ==

You can then start [[Using|using Gestinux]]

Initial setup

2013-01-31T23:01:37Z

HowardPC:

{{#CustomTitle:Initial setup}}

Before using Gestinux, you must enter a minimal set of parameters.

# [[Glanguage|Confirm the language]]
# [[Gdatabase|Define and possibly create the database]] to use.

== Company ==

It might be useful to enter some information about the company or organization you want to manage.
This data can be printed on reports.

Note that there is only one company in one database.
Go to the '''Parameters''' menu option and then choose '''Company'''.

== Fiscal periods ==

Go to the '''Parameters''' menu option and then '''Periods''' and click the "+" sign to create at least one active fiscal period.
Dates should be entered in your system's date format.

== Journals ==

Before you can make any accounting entries, you will have to create some journals.

They can be imported from a file or from an accounts database produced by other accounting software. For evaluation purposes, it is advisable to start by importing a set of test data. Please read the page explaining how to [[Import journals/fr|import journals]].

Some example [https://sourceforge.net/projects/gestinux/files/Imports%20for%20test/ sets of test data] which can be imported produced by some French software ([https://sourceforge.net/projects/gestinux/files/Imports%20for%20test/French/Sage%20Ligne%20100%20%28BIJOU%20S.A%29/ SAGE Ligne 100] et [https://sourceforge.net/projects/gestinux/files/Imports%20for%20test/French/APISoft%20Expert%20%28Promatex%29/ APISoft Expert]), are available.

If you can provide other test data (especially in English or languages other than French) please contact the developers on the [http://gestinux.net/forum/viewforum.php?f=10 forum].

You can also define journals manually, from the menu ('''Parameters''', '''Journals'''), or in [[AccountingEntry|Accounting entry]] before selecting a journal.

The data you have to provide is as follows :
* A journal code (10 characters or digits) as a short identifier. It must be unique (i. e. distinct from all other journal codes).
* The journal name (there is a 50 character maximum length) giving the full name of the journal.
* The journal type (''Cash'' to [[BankStatements|match bank statements]], others are not used.
* The account number (For cash journal only)
* Manual entry : if you uncheck this option, this journal will only accept imported data. You will not be able to key data in manually.
* Close date : no import or entry will be possible before this date included. If the date is left empty there is no date restriction.

The Close date can be edited (or erased).

== Chart of Accounts ==

Then you have to import or create some ''accounts''. (More documentation will be soon available...)

It is possible to import all this data from separate files, produced by other applications (provided it is in the correct format).
For initial testing, this is the easiest way to begin exploring Gestinux.

Currently, files produced by French accounting software (SAGE 100) are [https://sourceforge.net/projects/gestinux/files/Imports%20for%20test/French/Sage%20Ligne%20100/ provided] which you can import to set up a test accounts database.
If you can provide export files from other accounts software, (originating outside France or in languages other than French), you are welcome to contact the developers.

== Ready to go ==

You can then start [[Using|using Gestinux]]

Using

2013-01-31T22:40:10Z

HowardPC: /* version 0.5 */

{{#customtitle:Using Gestinux}}

== version 0.5 ==

Version 0.5 is stable, with no severe [https://sourceforge.net/tracker/?group_id=320994&atid=1349206 bugs], but it provides only basic accounting functions.

After [[initial setup]], you can :

* [[Import accounting records]]
* [[AccountingEntry|Create and edit accounting records]]
* [[Perform a reconciliation]]
* The [[GeneralLedger|general ledger]], [[Journal|journal ledger]], and [[Balance|trial balance]] can be printed or exported as a PDF file.
* Import data from the internet and compare online [[BankStatements|bank statements]]
* Build customized [[BalanceSheet|balance sheets]] to be printed or exported as PDF files.

== version 1.0 ==

The version 1.0 is still being developed, so might contain [http://sourceforge.net/tracker/?limit=25&func=&group_id=320994&atid=1349206&assignee=&status=&category=&artgroup=&keyword=&submitter=&artifact_id=&assignee=&status=1&category=&artgroup=&submitter=&keyword=&artifact_id=&submit=Filter bugs], and you should only be used with caution in a production environment.

Features of Gestinux 1.0 include :

* All 0.5 features, with many ergonomic improvements.
* Billing configuration ([[SalesCategories|sales categories]], [[Tariffs|tariffs]], [[Taxes|V.A.T]], other [[Taxes|taxes]], [[PaymentModes|payment methods]], term of payment, product units)
* Locking for multi-user usage
* Ability to add track new [[Customers|customers]], and add and edit [[Products|product items]].
* Create, edit, print and save [[SalesInvoices|invoices]] in PDF format.
* Enter [[CustomerPayments|customer payments]] againts issued invoices.
* Close a [[Periods|fiscal period]], data for which can be stored indefinitely.
* Integrated [[Translation|translation module]], with fall-back language. Ability to toggle from a reference language to another language for translation checking.
* Improved import module for all accounting and billing data.

Developing

2013-01-31T18:53:36Z

HowardPC: /* Developing Gestinux */

= Developing Gestinux =

You are welcome to help make Gestinux better.

Some guidelines for project maintenance follow, which can be discussed in the [https://sourceforge.net/apps/phpbb/gestinux/viewforum.php?f=10 development forum].

Gestinux is being developed using '''Lazarus''' 1.0.4 and '''FreePascal''' 2.6.0.

== Obtaining the sources ==

Gestinux source code is managed using subversion. You must use a SVN Client and connect to it.

With svn only, the command line is : svn checkout http://svn.code.sf.net/p/gestinux/code

Enter your username and password on sourceforge.net

* Version 1.0 is nearly complete and is currently released as a beta version. The svn branch is "trunk".

* Version 0.5 is probably obsolete, owing to changes in FPC, and we don't plan to change anything in the 0.5 branch.

== Packages which are required ==

Release 1.0 should compile with the following packages.
You can use more recent versions of the packages, but at your own risk !

Let us know if using a newer version of any of these packages works sucessfully.

* Zeos DBO 7.0.3-stable
** [https://sourceforge.net/projects/zeoslib/files/Zeos%20Database%20Objects/zeosdbo-7.0.3-stable/ZEOSDBO-7.0.3-stable.zip/download Download] the package and unzip to any directory.
** Open packages/lazarus/zcomponent.lpk and click Install
* Power PDF 0.9.10
** [http://sourceforge.net/projects/lazarus-ccr/files/PowerPDF/powerpdf_0.9.10_20121115.tar.gz/download Download] the package and unzip to any directory.
** Open pack_powerpdf.lpk
** Install.
* LazReport 0.9.8
** Open components/lazreport/source/lazreport.lpk in the Lazarus installation folder (/usr/share/lazarus/<version> on Linux)
** In Options, IDE integration, select "automatically rebuild as needed"
** Install.
* LazReportPDFExport 0.7
** Open components/lazreport/source/addons/pdfexport/lazreportpdfexport.lpk in Lazarus installed files.
** In Options, IDE integration, select "automatically rebuild as needed"
** Install
* [[Gestinux_util]] 1.1 : a package containing the components Gestinux uses
** Open util/gestinux_util.dpk in the gestinux sources (svn)
** Install.

Sometimes, for unknown reasons, you have to rebuild Lazarus with the option: clean+build all...
Installing and rebuilding after each package is longer, but safer. Otherwise you will often get problems.

== Gestinux development Rules ==

* The source must be compilable with : Lazarus 1.0.4 and FPC 2.6.0
* Do not use features available only in Lazarus 1.1 or other SVN.
* Only use English for identifiers and comments.
* Use the Code Formatter (CTRL+D) to indent modified sources, with default options.
* Read the [[gestinux_util]] documentation, and do not use a Txxxx component when there is a TGxxxx component in this package

Ask to be granted a developer profile in SourceForge.
Don't forget to lock the files before any change.

== What to do ==

Everyone can help !
If you are a beginner, there are some simple things you can do, and this would save time.
For gurus, we do need better components.

You can [https://sourceforge.net/tracker/?limit=25&group_id=320994&atid=1349209&status=1submit=Filter look at the Tracker] to see what is the most useful improvement you might make.

Before starting anything, you are advised to discuss your proposal a bit in the [http://gestinux.net/forum/index.php forum].

= Translation system =

Refer to the [[Internationalisation programmation]] page to learn how you can use it and offer translations for Gestinux.

= Database =

== Supported DBMS ==

MySql 5 and PostgreSQL are supported.
My Sql because it is common and administration is quite simple.
PostgreSql because it is completely free software.
In the future, we may try other DBMS, but that would require a bigger development team.

In the main sources, avoid SQL statements specific to MySQL or Postgres.
When there is no alternative, compatibility procedures should be made. They are all centralized in one unit (unitdatamodule.pas for now).

== Table and fields definitions and properties ==

In [[Gestinux_util]] there is a [[TGTable]] component used to store all the metadata of tables used in Gestinux. With this component, there is no need to store table definitions elsewhere, and no SQL script is required to initialize or upgrade the database.

The database and table structures are created by the main executable, as specified in unitdatamodule.pas, in [[TGTable]] properties. See the component [[TGTable]] for more details.

Developing

2013-01-31T18:53:04Z

HowardPC: minor edits

= Developing Gestinux =

You are welcome to help make Gestinux better.

Some guidelines for project maintenance follow, which can be discueed in the [https://sourceforge.net/apps/phpbb/gestinux/viewforum.php?f=10 development forum].

Gestinux is being developed using '''Lazarus''' 1.0.4 and '''FreePascal''' 2.6.0.

== Obtaining the sources ==

Gestinux source code is managed using subversion. You must use a SVN Client and connect to it.

With svn only, the command line is : svn checkout http://svn.code.sf.net/p/gestinux/code

Enter your username and password on sourceforge.net

* Version 1.0 is nearly complete and is currently released as a beta version. The svn branch is "trunk".

* Version 0.5 is probably obsolete, owing to changes in FPC, and we don't plan to change anything in the 0.5 branch.

== Packages which are required ==

Release 1.0 should compile with the following packages.
You can use more recent versions of the packages, but at your own risk !

Let us know if using a newer version of any of these packages works sucessfully.

* Zeos DBO 7.0.3-stable
** [https://sourceforge.net/projects/zeoslib/files/Zeos%20Database%20Objects/zeosdbo-7.0.3-stable/ZEOSDBO-7.0.3-stable.zip/download Download] the package and unzip to any directory.
** Open packages/lazarus/zcomponent.lpk and click Install
* Power PDF 0.9.10
** [http://sourceforge.net/projects/lazarus-ccr/files/PowerPDF/powerpdf_0.9.10_20121115.tar.gz/download Download] the package and unzip to any directory.
** Open pack_powerpdf.lpk
** Install.
* LazReport 0.9.8
** Open components/lazreport/source/lazreport.lpk in the Lazarus installation folder (/usr/share/lazarus/<version> on Linux)
** In Options, IDE integration, select "automatically rebuild as needed"
** Install.
* LazReportPDFExport 0.7
** Open components/lazreport/source/addons/pdfexport/lazreportpdfexport.lpk in Lazarus installed files.
** In Options, IDE integration, select "automatically rebuild as needed"
** Install
* [[Gestinux_util]] 1.1 : a package containing the components Gestinux uses
** Open util/gestinux_util.dpk in the gestinux sources (svn)
** Install.

Sometimes, for unknown reasons, you have to rebuild Lazarus with the option: clean+build all...
Installing and rebuilding after each package is longer, but safer. Otherwise you will often get problems.

== Gestinux development Rules ==

* The source must be compilable with : Lazarus 1.0.4 and FPC 2.6.0
* Do not use features available only in Lazarus 1.1 or other SVN.
* Only use English for identifiers and comments.
* Use the Code Formatter (CTRL+D) to indent modified sources, with default options.
* Read the [[gestinux_util]] documentation, and do not use a Txxxx component when there is a TGxxxx component in this package

Ask to be granted a developer profile in SourceForge.
Don't forget to lock the files before any change.

== What to do ==

Everyone can help !
If you are a beginner, there are some simple things you can do, and this would save time.
For gurus, we do need better components.

You can [https://sourceforge.net/tracker/?limit=25&group_id=320994&atid=1349209&status=1submit=Filter look at the Tracker] to see what is the most useful improvement you might make.

Before starting anything, you are advised to discuss your proposal a bit in the [http://gestinux.net/forum/index.php forum].

= Translation system =

Refer to the [[Internationalisation programmation]] page to learn how you can use it and offer translations for Gestinux.

= Database =

== Supported DBMS ==

MySql 5 and PostgreSQL are supported.
My Sql because it is common and administration is quite simple.
PostgreSql because it is completely free software.
In the future, we may try other DBMS, but that would require a bigger development team.

In the main sources, avoid SQL statements specific to MySQL or Postgres.
When there is no alternative, compatibility procedures should be made. They are all centralized in one unit (unitdatamodule.pas for now).

== Table and fields definitions and properties ==

In [[Gestinux_util]] there is a [[TGTable]] component used to store all the metadata of tables used in Gestinux. With this component, there is no need to store table definitions elsewhere, and no SQL script is required to initialize or upgrade the database.

The database and table structures are created by the main executable, as specified in unitdatamodule.pas, in [[TGTable]] properties. See the component [[TGTable]] for more details.

Install Postgresql client driver

2013-01-31T18:37:24Z

HowardPC: minor edits

{{#CustomTitle:Client for a PostgreSql database}}

Under Ubuntu, to run a client of a Postgresql database you have to install an additional driver.

You do this in a terminal window using the following two commands:

* sudo apt-get install postgresql-client
* sudo ln -s /usr/lib/libpq.so.5.4 /usr/lib/libpq.so

Install server

2013-01-31T18:33:11Z

HowardPC: /* To install MySql server : */

{{#CustomTitle:Installing a server}}

[[Installing|Back to Gestinux installation]]

If you do not want to use a database hosted in the internet, Gestinux requires either '''MySql Server''' (>= 5.0) or '''PostgreSQL Server''' (>= 8.4) installed on your local system, or on any server your network can access.

The easiest installation is setting up MySql on Linux.

The power of current computers means you will still have spare processing capacity after installing a server locally.

You must have an ''administrator'' account before you can install.

The following is a short guide to installing either MySql or PostgresSQL. For more details, please refer to the official documentation.

===To install MySql server :===

* On Ubuntu :
** Use Synaptic to install the package '''mysql-server'''.
** Confirm a few options
** You can enter a blank password for the root account if you are evaluating.
* On Windows :
** Go to the [http://dev.mysql.com/downloads/mysql/ mysql download page]
** Download the appropriate installer (in most cases, the first one)
** Execute the setup.exe, using a privileged account.
** You can accept the default options
** You can choose a standard configuration
** A non-blank root password is required: '''Remember it''' !

===To install PostgreSQL server :===

* On Ubuntu :
** Install the package '''postgresql'''
* On Windows
** To be documented...

[[Installing|Back to Gestinux installation]]

Install server

2013-01-31T18:31:39Z

HowardPC: minor edits

{{#CustomTitle:Installing a server}}

[[Installing|Back to Gestinux installation]]

If you do not want to use a database hosted in the internet, Gestinux requires either '''MySql Server''' (>= 5.0) or '''PostgreSQL Server''' (>= 8.4) installed on your local system, or on any server your network can access.

The easiest installation is setting up MySql on Linux.

The power of current computers means you will still have spare processing capacity after installing a server locally.

You must have an ''administrator'' account before you can install.

The following is a short guide to installing either MySql or PostgresSQL. For more details, please refer to the official documentation.

===To install MySql server :===

* On Ubuntu :
** Use Synaptic to install the package '''mysql-server'''.
** Confirm a few options
** You can enter a blank password for the root account if you are evaluating.
* On Windows :
** Go to [http://dev.mysql.com/downloads/mysql/ mysql download page]
** Download the appropriate installer (in most cases, the first one)
** Execute the setup.exe, using a privileged account.
** You can accept the default options
** You can choose a standard configuration
** A non-blank root password is required: '''Remember it''' !

===To install PostgreSQL server :===

* On Ubuntu :
** Install the package '''postgresql'''
* On Windows
** To be documented...

[[Installing|Back to Gestinux installation]]

Installing

2013-01-21T17:34:42Z

HowardPC: /* After installation */

{{#customtitle:Gestinux installation}}

[[installing/fr|Français]]

== Supported Systems ==

Gestinux runs on '''Linux''' and '''Windows'''.

Gestinux 0.5 can be installed easily from Ubuntu 09.10 (Karmic Koala) up to Ubuntu 11.04 (Natty Narwhal), and it should work on most other flavours of Linux. Feedback is welcome! On Ubuntu >= 11.10 or other Linux distributions the main issue is the requirement to install drivers either for MySql or PostgreSQL. Gestinux has not been tested with early Unity releases.

Gestinux 1.0 can be installed easily to use MySql on all the above Ubuntu versions.

We have reports of successful Gestinux installations on Windows (from Windows 2000 to Windows 7), though it has not yet been tested on Windows 8. It does not support Windows versions older than Windows 2000.

There is a 64-bit Gestinux 1.0 version for the AMD-64 processor family.

Currently Gestinux is not available for the Mac. It will be available for Mac operating systems as soon as a Mac owner joins the developer team, to compile, package and test...

== Location of programs and data ==

Gestinux is a client-server database application.

You have to install a ''client'' program on each computer where Gestinux is used. Installing the (lightweight) client program can be done easily with just a few mouse clicks. After that, you just need to decide where to locate the supporting database.

This database can be:

* accessed remotely via an internet server.
* stored locally on the same computer as the client program.
* located on any workstation or dedicated server in your local network.

The first solution can be used to access a [[Test_database|test database]].

If you don't mind having your data stored outside your office, and if you have a good internet connection, you can adopt this first remote option, using any internet host. In this case, there is no need for a local server, and you can access your data from any location. Performance will be better than with a full web application. However, some technical knowledge is required to ensure full data security.

Otherwise, for a small company, the second solution is simple. It is easy to [[install server|install a free database server]] on a workstation.

For more advanced users, or a larger company, the dedicated server is a better option, while still being easy to implement.

== Installation of Client program ==

=== Installation of Gestinux 0.5 (stable but limited) ===

* On '''Linux Debian (Ubuntu)''' :
** Download and execute the [https://sourceforge.net/projects/gestinux/files/Release%20candidate/gestinux_0.5-rc-2_Ubuntu.deb/download debian package]
** Run Gestinux from the '''Office''' menu.

* On '''Windows''' :
** Download the [https://sourceforge.net/projects/gestinux/files/Release%20candidate/gestinux_0.5-rc-2_Windows.exe/download installation package]
** Execute the downloaded installer, following the directions given.
** Run the installed application from a desktop shortcut; or choose '''Gestinux''' from the '''Start Menu'''.

=== Installation of Gestinux 1.0 ===

* On '''Linux Debian (Ubuntu)''' :
** Download the latest Linux package (32-bit or 64-bit, depending on your processor) in [https://sourceforge.net/projects/gestinux/files/Beta%20release/ this folder].
** Gestinux can use MySql immediately. A further step is required to set up Gestinux to use Postgresql. See [[client of a Postgresql database|Install Postgresql client driver]]
** Open the file to install Gestinux.
** Run from the '''Office''' menu or via the command-line: /usr/bin/gestinux

* On '''Windows''' :
** Download the latest Windows package (32-bit or 64-bit, depending on your processor) in [https://sourceforge.net/projects/gestinux/files/Beta%20release/ this folder].
** Execute the installer, following the instructions given.
** Run Gestinux from a desktop shortcut, or from the '''Start Menu''' | '''gestinux'''

=== Development version ===

If you are a developer, you can download and [[Developing|compile the source yourself]].

== After installation ==

Installation does not create a database and will not alter any data.
After installation, you must run Gestinux and perform the [[initial setup]] to create (or upgrade) your database.

Installing

2013-01-21T17:33:06Z

HowardPC: /* Development version */

{{#customtitle:Gestinux installation}}

[[installing/fr|Français]]

== Supported Systems ==

Gestinux runs on '''Linux''' and '''Windows'''.

Gestinux 0.5 can be installed easily from Ubuntu 09.10 (Karmic Koala) up to Ubuntu 11.04 (Natty Narwhal), and it should work on most other flavours of Linux. Feedback is welcome! On Ubuntu >= 11.10 or other Linux distributions the main issue is the requirement to install drivers either for MySql or PostgreSQL. Gestinux has not been tested with early Unity releases.

Gestinux 1.0 can be installed easily to use MySql on all the above Ubuntu versions.

We have reports of successful Gestinux installations on Windows (from Windows 2000 to Windows 7), though it has not yet been tested on Windows 8. It does not support Windows versions older than Windows 2000.

There is a 64-bit Gestinux 1.0 version for the AMD-64 processor family.

Currently Gestinux is not available for the Mac. It will be available for Mac operating systems as soon as a Mac owner joins the developer team, to compile, package and test...

== Location of programs and data ==

Gestinux is a client-server database application.

You have to install a ''client'' program on each computer where Gestinux is used. Installing the (lightweight) client program can be done easily with just a few mouse clicks. After that, you just need to decide where to locate the supporting database.

This database can be:

* accessed remotely via an internet server.
* stored locally on the same computer as the client program.
* located on any workstation or dedicated server in your local network.

The first solution can be used to access a [[Test_database|test database]].

If you don't mind having your data stored outside your office, and if you have a good internet connection, you can adopt this first remote option, using any internet host. In this case, there is no need for a local server, and you can access your data from any location. Performance will be better than with a full web application. However, some technical knowledge is required to ensure full data security.

Otherwise, for a small company, the second solution is simple. It is easy to [[install server|install a free database server]] on a workstation.

For more advanced users, or a larger company, the dedicated server is a better option, while still being easy to implement.

== Installation of Client program ==

=== Installation of Gestinux 0.5 (stable but limited) ===

* On '''Linux Debian (Ubuntu)''' :
** Download and execute the [https://sourceforge.net/projects/gestinux/files/Release%20candidate/gestinux_0.5-rc-2_Ubuntu.deb/download debian package]
** Run Gestinux from the '''Office''' menu.

* On '''Windows''' :
** Download the [https://sourceforge.net/projects/gestinux/files/Release%20candidate/gestinux_0.5-rc-2_Windows.exe/download installation package]
** Execute the downloaded installer, following the directions given.
** Run the installed application from a desktop shortcut; or choose '''Gestinux''' from the '''Start Menu'''.

=== Installation of Gestinux 1.0 ===

* On '''Linux Debian (Ubuntu)''' :
** Download the latest Linux package (32-bit or 64-bit, depending on your processor) in [https://sourceforge.net/projects/gestinux/files/Beta%20release/ this folder].
** Gestinux can use MySql immediately. A further step is required to set up Gestinux to use Postgresql. See [[client of a Postgresql database|Install Postgresql client driver]]
** Open the file to install Gestinux.
** Run from the '''Office''' menu or via the command-line: /usr/bin/gestinux

* On '''Windows''' :
** Download the latest Windows package (32-bit or 64-bit, depending on your processor) in [https://sourceforge.net/projects/gestinux/files/Beta%20release/ this folder].
** Execute the installer, following the instructions given.
** Run Gestinux from a desktop shortcut, or from the '''Start Menu''' | '''gestinux'''

=== Development version ===

If you are a developer, you can download and [[Developing|compile the source yourself]].

== After installation ==

Installation do not create any database and will not alter any data.
After installation, run Gestinux and perform the [[initial setup]] to create or upgrade your database.

Installing

2013-01-21T17:32:15Z

HowardPC: /* Installation of Gestinux 1.0 */

{{#customtitle:Gestinux installation}}

[[installing/fr|Français]]

== Supported Systems ==

Gestinux runs on '''Linux''' and '''Windows'''.

Gestinux 0.5 can be installed easily from Ubuntu 09.10 (Karmic Koala) up to Ubuntu 11.04 (Natty Narwhal), and it should work on most other flavours of Linux. Feedback is welcome! On Ubuntu >= 11.10 or other Linux distributions the main issue is the requirement to install drivers either for MySql or PostgreSQL. Gestinux has not been tested with early Unity releases.

Gestinux 1.0 can be installed easily to use MySql on all the above Ubuntu versions.

We have reports of successful Gestinux installations on Windows (from Windows 2000 to Windows 7), though it has not yet been tested on Windows 8. It does not support Windows versions older than Windows 2000.

There is a 64-bit Gestinux 1.0 version for the AMD-64 processor family.

Currently Gestinux is not available for the Mac. It will be available for Mac operating systems as soon as a Mac owner joins the developer team, to compile, package and test...

== Location of programs and data ==

Gestinux is a client-server database application.

You have to install a ''client'' program on each computer where Gestinux is used. Installing the (lightweight) client program can be done easily with just a few mouse clicks. After that, you just need to decide where to locate the supporting database.

This database can be:

* accessed remotely via an internet server.
* stored locally on the same computer as the client program.
* located on any workstation or dedicated server in your local network.

The first solution can be used to access a [[Test_database|test database]].

If you don't mind having your data stored outside your office, and if you have a good internet connection, you can adopt this first remote option, using any internet host. In this case, there is no need for a local server, and you can access your data from any location. Performance will be better than with a full web application. However, some technical knowledge is required to ensure full data security.

Otherwise, for a small company, the second solution is simple. It is easy to [[install server|install a free database server]] on a workstation.

For more advanced users, or a larger company, the dedicated server is a better option, while still being easy to implement.

== Installation of Client program ==

=== Installation of Gestinux 0.5 (stable but limited) ===

* On '''Linux Debian (Ubuntu)''' :
** Download and execute the [https://sourceforge.net/projects/gestinux/files/Release%20candidate/gestinux_0.5-rc-2_Ubuntu.deb/download debian package]
** Run Gestinux from the '''Office''' menu.

* On '''Windows''' :
** Download the [https://sourceforge.net/projects/gestinux/files/Release%20candidate/gestinux_0.5-rc-2_Windows.exe/download installation package]
** Execute the downloaded installer, following the directions given.
** Run the installed application from a desktop shortcut; or choose '''Gestinux''' from the '''Start Menu'''.

=== Installation of Gestinux 1.0 ===

* On '''Linux Debian (Ubuntu)''' :
** Download the latest Linux package (32-bit or 64-bit, depending on your processor) in [https://sourceforge.net/projects/gestinux/files/Beta%20release/ this folder].
** Gestinux can use MySql immediately. A further step is required to set up Gestinux to use Postgresql. See [[client of a Postgresql database|Install Postgresql client driver]]
** Open the file to install Gestinux.
** Run from the '''Office''' menu or via the command-line: /usr/bin/gestinux

* On '''Windows''' :
** Download the latest Windows package (32-bit or 64-bit, depending on your processor) in [https://sourceforge.net/projects/gestinux/files/Beta%20release/ this folder].
** Execute the installer, following the instructions given.
** Run Gestinux from a desktop shortcut, or from the '''Start Menu''' | '''gestinux'''

=== Development version ===

If you are a developer, you can download and [[Developing|compile yourself]] sources.

== After installation ==

Installation do not create any database and will not alter any data.
After installation, run Gestinux and perform the [[initial setup]] to create or upgrade your database.

Installing

2013-01-21T17:22:21Z

HowardPC: /* Installation of Gestinux 0.5 (stable but limited) */

{{#customtitle:Gestinux installation}}

[[installing/fr|Français]]

== Supported Systems ==

Gestinux runs on '''Linux''' and '''Windows'''.

Gestinux 0.5 can be installed easily from Ubuntu 09.10 (Karmic Koala) up to Ubuntu 11.04 (Natty Narwhal), and it should work on most other flavours of Linux. Feedback is welcome! On Ubuntu >= 11.10 or other Linux distributions the main issue is the requirement to install drivers either for MySql or PostgreSQL. Gestinux has not been tested with early Unity releases.

Gestinux 1.0 can be installed easily to use MySql on all the above Ubuntu versions.

We have reports of successful Gestinux installations on Windows (from Windows 2000 to Windows 7), though it has not yet been tested on Windows 8. It does not support Windows versions older than Windows 2000.

There is a 64-bit Gestinux 1.0 version for the AMD-64 processor family.

Currently Gestinux is not available for the Mac. It will be available for Mac operating systems as soon as a Mac owner joins the developer team, to compile, package and test...

== Location of programs and data ==

Gestinux is a client-server database application.

You have to install a ''client'' program on each computer where Gestinux is used. Installing the (lightweight) client program can be done easily with just a few mouse clicks. After that, you just need to decide where to locate the supporting database.

This database can be:

* accessed remotely via an internet server.
* stored locally on the same computer as the client program.
* located on any workstation or dedicated server in your local network.

The first solution can be used to access a [[Test_database|test database]].

If you don't mind having your data stored outside your office, and if you have a good internet connection, you can adopt this first remote option, using any internet host. In this case, there is no need for a local server, and you can access your data from any location. Performance will be better than with a full web application. However, some technical knowledge is required to ensure full data security.

Otherwise, for a small company, the second solution is simple. It is easy to [[install server|install a free database server]] on a workstation.

For more advanced users, or a larger company, the dedicated server is a better option, while still being easy to implement.

== Installation of Client program ==

=== Installation of Gestinux 0.5 (stable but limited) ===

* On '''Linux Debian (Ubuntu)''' :
** Download and execute the [https://sourceforge.net/projects/gestinux/files/Release%20candidate/gestinux_0.5-rc-2_Ubuntu.deb/download debian package]
** Run Gestinux from the '''Office''' menu.

* On '''Windows''' :
** Download the [https://sourceforge.net/projects/gestinux/files/Release%20candidate/gestinux_0.5-rc-2_Windows.exe/download installation package]
** Execute the downloaded installer, following the directions given.
** Run the installed application from a desktop shortcut; or choose '''Gestinux''' from the '''Start Menu'''.

=== Installation of Gestinux 1.0 ===

* On '''Linux Debian (Ubuntu)''' :
** Download the last package for Linux (32 bits or 64 bits, depending on your processor) in [https://sourceforge.net/projects/gestinux/files/Beta%20release/ this folder].
** Gestinux will be ready to use MySql. There is a little more to do to be [[client of a Postgresql database|Install Postgresql client driver]]
** Open the file to install.
** Run from the '''Office''' menu or /usr/bin/gestinux

* On '''Windows''' :
** Download the last package for Windows (32 bits or 64 bits, depending on your processor) in [https://sourceforge.net/projects/gestinux/files/Beta%20release/ this folder].
** Execute and follow instructions.
** Run from desktop shortcut, or from Menu '''Start''', '''gestinux'''

=== Development version ===

If you are a developer, you can download and [[Developing|compile yourself]] sources.

== After installation ==

Installation do not create any database and will not alter any data.
After installation, run Gestinux and perform the [[initial setup]] to create or upgrade your database.

Installing

2013-01-21T17:18:21Z

HowardPC: /* Location of programs and data */

{{#customtitle:Gestinux installation}}

[[installing/fr|Français]]

== Supported Systems ==

Gestinux runs on '''Linux''' and '''Windows'''.

Gestinux 0.5 can be installed easily from Ubuntu 09.10 (Karmic Koala) up to Ubuntu 11.04 (Natty Narwhal), and it should work on most other flavours of Linux. Feedback is welcome! On Ubuntu >= 11.10 or other Linux distributions the main issue is the requirement to install drivers either for MySql or PostgreSQL. Gestinux has not been tested with early Unity releases.

Gestinux 1.0 can be installed easily to use MySql on all the above Ubuntu versions.

We have reports of successful Gestinux installations on Windows (from Windows 2000 to Windows 7), though it has not yet been tested on Windows 8. It does not support Windows versions older than Windows 2000.

There is a 64-bit Gestinux 1.0 version for the AMD-64 processor family.

Currently Gestinux is not available for the Mac. It will be available for Mac operating systems as soon as a Mac owner joins the developer team, to compile, package and test...

== Location of programs and data ==

Gestinux is a client-server database application.

You have to install a ''client'' program on each computer where Gestinux is used. Installing the (lightweight) client program can be done easily with just a few mouse clicks. After that, you just need to decide where to locate the supporting database.

This database can be:

* accessed remotely via an internet server.
* stored locally on the same computer as the client program.
* located on any workstation or dedicated server in your local network.

The first solution can be used to access a [[Test_database|test database]].

If you don't mind having your data stored outside your office, and if you have a good internet connection, you can adopt this first remote option, using any internet host. In this case, there is no need for a local server, and you can access your data from any location. Performance will be better than with a full web application. However, some technical knowledge is required to ensure full data security.

Otherwise, for a small company, the second solution is simple. It is easy to [[install server|install a free database server]] on a workstation.

For more advanced users, or a larger company, the dedicated server is a better option, while still being easy to implement.

== Installation of Client program ==

=== Installation of Gestinux 0.5 (stable but limited) ===

* On '''Linux Debian (Ubuntu)''' :
** Download and execute the [https://sourceforge.net/projects/gestinux/files/Release%20candidate/gestinux_0.5-rc-2_Ubuntu.deb/download debian package]
** Run from the '''Office''' menu.

* On '''Windows''' :
** Download the [https://sourceforge.net/projects/gestinux/files/Release%20candidate/gestinux_0.5-rc-2_Windows.exe/download installation package]
** Execute and follow instructions.
** Run from desktop shortcut, or from Menu '''Start''', '''gestinux'''

=== Installation of Gestinux 1.0 ===

* On '''Linux Debian (Ubuntu)''' :
** Download the last package for Linux (32 bits or 64 bits, depending on your processor) in [https://sourceforge.net/projects/gestinux/files/Beta%20release/ this folder].
** Gestinux will be ready to use MySql. There is a little more to do to be [[client of a Postgresql database|Install Postgresql client driver]]
** Open the file to install.
** Run from the '''Office''' menu or /usr/bin/gestinux

* On '''Windows''' :
** Download the last package for Windows (32 bits or 64 bits, depending on your processor) in [https://sourceforge.net/projects/gestinux/files/Beta%20release/ this folder].
** Execute and follow instructions.
** Run from desktop shortcut, or from Menu '''Start''', '''gestinux'''

=== Development version ===

If you are a developer, you can download and [[Developing|compile yourself]] sources.

== After installation ==

Installation do not create any database and will not alter any data.
After installation, run Gestinux and perform the [[initial setup]] to create or upgrade your database.

Installing

2013-01-21T17:01:39Z

HowardPC: /* Supported Systems */

{{#customtitle:Gestinux installation}}

[[installing/fr|Français]]

== Supported Systems ==

Gestinux runs on '''Linux''' and '''Windows'''.

Gestinux 0.5 can be installed easily from Ubuntu 09.10 (Karmic Koala) up to Ubuntu 11.04 (Natty Narwhal), and it should work on most other flavours of Linux. Feedback is welcome! On Ubuntu >= 11.10 or other Linux distributions the main issue is the requirement to install drivers either for MySql or PostgreSQL. Gestinux has not been tested with early Unity releases.

Gestinux 1.0 can be installed easily to use MySql on all the above Ubuntu versions.

We have reports of successful Gestinux installations on Windows (from Windows 2000 to Windows 7), though it has not yet been tested on Windows 8. It does not support Windows versions older than Windows 2000.

There is a 64-bit Gestinux 1.0 version for the AMD-64 processor family.

Currently Gestinux is not available for the Mac. It will be available for Mac operating systems as soon as a Mac owner joins the developer team, to compile, package and test...

== Location of programs and data ==

Gestinux is an application using a client-server database.

You have always to install a ''client'' program on each computer you want to use. It is light and very easy, and can be done with a few clicks. After that, you just need to choose where is located the database.

This database can be :

* On a remote server, reachable through internet.
* On the same computer as the client program.
* On any other workstation or dedicated server in the local network.

The first solution can be used to access a [[Test_database|test database]].

If you don't mind having your data out of your office, and if you have a good internet connection, you can use this solution, with a hoster. In this case, no need for a local server, and you can access from anywhere. Performances will be better than with a full web application. However, some technical knowledge is required for data security.

Otherwise, for a small company, the second solution is simple. It is easy to [[install server|install a free database server]] on a workstation.

For a more advanced usage, or a larger company, the dedicated server is better and remains easy to implement.

== Installation of Client program ==

=== Installation of Gestinux 0.5 (stable but limited) ===

* On '''Linux Debian (Ubuntu)''' :
** Download and execute the [https://sourceforge.net/projects/gestinux/files/Release%20candidate/gestinux_0.5-rc-2_Ubuntu.deb/download debian package]
** Run from the '''Office''' menu.

* On '''Windows''' :
** Download the [https://sourceforge.net/projects/gestinux/files/Release%20candidate/gestinux_0.5-rc-2_Windows.exe/download installation package]
** Execute and follow instructions.
** Run from desktop shortcut, or from Menu '''Start''', '''gestinux'''

=== Installation of Gestinux 1.0 ===

* On '''Linux Debian (Ubuntu)''' :
** Download the last package for Linux (32 bits or 64 bits, depending on your processor) in [https://sourceforge.net/projects/gestinux/files/Beta%20release/ this folder].
** Gestinux will be ready to use MySql. There is a little more to do to be [[client of a Postgresql database|Install Postgresql client driver]]
** Open the file to install.
** Run from the '''Office''' menu or /usr/bin/gestinux

* On '''Windows''' :
** Download the last package for Windows (32 bits or 64 bits, depending on your processor) in [https://sourceforge.net/projects/gestinux/files/Beta%20release/ this folder].
** Execute and follow instructions.
** Run from desktop shortcut, or from Menu '''Start''', '''gestinux'''

=== Development version ===

If you are a developer, you can download and [[Developing|compile yourself]] sources.

== After installation ==

Installation do not create any database and will not alter any data.
After installation, run Gestinux and perform the [[initial setup]] to create or upgrade your database.