Ce document est l� pour vous aider � concevoir vos fichiers au format .PRO en attendant les �diteurs graphiques (au passage: si �a int�resse quelqu'un, qu'il me fasse signe)
| >C'est quoi un fichier .PRO |
Un fichier .PRO est un format de fichier utilis� exclusivement dans PrograZine. Ce type de fichier permet de convertir tr�s facilement vos contributions en de l'HTML potable. En effet, devant la diversit� de formats textes, il a bien failli trancher. De plus, ce type de fichier, assez simple, permet une conversion quasi-automatique. Ainsi, �a fait beaucoup moins de boulot de notre c�t� (Je vous rappelle que le num�ro 3 avait autant de retard � cause du temps pass� � la conversion en HTML)
De plus, avec ce format, il est tr�s simple de modifier la mise en page actuelle des articles, puisqu'il n'y aura qu'un seul fichier � modifier et non tous !
| >Structure d'un fichier .PRO |
Un fichier .PRO se pr�sente sous la m�me forme qu'un fichier .HTML en TRES SIMPLIFIE !
Le principe est le m�me: on marche par tags (ou balises en fran�ais). Chaque partie du texte qui doit subir une modification ou qui doit �tre dans un cadre sp�cialn etc ... est entour� par des balises. Une ouverte du type
| >La balise principale |
LA balise principale et surtout OBLIGATOIRE est la balise #infPRO#sup, c'est par elle que doit commencer votre fichier .PRO et par laquelle il doit finir
| >Le plan du document |
Dans un grand nombre d'articles, les auteurs ont besoin de mettre en place un certain plan avec des titres, des sous-titres, etc ...
Il existe (pour l'instant) quatre niveaux de titres:
- #inftitre1#sup pour les grand titres
- #inftitre2#sup pour les titres
- #inftitre3#sup pour les sous-titres
- #inftitre4#sup pour les sous-sous-titres
| >Les paragraphes et leurs attributs |
| >Les paragraphes classiques |
Les paragraphes classiques sont entour�s par la balise #infP#sup
| >Les paragraphes d'annotation |
Il existe trois types de paragraphes d'annotation:
- les remarques
- les astuces
- les remarques importantes
Les remarques classiques sont entour�es par les balises #infremarque#sup et #inf/remarque#sup
Les remarques importantes sont entour�es par les balises #infattention#sup et #inf/attention#sup
Les astuces sont entour�es par les balises #infastuce#sup et #inf/astuce#sup
| >Les listes |
Il est possible de cr�er des listes avec la balise #infitem#sup.
Chaque branche d'une liste est entour�e par #infitem#sup et #inf/item#sup.
Il est bien entendu possible de cr�er des listes imbriqu�es
| >Les paragraphes non format�s |
 | l | Dans tous les paragraphes pr�c�dents, les espaces n'�taient pris en compte qu'une fois et les sauts � la ligne ne sont pas pris en compte. C'est � dire que s'il existe un saut � la ligne dans le fichier source, il n'existera pas forc�ment lors du formatage en HTML |
Les paragraphes non format�s permettent d'afficher du texte sans formatage. C'est � dire qu'ici chaque caract�re est recopi� tel quel � l'�cran. Il peut y avoir autant d'espaces que voulu. De plus, la police est � chasse fixe, c'est � dire que chaque caract�re a la m�me largeur. Cela permet de faire de petit sch�mas en mode texte par exemple ...
| >Les tableaux |
Il est aussi possible de cr�er des tableaux, l'utilisation n'est pas des plus simples...
Un tableau est entour� par les balises #inftableau#sup et #inf/tableau#sup
Entre ces deux balises, chaque ligne du fichier source repr�sente une ligne du tableau
Pour les colonnes, �a ce complique un petit peu ... Chaque colonne est s�par�e par le caract�re di�se (#)
Exemple:
#inftableau#sup nom#pr�nom gates#bill clinton#bill #inf/tableau#sup | l |
nom#pr�nom gates#bill clinton#bill
| >Les images et liens |
Une image peut �tre ins�r�e par la balise IMAGE
Le nom de l'image � ins�rer se trouve entre les deux balises #infimage#sup et #inf/image#sup.
Un lien hypertexte peut �tre ins�r� par la balise LIEN
Un texte "LIEN" est affich�, il pointe alors vers l'adresse comprise entre les deux balises #inflien#sup et #inflien#sup
| >Les attributs de caract�res |
Les attributs des carcat�res sont classiques: gras et italique
- gras: #infb#sup et #inf/b#sup
- italique: #infi#sup et #inf/i#sup
| >Les fichiers ext�rieurs |
Si vous avez bien suivi, vous remarquerez qu'il manque quelque chose d'important: le titre, l'auteur, etc ... de l'article
Ces informations sont pour l'instant stock�es dans un fichier ext�rieur dont je ne vous donne pas la syntaxe, car celle-ci est en plein changement.
Bient�t, ces informations seront r�unies dans le m�me fichier ...
| >Un exemple ... |
Pour illustrer mes propos, je vous propose d'aller voir les sources de cette page: LIEN
| l | Vous remarquerez que certaines lignes contiennent les mots "inf" et "sup" pr�c�d�s par une di�se ("#"). Ces signes sont la pour remplac� les signes "<" et ">", mais, � part dans le cas d'affiche des mot-cl�s des fichiers .PRO, il ne vous en ai d'aucun utilit�. |
Pour terminer, je rappelle que ce format de fichier a �t� cr�� pour faciliter la vie de tout le monde, alors s'il vous parait trop difficile, ne l'utilisez pas. S'il vous parait incomplet, d�tes-le moi !