COBAYE.TXT, fichier utilise pour les tests de mise en forme txt2html ;-) Avant-propos Le fichier (file: cobaye.txt) sert de test pour les convertisseur '.txt' --> '.html'. Son contenu est particulierement stupide, mais il contient des "pieges" pour tester les limites des scipts Perl : 1- (file:pass1.pl) recherche la syntaxe (titres, listes, etc...), 2- (file:pass2.pl) se charge d'isoler les paragraphes, et code la presentation 'gras' ou "italique", 3- (file:pass3.pl) remplace toutes les directives de renvois a d'autres documents par des liens hypertextes Cet avant propos est separe du chapitre 1 par une ligne de '-', que 'txt2html' considere comme une '
' (horizontal rule. Pour info, ca marche aussi avec les lignes de '_', de '=' ou de '#'. ------------------------------------------------------------------ 1) chapitre 1 texte chap 1. -> ligne avec un ampersand (&), un LessThan (<), un GreaterThan (>), et une quote ("), commencant par un tiret simple, qui ne DOIT pas etre 'listee', mais incorporee au paragraphe... Et ce magnifique exemple comprenant des TABs, reproduit tel-quel : <<<$ ls ./ ../ C/ fonts/ XKeysymdb 1.2) ce n'est pas un titre ! il y a 5 caracteres depuis le debut de la ligne il y a 15 caracteres depuis le debut de la ligne verifier texte de cette zone ou en "italique". on peut que le libre peut etre en 'gras' --> mais le rendu 'gras' et "ilalique" des zones "
" est 
                                                 different
                                             selon le navigateur !
>>>

Fin du chapitre 1.



Il y a volontairement QUATRE carateres RETURN entre cette ligne et la ligne precedente, afin de provoquer l'insersion d'un tag '
' pour forcer une separation "plus accentuee". La loi est 'nb_BR = (nb_RETURN - 2 ) / 2' :  six RETURN  -> 3 BR,  etc... Note a l'intention des coupeurs de cheveux en quatre : CINQ caracteres RETURN n'inserent pas un '
' et demi...

Il y a SIX caracteres RETURN entre cette ligne et la ligne du chapitre 2.





2) Chapitre 2
Ceci 2.1) est un sous titre 2.1 

Ceci (2.1) n'est pas un sous titre...

Cette ligne contient une (parenthese ouvrante, puis un RETURN
...et la parenthese est fermee) a la ligne suivante sans generer de titre.

tests de liens :
- 'inexistant' : un lien qui n'existe pas, ce qui doit provoquer un 'mailto' ou un petit message d'avertissement en fin de doc selon la configuration '$error_method' de '(file:pass3.pl)' : (cf : inexistant)
- 'install_clarisdraw' : un seul choix possible, quelquepart dans l'arborescence (URL type HTTP) -> (cf: install_clarisdraw).
- 'lien surcharge' : (cf:install_clarisdraw,ce lien pointe sur le fichier 'install_clarisdraw.html'),
- 'bidon' : plusieurs choix en dessous du repertoire courant (URL type RELATIF sur le plus proche) -> (cf : bidon).
- 'files/test/bidon' : forcer un choix en dessous du repertoire courant, pour passer le choix du "plus proche" (URL type RELATIF) -> (cf : files/test/bidon).
- 'plusieurs liens dans la meme phrase' : c'est juste pour verifier que Perl ne se trompe pas de parenthese... (cf:bidon) et (cf:files/test/bidon).
- '#jargon' : faire un lien sur un "point d'ancrage" ('html anchor') qui se trouve dans ce document (cet ancrage est declare avec une paire de '[]') : (cf: #jargon).
- 'cf: README#3' : faire un lien sur le chapitre 3 du fichier 'README.html' (tout chapitre identifie par le convertisseur genere "implicitement" un ancrage) : (cf : README#3).



- cette ligne volontairement separee de quatre RETURN dans le '.txt', pour verifier qu'elle est quand meme prise dans la liste, mais qu'un tag '
' a ete insere

2.2) sous titre 2.2
Liste "non ordonnee", avec 2 elements qui commencent par '-' :
     - bof !
 - re-bof !

Liste "ordonnee", le premier element commence par ' 1 -' :
 1    - item 1
2 - item 2
- cette ligne commence par '-', mais elle est acceptee dans la liste


2.2.a) petit sous titre, avec du 'gras' et de "l'italique"
avec du texte
liste avec un element :
  - item 1, avec un 'gras' et un "italiques"..., suivi par beaucoup de NEWLINEs, qui doivent etre filtres (c'est une liste)


3) chapitre 3, avec du 'gras' et de "l'italique"
Ce terme informatique doit etre mis 'en valeur'.

Un terme informatique a 'mettre en
 valeur', avec un NEWLINE entre les deux quotes...

exemple de [jargon] "en francais dans le texte"... et 'l'exemple de chaine', avec "quote simple (')" dans "cet" exemple "assez" tordu "et" tres "particulier", avec plusieurs ("), qui demande un peu de finesse. Tout comme ces 'deux' petits 'gras' "voisins de palier".
La version '.txt' de ce paragraphe contient un NEWLINE (pas deux), il doit donc etre fusionne avec la ligne precedente pour faire un seul paragraphe...

un exemple a mettre tel quel :
<<<
exemple, qui ne doit pas etre pris comme une liste :
	- df
	- dfdf dfdfdf
	- sdfedf
>>>

4) les images...

L'image ci-dessous est "forcee a gauche", ce qui veut dire que le reste du document la contourne par la droite, y compris les titres (a employer avec precaution).
(inc : flowers, left)

4.1) Une image sans position
(inc : tintin_detail1) ...qui se glisse dans une phrase

4.2) Une image sans position
...qui se (inc : tintin_detail1) glisse dans une phrase

L'image ci-dessous est "forcee a droite", ce qui veut dire que le reste du document la contourne par la gauche, y compris les titres (a employer avec precaution).
(inc : flowers, right)

4.3) Une image sans position
...qui se glisse dans (inc : tintin_detail1) une phrase. Ce paragraphe est suivi par HUIT carateres RETURN dans le '.txt' afin de forcer TROIS tags '
'. Ce qui permet de reprendre la suite du texte apres la grosse image de droite...







4.4) Une image sans position
...qui se glisse dans une phrase (inc : tintin_detail1)


4.5) Une image forcee au milieu, qui coupe les paragraphes
L'inclusion d'image est demandee apres le ":" : (inc : tintin_detail1, center)


Ce paragraphe de texte est separe de l'inclusion d'image.

(inc : tintin_detail1, center)


5) le bas de page automatique
la directive 'footer' provoque l'insertion du pied de page 'footer.html.template': (file: footer.html.template)

Le pied de page est insere apres "ce" point.(footer)