The faq is now on the website

This commit is contained in:
sparkyx 2008-01-09 12:41:05 +00:00
parent 8c347d500f
commit b2ed86e13f
2 changed files with 0 additions and 593 deletions

View file

@ -1,277 +0,0 @@
<!doctype linuxdoc system>
<article>
<title> PhpCompta FAQ</title>
<author>
<name>originally written by Dany De Bontridder
</name>
</author>
<date>$Revision$</date>
<abstract>
Ce document contient les réponses aux questions les plus fréquemment posées sur
PhpCompta <url url="http://www.alchimerys.be/FR/phpcompta" name="PhpCompta">
site savannah
<url url="http://savannah.nongnu.org/projects/phpcompta/" name="PhpCompta Savannah">
</abstract>
<!-- Table of contents -->
<toc>
<sect> Qu'est-ce que PhpCompta ?
<P>PhpCompta est un logiciel <url url="http://www.gnu.org/licenses/gpl.html" name="GPL">
adapté à la législation
belge en matière de comptabilité, il vous permet de tenir votre comptabilité de
manière centralisée.Il a été crée pour supporter diverses comptabilités d'autres
pays mais par manque de documentation, celle-ci ne sont pas encore implémentées, idem
pour les traductions. </P>
<P>Si vous voulez contribuez n'hésitez pas :
<url url="http://mail.nongnu.org/mailman/listinfo/phpcompta-contrib" name="Mailing List Contribution">
<newline> Si vous avez besoin d'aide
<url url="http://mail.nongnu.org/mailman/listinfo/phpcompta-support" name="Mailing List support">.
</p>
<sect> Quel le nom du soft ??
<p>
<verb>
- phpcompta,
- wcompta,
- webcompta
</verb>
</p>
<p>
En fait c'est phpcompta, bien qu'au départ c'était wcompta, contraction de
WebCompta mais malheureusement, c'est le nom d'un soft qui existait
déjà, j'ai été obligé de changer vers phpcompta.
</p>
<p>
Cependant PhpCompta est un nom temporaire, il sera changé le jour où
quelqu'un proposera mieux. Si ce nom doit être changé, c'est par respect envers
l'équipe de Php qui ne souhaite pas que le mot Php soit réutilisé dans d'autres
applications.
</p>
</sect>
<sect>Par où commence t'on et comment ?
<p>
Étape 1, créer un dossier, qui contiendra la comptabilité d'une
entreprise (sur 1 an ou plus).
<itemize>
<item> Menu Administration -> Dossier, choisir un nom pour le dossier, create
folder
<item> Étape 2, on peut créer des utilisateurs mais ce n'est pas obligatoire.
<item> Étape 3, on revient à l'accueil :)
</itemize>
</p>
<p>
Si vous avez pris Comptabilité basique, vous devrez créer les journaux,
les fiches, mettre à jour votre plan comptable... Allez voir dans le
répertoire doc du tarball
</p>
</sect>
<sect>Ou trouvez les patches
<p>
Sur <url url="http://www.phpcompta.org/" name="Site phpcompta"> la page d'origine,
malheureusement, il n'est pas encore possible de télécharger des fichiers sur Savannah
</p>
</sect>
<sect>Comment adapter le fichier php.ini <label id="php-setting">
<p>
<quote>
Avec PHP 4.3.1 :
Les variables sont passés de page en page dans un tableau _POST[nom_var] alors
qu'avec les versions précédentes, on y accédait directement avec $nom_var
voir la variable register_globale = off dans le php.ini
</quote>
php.ini doit contenir pour phpcompta, cependant il n'est pas certain qu'il faille changer
ces paramètres, vous devez aller sur admin/setup.php pour voir ce qui doit être fait
<verb>
[PHP]
include_path=".:../include:../../include:addon"
[Session]
session.name = PHPSESSID
; name of the session
; is used as cookie name
session.auto_start = 1 ; initialize session on request startup
session.cookie_lifetime = 0 ; lifetime in seconds of cookie
; or if 0, until browser is restarted
session.cookie_path = /tmp ; the path the cookie is valid for
</verb>
lors de l'installation (admin/setup.php), on vérifie que toutes les paramètres d'initialisation sont
corrects.
</sect>
<sect>Quand réinitialise t-on le mot de passe, que vaut-il ?
<p>phpcompta</p>
<sect>Quel est l'utilisateur et le mot de passe par défaut?
<p>
l'utilisateur et le mot de passe par défaut sont phpcompta/phpcompta,
l'utilisateur demo a aussi phpcompta comme mot de passe.
</p>
</sect>
<sect>J'ai trouvé un tit bug, comment faire un patchs ??<label id="bug">
<p>
Le plus simplement du monde : d'abord récupérez le projet ,
corrigez le problème que vous avez détecté, placez-vous à la
racine du projet et vous tapez :
<verb>
cvs diff -rrelease -u > patch-date-email
</verb>
Pensez à d'abord effacer les fichiers inutiles, les ~, les corefiles...
Vous pouvez envoyer le fichier résultat. Pensez à me dire si c'est un
patch relatif aux cvs ou non. Mais testez-le avant.
remplacer release par la release (allez sur savannah, browse CVS pour connaitre
le nom du tag que vous voulez)
</p>
<p> Pour tester les patch,
<p>
Pour le tester, faites un cvs co dans un autre répertoire que celui où vous
avez développé votre patch, puis essayer votre patch
<verb>
patch -p0 &lt; patch-(numéro de version)-votre-email </verb>si vous êtes dans le
répertoire au-dessus de celui de phpcompta
<verb>patch -p1 &lt; patch-(numéro de version)-votre-email</verb> si vous êtes dans le
répertoire courant de phpcompta
</p>
<p>
Si cela ne marche pas ce n'est pas bon
</p>
</sect>
<sect> Comment faire de la doc
<p>
Sous Mandriva (anciennement mandrake), ajouter les linuxdocs-tools avec la commande
urpmi linuxdoc-tools, pour Ubuntu apt-get install linuxdoc-tools, tetex, tetex-extra
les autres, je ne sais pas :(
</p>
<p>
Une fois, les linuxdoc tools installés il peut être nécessaire
d'installer d'autres outils comme jade, sgml,...
Il faudra en tout cas ajouter les tetex-dvips, textex-xdvi, latex2html
<p>
De toute façon, vous
pouvez imprimer le guide, pour le trouver faites :
<verb> en mode commande : rpm -qil linuxdoc-tools|grep guide</verb>
</p>
<p>Jetez aussi un oeil sur les exemples, vous verrez c'est assez simple
<verb>en mode commande: rpm -qil linuxdoc-tools|grep example</verb>
</p>
<p>
Ensuite, editez le fichier sgml,
et surtout pensez à utilisez aspell -H --lang=fr_FR check FA-fr.sgml pour
véifier l'orthographe. Pour le visionner, faites linuxdoc -B html FAQ.sgml
soit linuxdoc -B rtf pour avoir un fichier rtf... Puis faites un patch :-)
<ref id="bug" name="Comment faire un patch">
</p>
<sect>Comment contribuer ?
<p>Sur le site de Savannah, j'ai décidé d'utilisé le Task Manager,
chacun s'organise comme il veut, soit il m'envoie son travail par email soit il
se joint au projet. Je préfère que l'on travaille par email au début.
</p>
<p>
L'intérêt de ce système est de pouvoir voir le suivi mais aussi d'ajouter des commentaires
sur un sujet
<url url="http://savannah.nongnu.org/task/?group=phpcompta" name="PhpCompta Task Manager">.
</p>
<p>
Cela m'évite de devoir chaque fois changer sur le site de phpcompta
</p>
</sect>
</sect>
<sect> Comment appliquer un patch ?
<p>
<sect1>Quel patch utiliser ?
<p>
Dans certains cas, le dernier patch ne reprend PAS les autres,
il faudra lire la release note du patch
pour savoir ce qu'il faut appliquer avant. En règle générale, il
faut appliquer les patch dans l'ordre : le premier, puis le second...
Sinon, les patchs sont toujours nommés ainsi
<bf>path-(numéro_version)-(numéro_de_path).tgz</bf>
exemple
path-r092-1.tgz, est le premier patch pour la release 0.9.2
</p>
</sect1>
<sect1> Comment appliquer le patch
<p>
Après l'avoir téléchargé, allez dans le répertoire de PhpCompta, c'est-à-dire celui qui contient les sources
<enum>
<item>Décompresser le patch (gzunip patch-...)
<item>puis appliquez le patch -p0 &lt; patch...
</enum>
</p>
</sect1>
</sect>
<sect>Les entêtes de facture
<p> Pourquoi les coordonnées de la société faisant la facture n'apparraissent-ils pas ?
Parce que vous n'avez pas rempli les coordonnées de votre société dans les paramètres ou
parce que votre modèle n'en contenait pas.
</sect>
<sect> Problèmes fréquents
<sect1> Impossible de se logguer
<p> Il faut contrôler le fichier log d'Apache
</sect1>
<sect1> J'ai le message d'erreur 'cannot find file ....'
<p> Dans votre php.ini, n'oubliez pas de mettre correctement le include_patch voir php-setting
<ref id="php-setting" name="Php">
</sect1>
</sect>
<sect> Je reçois une erreur postgresql à propos d'une table log qui n'existe pas
<p>
C'est normal, les sortie de déboggage sont envoyées dans une base de données, ce
qui facilite la recherche, le tri,...
<p> Vous avez deux possibilités,
<itemize>
<item>soit vous changez dans le fichier include/constant.php, define ("DEBUG","true"); par
define ("DEBUG","false");
<item> Se connecter en tant que postgres et taper les commandes
<verb>
createdb -h localhost -O phpcompta log
psql -h localhost -U phpcompta -f sql/log/log.sql log
</verb>
</itemize>
</p>
</sect>
<sect>Après avoir installé la version 1.1.0, les périodes centralisées ne le sont plus
<p> Oui, c'est tout-à-fait normal, la période 1.1.0 introduit plusieurs changements dont par exemple,
les numéros d'opérations et de pièces justificatives.
<p>C'est à cause de cela, qu'il faut re-centraliser.
</sect>
<sect>J'ai toujours des timeouts
<p>Soit vous augmentez le timeout de votre server http soit vous mettez l'option fsync=N dans
le fichier de configuration de PostgreSql ou encore changer dans votre php.ini le paramètre
max_execution_time soit dans le fichier .htaccess, soit dans le fichier php.ini soit dans la
définition de votre virtual host dans la configuration d'apache.
</sect>
<sect>Mais où sont les rapports prédéfini
<p>Parce que les rapports peuvent toujours être facilement adaptés,
ils sont inclus dans le produit mais pas installé. Pour les trouver,
allez simplement dans le répertoire contrib/rapport et exécutez les
scripts sql soit grâce à pgAdmin soit en ligne de commande ou soit avec
l'outil PhpPgAdmin.
</sect>
<sect>Developpeur
<p> Les développeurs trouveront toutes la documentation dans doc/developper.
Pour la base de données, j'utilise postgresql_autodoc et pour php, doxygen.
</sect>
</article>

View file

@ -1,316 +0,0 @@
PhpCompta FAQ
originally written by Dany De Bontridder
$Revision$
Ce document contient les réponses aux questions les plus fréquemment
posées sur PhpCompta PhpCompta <http://www.alchimerys.be/FR/phpcompta>
site savannah PhpCompta Savannah <http://savan-
nah.nongnu.org/projects/phpcompta/>
______________________________________________________________________
Table of Contents
1. Qu'est-ce que PhpCompta ?
2. Quel le nom du soft ??
3. Par où commence t'on et comment ?
4. Ou trouvez les patches
5. Comment adapter le fichier php.ini
6. Quand réinitialise t-on le mot de passe, que vaut-il ?
7. Quel est l'utilisateur et le mot de passe par défaut?
8. J'ai trouvé un tit bug, comment faire un patchs ??
9. Comment faire de la doc
10. Comment contribuer ?
11. Comment appliquer un patch ?
11.1 Quel patch utiliser ?
11.2 Comment appliquer le patch
12. Les entêtes de facture
13. Problèmes fréquents
13.1 Impossible de se logguer
13.2 J'ai le message d'erreur 'cannot find file ....'
14. Je reçois une erreur postgresql à propos d'une table log qui n'existe pas
15. Après avoir installé la version 1.1.0, les périodes centralisées ne le sont plus
16. J'ai toujours des timeouts
17. Mais où sont les rapports prédéfini
18. Developpeur
______________________________________________________________________
1. Qu'est-ce que PhpCompta ?
PhpCompta est un logiciel GPL <http://www.gnu.org/licenses/gpl.html>
adapté à la législation belge en matière de comptabilité, il vous
permet de tenir votre comptabilité de manière centralisée.Il a été
crée pour supporter diverses comptabilités d'autres pays mais par
manque de documentation, celle-ci ne sont pas encore implémentées,
idem pour les traductions.
Si vous voulez contribuez n'hésitez pas : Mailing List Contribution
<http://mail.nongnu.org/mailman/listinfo/phpcompta-contrib>
Si vous avez besoin d'aide Mailing List support
<http://mail.nongnu.org/mailman/listinfo/phpcompta-support>.
2. Quel le nom du soft ??
- phpcompta,
- wcompta,
- webcompta
En fait c'est phpcompta, bien qu'au départ c'était wcompta,
contraction de WebCompta mais malheureusement, c'est le nom d'un soft
qui existait déjà, j'ai été obligé de changer vers phpcompta.
Cependant PhpCompta est un nom temporaire, il sera changé le jour où
quelqu'un proposera mieux. Si ce nom doit être changé, c'est par
respect envers l'équipe de Php qui ne souhaite pas que le mot Php soit
réutilisé dans d'autres applications.
3. Par où commence t'on et comment ?
Étape 1, créer un dossier, qui contiendra la comptabilité d'une
entreprise (sur 1 an ou plus).
· Menu Administration -> Dossier, choisir un nom pour le dossier,
create folder
· Étape 2, on peut créer des utilisateurs mais ce n'est pas
obligatoire.
· Étape 3, on revient à l'accueil :)
Si vous avez pris Comptabilité basique, vous devrez créer les
journaux, les fiches, mettre à jour votre plan comptable... Allez voir
dans le répertoire doc du tarball
4. Ou trouvez les patches
Sur Site phpcompta <http://www.phpcompta.org/> la page d'origine,
malheureusement, il n'est pas encore possible de télécharger des
fichiers sur Savannah
5. Comment adapter le fichier php.ini
Avec PHP 4.3.1 : Les variables sont passés de page en page
dans un tableau _POST[nom_var] alors qu'avec les versions
précédentes, on y accédait directement avec $nom_var voir la
variable register_globale = off dans le php.ini
php.ini doit contenir pour phpcompta, cependant il n'est pas certain
qu'il faille changer ces paramètres, vous devez aller sur
admin/setup.php pour voir ce qui doit être fait
[PHP]
include_path=".:../include:../../include:addon"
[Session]
session.name = PHPSESSID
; name of the session
; is used as cookie name
session.auto_start = 1 ; initialize session on request startup
session.cookie_lifetime = 0 ; lifetime in seconds of cookie
; or if 0, until browser is restarted
session.cookie_path = /tmp ; the path the cookie is valid for
lors de l'installation (admin/setup.php), on vérifie que toutes les
paramètres d'initialisation sont corrects.
6. Quand réinitialise t-on le mot de passe, que vaut-il ?
phpcompta
7. Quel est l'utilisateur et le mot de passe par défaut?
l'utilisateur et le mot de passe par défaut sont phpcompta/phpcompta,
l'utilisateur demo a aussi phpcompta comme mot de passe.
8. J'ai trouvé un tit bug, comment faire un patchs ??
Le plus simplement du monde : d'abord récupérez le projet , corrigez
le problème que vous avez détecté, placez-vous à la racine du projet
et vous tapez :
cvs diff -rrelease -u > patch-date-email
Pensez à d'abord effacer les fichiers inutiles, les , les core-
files... Vous pouvez envoyer le fichier résultat. Pensez à me dire si
c'est un patch relatif aux cvs ou non. Mais testez-le avant. rem-
placer release par la release (allez sur savannah, browse CVS pour
connaitre le nom du tag que vous voulez)
Pour tester les patch,
Pour le tester, faites un cvs co dans un autre répertoire que celui où
vous avez développé votre patch, puis essayer votre patch
patch -p0 < patch-(numéro de version)-votre-email
répertoire au-dessus de celui de phpcompta
patch -p1 < patch-(numéro de version)-votre-email
répertoire courant de phpcompta
Si cela ne marche pas ce n'est pas bon
9. Comment faire de la doc
Sous Mandriva (anciennement mandrake), ajouter les linuxdocs-tools
avec la commande urpmi linuxdoc-tools, pour Ubuntu apt-get install
linuxdoc-tools, tetex, tetex-extra les autres, je ne sais pas :(
Une fois, les linuxdoc tools installés il peut être nécessaire
d'installer d'autres outils comme jade, sgml,... Il faudra en tout
cas ajouter les tetex-dvips, textex-xdvi, latex2html
De toute façon, vous pouvez imprimer le guide, pour le trouver faites
:
en mode commande : rpm -qil linuxdoc-tools|grep guide
Jetez aussi un oeil sur les exemples, vous verrez c'est assez simple
en mode commande: rpm -qil linuxdoc-tools|grep example
Ensuite, editez le fichier sgml, et surtout pensez à utilisez aspell
-H --lang=fr_FR check FA-fr.sgml pour véifier l'orthographe. Pour le
visionner, faites linuxdoc -B html FAQ.sgml soit linuxdoc -B rtf pour
avoir un fichier rtf... Puis faites un patch :-) ``Comment faire un
patch''
10. Comment contribuer ?
Sur le site de Savannah, j'ai décidé d'utilisé le Task Manager, chacun
s'organise comme il veut, soit il m'envoie son travail par email soit
il se joint au projet. Je préfère que l'on travaille par email au
début.
L'intérêt de ce système est de pouvoir voir le suivi mais aussi
d'ajouter des commentaires sur un sujet PhpCompta Task Manager
<http://savannah.nongnu.org/task/?group=phpcompta>.
Cela m'évite de devoir chaque fois changer sur le site de phpcompta
11. Comment appliquer un patch ?
11.1. Quel patch utiliser ?
Dans certains cas, le dernier patch ne reprend PAS les autres, il
faudra lire la release note du patch pour savoir ce qu'il faut
appliquer avant. En règle générale, il faut appliquer les patch dans
l'ordre : le premier, puis le second...
Sinon, les patchs sont toujours nommés ainsi
path-(numéro_version)-(numéro_de_path).tgz
exemple path-r092-1.tgz, est le premier patch pour la release 0.9.2
11.2. Comment appliquer le patch
Après l'avoir téléchargé, allez dans le répertoire de PhpCompta,
c'est-à-dire celui qui contient les sources
1. Décompresser le patch (gzunip patch-...)
2. puis appliquez le patch -p0 < patch...
12. Les entêtes de facture
Pourquoi les coordonnées de la société faisant la facture
n'apparraissent-ils pas ?
Parce que vous n'avez pas rempli les coordonnées de votre société dans
les paramètres ou parce que votre modèle n'en contenait pas.
13. Problèmes fréquents
13.1. Impossible de se logguer
Il faut contrôler le fichier log d'Apache
13.2. J'ai le message d'erreur 'cannot find file ....'
Dans votre php.ini, n'oubliez pas de mettre correctement le
include_patch voir php-setting ``Php''
14. Je reçois une erreur postgresql à propos d'une table log qui
n'existe pas
C'est normal, les sortie de déboggage sont envoyées dans une base de
données, ce qui facilite la recherche, le tri,...
Vous avez deux possibilités,
· soit vous changez dans le fichier include/constant.php, define
("DEBUG","true"); par define ("DEBUG","false");
· Se connecter en tant que postgres et taper les commandes
createdb -h localhost -O phpcompta log
psql -h localhost -U phpcompta -f sql/log/log.sql log
15. Après avoir installé la version 1.1.0, les périodes centralisées
ne le sont plus
Oui, c'est tout-à-fait normal, la période 1.1.0 introduit plusieurs
changements dont par exemple, les numéros d'opérations et de pièces
justificatives.
C'est à cause de cela, qu'il faut re-centraliser.
16. J'ai toujours des timeouts
Soit vous augmentez le timeout de votre server http soit vous mettez
l'option fsync=N dans le fichier de configuration de PostgreSql ou
encore changer dans votre php.ini le paramètre max_execution_time soit
dans le fichier .htaccess, soit dans le fichier php.ini soit dans la
définition de votre virtual host dans la configuration d'apache.
17. Mais où sont les rapports prédéfini
Parce que les rapports peuvent toujours être facilement adaptés, ils
sont inclus dans le produit mais pas installé. Pour les trouver, allez
simplement dans le répertoire contrib/rapport et exécutez les scripts
sql soit grâce à pgAdmin soit en ligne de commande ou soit avec
l'outil PhpPgAdmin.
18. Developpeur
Les développeurs trouveront toutes la documentation dans
doc/developper. Pour la base de données, j'utilise postgresql_autodoc
et pour php, doxygen.