README for fortunes-fr
----------------------

This package contains French Fortunes for GNU/Linux. They are all in French 
languages, so this package is interesting for people who know French language.

Therefore, any further information will be provided in French. However, please
note that an English version of the license is provided in the file COPYING. 
For installation instructions, please see the INSTALL file.

Pour l'installation de ces citations, merci de se reporter au fichier INSTALL.


------------------------------------------------------------------------------
 QU'EST CE QUE C'EST ?
------------------------------------------------------------------------------

Le programme fortune, disponible sous GNU/Linux mais qui provient  l'origine 
du monde BSD, permet d'afficher alatoirement des citations.

fortunes-fr est une base de donne pour le programme fortune, qui regroupe 
plus de 2100 citations en franais dans des domaines varis allant de la 
littrature au cinma, de l'humour  la politique... Un exemple ?

Ton bras est invaincu, mais non invincible.
	-+- Pierre Corneille, Le Cid -+-


Les citations sont rparties dans diffrents fichiers, qui correspondent
chacun  une catgorie. Il est donc possible d'afficher uniquement certaines 
catgories de citations, et ainsi de s'adapter aux gots de chacuns. Voici ces 
diffrentes catgories:

  * bd                    : Extraits de bande dessines
  * cinema                : Citations extraites du monde du cinma
  * droit                 : Extraits de textes de loi
  * fr.rec.photo          : Citations extraites du newsgroup fr.rec.photo
  * GDP                   : Guide du Debianiste Pervers : citations issues de
                            debian-french, debian-devel-french et 
                            debian-user-french
  * haiku                 : Hakus (forme potique japonaise)
  * humoristes            : Citations d'humoristes
  * humour                : Blagues, devinettes, jeux de mots, perles, etc.
  * informatique          : Citations en rapport avec l'informatique
  * litterature_etrangere : Extraits d'oeuvres littraires trangres
  * litterature_francaise : Extraits d'oeuvres littraires franaises
  * mysoginie             : Citations mysogines
  * personnalites         : Citation de personnes connues, principalement
                            du show business
  * philosophie           : Penses philosophiques ou citations de 
                            philosophes
  * politique             : Citations d'hommes politiques
  * proverbes             : Proverbes et dictons d'origine diverse
  * religion              : Extraits de livres religieux, ou citations se
                            rapportant  la religion
  * sciences              : Thormes, lois, citations de scientifiques

Ce recueil ne demande qu' tre agrandi, aussi si vous avez des citations que 
vous aimeriez voir figurer dans cette compilation, et si vous tes en accord 
avec la licence contenue dans le fichier COPYING, n'hsitez pas, envoyez moi 
un mail (aurelien@aurel32.net). De mme, si vous constatez des erreurs ou des 
imperfections, n'hsitez pas  me contacter.


------------------------------------------------------------------------------
 UTILISATION DE FORTUNES-FR
------------------------------------------------------------------------------

Avant d'utiliser fortunes-fr, il faut tout d'abord l'installer. Pour cel, se
reporter au fichier INSTALL.

Une fois l'installation effectue, il suffit d'executer le programme fortune 
pour voir apparatre une citation :

$ fortune
Les logiciels, c'est comme le sexe ; C'est meilleur quand c'est libre.
	 -+- Linus Torvalds -+- 


Cette citation provient du fichier informatique. Lorsque aucun fichier n'est 
spcifi, la citation est choisie au hasard parmi tous les fichiers (en tenant 
compte de leurs poids respectifs). Si au contraire on souhaite choisir une 
citation d'un fichier spcifique, il est possible de le spcifier :

$ fortune droit

Les hommes naissent et demeurent libres et gaux en droits.
Les distinctions sociales ne peuvent tre fondes que sur l'utilit
commune.
	 -+- Dclaration des droits de l'homme et du citoyen 
	     (26 aot 1789) - Article I -+- 


La liste de toutes les fichiers s'obtient avec l'option -f. Il est galement 
indiqu l'origine des fichiers et leur poids relatif de citations :

$ fortune -f
100,00% fr
    10,02% sciences
     3,89% religion
     1,97% proverbes
     2,11% politique
     6,98% philosophie
     1,69% personnalites
     1,03% mysoginie
    38,90% litterature_francaise
     4,96% litterature_etrangere
     1,08% informatique
     0,75% haiku
     1,17% GDP
     5,29% fr.rec.photo
     2,90% humour
     6,84% humoristes
     1,26% droit
     5,99% cinema
     3,18% bd

Pour ceux qui veulent aller plus loin, la page man fortune(1) est d'une grande
aide.

------------------------------------------------------------------------------
 RAJOUTER DES CITATIONS
------------------------------------------------------------------------------

Par dfaut, le programme fortune va chercher ses fichiers de citation  partir 
des rpertoires /usr/local/share/games/fortune ou /usr/share/games/fortunes. 
Chaque groupe de citations est compos de deux fichiers, le fichier source 
(qui contient les citations), et le fichier de donnes (qui contient la 
longueur et la position des citations), de mme nom que le fichier source avec
l'extension ".dat". Par exemple, si "litterature" est un fichier de citations, 
alors "litterature.dat" est le fichier de donnes qui le dcrit. La page de 
man strfile(8) vous un peu plus sur l'utilit de ces fichiers.

Le sparateur de citation doit tre le caractre %, prcd et suivi d'un 
retour  la ligne. Ne pas oublier de terminer la dernire citation par le mme 
caractre %, sinon celle-ci ne sera pas prise en compte.

Pour rajouter des citations, il faut donc diter le fichier source, puis 
mettre  jour le fichier de donnes  l'aide du programme strfile.


------------------------------------------------------------------------------
 FORMATAGE DES CITATIONS
------------------------------------------------------------------------------

Cette partie dcrit le format des citations dans la base de donnes, afin
de rendre plus facile sa maintenance, mais ce ne sont pas des rgles 
absolues :

 - Aucune citation ne doit dpasser 72 caractres par ligne, ceci afin que la 
   citation s'affiche toujours correctement, qu'elle soit utilise en 
   signature de mail, ou simplement affiche  l'cran. 

 - Dans la mesure du possible, le nom de l'auteur de la citation doit tre
   indiqu. Il doit tre plac juste aprs la citation, et doit tre plac
   entre deux squences "-+-", le tout prcd par une tabulation. 
   Par exemple :
   
	-+- Voltaire -+-

   Dans le cas o cette ligne dpasse 72 caractre, il faut aussi prceder la
   seconde ligne d'une tabulation, et aligner les permires lettres.
  
 - Si le nom de l'oeuvre est connu, il peut alors tre prcis aprs le nom
   de l'auteur, spar par une virgule. Par exemple :

	-+- Voltaire, Dictionnaire philosophique -+-

 
