##############################################################################
# WWWBoard                      Version 2.0 ALPHA 2                          #
# Copyright 1996 Matt Wright    mattw@worldwidemart.com                      #
# Created 10/21/95              Last Modified 11/25/95                       #
# Scripts Archive at:           http://www.worldwidemart.com/scripts/        #
##############################################################################
#                                                                            #
#   VERSION FRANCAISE : Sébastien Joncheray, http://www.perl-gratuit.com     #
#                                                                            #
##############################################################################
# If you run into any problems while trying to configure this scripts, help  #
# is available.  The steps you should take to get the fastest results, are:  #
#       1) Read this file thoroughly					     #
#       2) Consult the Matt's Script Archive Frequently Asked Questions:     #
#               http://www.worldwidemart.com/scripts/faq/	             #
#       3) If you are still having difficulty installing this script, send   #
#          e-mail to: scripts-help@tahoenet.com				     #
#          Include any error messages you are receiving and as much detail   #
#          as you can so we can spot your problem.  Also include the variable#
#          configuration block that is located at the top of the script.     #
#									     #
# Hopefully we will be able to help you solve your problems.  Thank you.     #
##############################################################################
# COPYRIGHT NOTICE                                                           #
# Copyright 1996 Matthew M. Wright  All Rights Reserved.                     #
#                                                                            #
# WWWBoard may be used and modified free of charge by anyone so long as      #
# this copyright notice and the comments above remain intact.  By using this #
# code you agree to indemnify Matthew M. Wright from any liability that      #  
# might arise from it's use.                                                 #  
#                                                                            #
# Selling the code for this program without prior written consent is         #
# expressly forbidden.  In other words, please ask first before you try and  #
# make money off of my program.                                              #
#                                                                            #
# Obtain permission before redistributing this software over the Internet or #
# in any other medium.  In all cases copyright and header must remain intact.#
##############################################################################
Vous devez avoir les fichiers suivants de WWWBoard-vf Version 2.0 ALPHA 2:
        a.  ALPHA-2       	- A LIRE (anglais).
	1.  lisezmoi.txt  	- Les instructions d'installation.  Ce fichier.
	2.  wwwboard-vf.pl	- Le script CGI Perl qui fait tout.
	3.  wwwboard-vf.html 	- Le fichier HTML de WWWBoard-vf que le visiteur voit.
	4.  faq.html	  	- Une Foire Aux Questions pour les utilisateurs de wwwboard-vf.
	5.  data.txt		- Où le numéro d'article courant est stocké.
	6.  messages/		- Où les messages sont créés et stockés.
	7.  wwwadmin-vf.pl	- Un Outil d'administration pour supprimer des messages.
	8.  passwd.txt  	- Le nom utilisateur et mot de passe crypté pour WWWAdmin-vf
        9.  ADMIN_lisezmoi	- fichier à lire éventuellement pour WWWAdmin-vf.
Vous aurez besoin d'éditer à la main les fichiers .pl de cette distribution.
Voici une description des modifications nécessaires à apporter aux fichiers:
___________________________________________________________________________
				WWWBOARD-VF.PL
				===========
Ce fichier doit être placé dans le cgi-bin de votre serveur, ou s'il permet
les extensions .cgi comme scripts Perl, vous pouvez simplement renommer ces
fichiers en wwwboard.cgi, et changer la variable $cgi_url variable.  Ce fichier
doit également être mis avec chmod 755. Demandez à votre administrateur système
concernant le cgi-bin et la commande chmod sur unix.
C'est le fichier le moins simple à modifier.  Il y a pas mal de variables et de
nombreuses options.  Voici ci-dessous un résumé pour savoir comment configurer tout cela 
et utiliser les options:
###########################################################################
# Define Variables
$basedir = "/path/to/wwwboard-vf";
	Cette variable doit contenir le chemin absolue au répertoire 	
        wwwboard-vf.  Donc, si vous avez toutes vos pages HTML dans 	
        /home/yourname/public_html et que vous faites un répertoire en dessous nommé
        'wwwboard-vf', alors $basedir doit être: 
        /home/yourname/public_html/wwwboard-vf
$baseurl = "http://your.host.xxx/wwwboard-vf";
        Ceci est l'URL de base du répertoire où wwwboard-vf est mis.  Donc,
        en gardant l'exemple ci-dessus, si l'URL de votre site est:
 	http://your.host.xxx/~yourname/,  $baseurl doit être: 
        http://your.host.xxx/~yourname/wwwboard-vf/.
$cgi_url = "http://your.host.xxx/cgi-bin/wwwboard-vf.pl";
	C'est l'URL de wwwboard-vf.pl.  Cela sera utilisé dans les formulaires 
        pour répondre à un article, ce doit donc être correct.
$mesgdir = "messages";
	C'est le nom du répertoire (ajouté à $basedir) dans lequel
        seront enregistrés les articles.
        Il doit être créé par vos soins sous $basedir, et chmod 777.
$datafile = "data.txt";
	C'est le nom du fichier (ajouté à $basedir) qui contient le  
        numéro d'article courant.
        Il doit être chmod 777.
$mesgfile = "wwwboard-vf.html";
	C'est le nom du fichier HTML du Forum (ajouté à $basedir et à $baseurl),
        que vous pourriez avoir envie de renommer index.html pour avoir un URL 
        d'accès plus court.
$faqfile = "faq.html";
	Nom du fichier FAQ faq.html (ajouté à $baseurl) sur WWWBoard-vf.
$ext = "html";
	Ceci est l'extension à mettre pour les fichiers qui seront créés (un
        par article).  La plupart du temps, ce doit être laissé à "html", mais à l'occasion 
	vous pourriez avoir envie de le mettre à "htm" (plateforme DOS).
$date_command = "/bin/date";
        INUTILE DANS CETTE VERSION !
	This needs to be the path to your 'date' command.  This script uses
 	the date command to time stamp the messages individually with along
 	date and to place a short 'added' date on the wwwboard.html page.
$title = "Forum WWWBoard-vf";
	C'est le titre de votre forum, qui apparait un peu partout.
AJOUT POUR LA VERSION FRANCAISE :
$body_opt='';
	Vous pouvez préciser ici des paramètres de couleurs pour les pages HTML.
	ceci sera ajouté dans le tag <BODY> des fichiers HTML créés et/ou affichés.
	Vous pouvez ainsi préciser :
	 - une couleur de fond en mettant par exemple:
           $body_opt='BGCOLOR="#C0C0C0"';
	 - une image de fond en mettant par exemple:
           $body_opt='BACKGROUND="http://www.votresite.com/votre/image/de/fond.gif"';
	 - une couleur de texte en mettant par exemple:
           $body_opt='text="#000080"';
	 - une couleur de lien en mettant par exemple:
           $body_opt='link="#008000"';
	 - une couleur de lien visité en mettant par exemple:
           $body_opt='vlink="#FF0000"';
	Mettez les valeurs de votre choix, vous pouvez combiner tout cela, en séparant
	les éléments par un espace, exemple :
	$body_opt='bgcolor="#C0C0C0" text="#000080" link="#008000" vlink="#FF0000" alink="#FF0000"';

# Terminé
###########################################################################
Il y a également des options à configurer:
###########################################################################
# Configure Options
$show_faq = 1;          # 1 - OUI (par défaut); 0 = NON
	Cette option vous permet de choisir si vous voulez ou non qu'un lien
 	vers la FAQ apparaisse sur chaque page.
$allow_html = 1;        # 1 = OUI; 0 = NON (recommandé)
	Cette option vous permet de choisir si vous autorisez les TAGS HTML 
	dans les articles ou non.  Si vous ne les autorisez pas, tout texte  
 	envoyé entre des <> autour est supprimé du message. 
	Mettre cette option à 1 autorise les tags html dans les messages, 
	et vous pouvez interdire cela en mettant '0'.
$quote_text = 1;        # 1 = OUI; 0 = NON
	En laissant cette option à 1, lors d'une réponse, le message précédent 
	sera mis et indenté avec ':' devant chaque ligne, dans la case de réponse, afin de  
	distinguer la réponse elle-même de ce qui a été dit auparavant. 
	Mettre cette option à '0' pour ne pas avoir le message précédent dans la case 
	pour écrire le texte de réponse.
$subject_line = 0;      # 0 = Objet modifiable, avec 'Re:'; 1 = Objet avec 'Re:'
                        #   non modifiable; 2 = Objet vide, à remplir.
	Il y a trois options dans la façon d'afficher le titre de l'article précédent 
	lors de l'écriture d'une réponse.  Laisser cette option à 
	'0' (par défaut), permet à l'utilisateur de modifier le titre 
	dans le formulaire de réponse. 
	Mettre cette option à '1', indentera l'objet de l'article (Re:) 
	mais n'autorisera pas l'utilisateur à le modifier. 
	La troisième et dernière possibilité est de mettre ceci à '2'.  Dans ce 
	cas, l'Objet est vide et l'utilisateur doit le saisir dans le formulaire de réponse. 
$use_time = 1;		# 1 = OUI; 0 = NON
	Cette option vous permet de choisir si vous souhaitez utilisez 
 	l' heure:minute:seconde en plus de la date jour/mois/année sur la page principale. 
	Jour/mois/année sera automatiquement placé sur la page principale 
	wwwboard-vf.html quand un article est ajouté, mais si vous laissez cette  
	variable à '1' l' heure:minute:seconde sera également affichée à côté. 
	Ceci est très utile pour les forums recevant beaucoup d'articles, 
	mais si vous voulez gagner de la place sur la page principale, vous pouvez 
	mettre cela à '0' pour que heure:minute:seconde n'y soit pas.
# Terminé
###########################################################################
WOW!  Vous avez tout bien fait.  C'était le fichier le plus délicat à configurer.
___________________________________________________________________________
			   WWWBOARD-VF.HTML
			   =============
wwwboard-vf.html doit être placé dans le répertoire que vous avez défini dans 
$basedir du fichier wwwboard-vf.pl.  Il doit être chmod 777 afin que votre uid
sur le serveur (User ID) ait la permission de le modifier.
Ce fichier nécessite nettement moins de modifications que wwwboard-vf.pl.  Il y a 
trois choses que vous voudrez changer dans ce fichier.  Les deux premières sont 
tout simplement le titre du Forum WWWBoard-vf.  A l'origine ces 2 lignes ressemblent à:
<title>Forum WWWBoard-vf</title> et <h1>Forum WWWBoard-vf</h1>
Modifier ce titre et en-tête en ce que vous voulez.  Cela sera probablement 
la même chose que la variable $title que vous avez définie dans wwwboard-vf.pl.
La troisième chose à changer est cette ligne:
<form method=POST action="http://your.host.xxx/cgi-bin/wwwboard-vf.pl">
Vous devez changer l'URL d'action du formulaire dans action="" et la remplacer par 
ce que vous avez défini dans wwwboard-vf.pl comme $cgi_url.
___________________________________________________________________________
			 	FAQ.HTML
			 	========
Ce fichier n'a pas besoin d'être modifié, à moins que vous ne vouliez en changer 
l'en-tête, ou le titre, ou que vous souhaitiez ajouter un lien de retour au Forum.
Ce fichier doit être placé dans le répertoire $basedir avec le nom défini dans 
$faq_file dans le fichier wwwboard-vf.pl
Il ne devrait pas être nécessaire de changer son chmod (744, lisible par tous).
___________________________________________________________________________
			       MESSAGES/
			       =========
C'est un réperoire qui doit être créé dans $basedir comme défini dans
wwwboard-vf.pl.  Il doit être chmod 777 afin que les articles puissent y être 
écrits avec votre UID.
___________________________________________________________________________
				DATA.TXT
				========
Mettez simplement ce fichier dans $basedir comme défini dans wwwboard-vf.pl avec 
chmod 777 afin que le script puisse le modifier et incrémenter le nombre (d'articles).  
C'est ici que le nombre d'articles est stocké.
___________________________________________________________________________
				 LISEZMOI.TXT
				 ============
		    C'est le plus simple.  Lisz-le, c'est tout!
FIN DE LA TRADUCTION. Le reste ne vous sera probablement pas utile.
__________________________________________________________________________
Version 2.0 Improvements Over 1.0:
* HTML does not mess up postings like the last version did.
* There are many more options to allow flexibility in design.
* One CGI program instead of three.  Makes everything smoother and
  more efficient.
* File names are derived from an incremented number up to 99999 so that
  messages won't overlap, like they could have with the old pid numbers that
  were used.
* Many more things I can't even begin to list.
___________________________________________________________________________
Version History:
Version 2.0:		Complete Re-Write of Version 1.0
	11/4 	-	ALPHA 1 Version Released because many people were 
			writing asking if they could get a copy of it.
___________________________________________________________________________
As with all of my scripts which you can find at my scripts archive:
http://worldwidemart.com/scripts/
These are provided at no charge.  You can modify/edit/change/anything you 
want to these scripts.  There are only two things that I ask, neither of 
which will you be sued for if you don't follow.  :-)
1)  Please let me know where these are being used  I like to see my work in
    action.  you can let me know simply by filling out the on-line from
    located at:	   http://worldwidemart.com/scripts/implement.html
2)  Please keep my name somewhere in the script. It doesn't have to be
    noticeable to users, but I appreciate it being in the script somewhere 
    in case you ever pass it on or anything like that.
3)  Oh yah, there's a third one, but its the one I care least about.  I 
    know how many people like to keep everyone at their own site and  
    therefore do not link to the outside too often, but if at all possible, 
    I would appreciate a link to my scripts archive.  Once again, this 
    isn't necessary.
4)  Do the rules ever stop you say?  This last one is easy to follow:
  			***HAVE FUN!***
___________________________________________________________________________
Matt Wright * mattw@worldwidemart.com * http://worldwidemart.com/scripts/