slide.sh [Début] [Précédent] [Suivant]




Introduction


* Look de la présentation par défaut pompé sur slide.sh de Francois-Xavier Le Bail (fx.LeBail@free.fr).

* Idée de base : refaire un slide.sh plus simple pour l'écriture de fichier à parser.


Versions


Deux versions :

* slide-m4 : utilise m4 pour formatter le texte ;

* slide-sed : utilise sed pour formatter le texte.

La première version permet de voir comment utiliser m4 pour maintenir la cohérence d'un site web (inspiré de la doc de John Perr sur http://fr.linuxfocus.org/Francais/September1999/article111.html). La seconde est une version portable testée avec succès sous GNU/Linux et FreeBSD.


Format du fichier à parser


Le format du fichier à parser est simple :

* la balise <presentation> définit le début d'une présentation. Tous le texte avant cette balise sera ignoré ;

* TITRE(slide.sh - Un générateur de présentation en HTML) permet de définir le titre de cette présentation (qui sera affiché sur la première page). Attention : pas d'espace avant le '(' pour que m4 ne râle pas ;

* la balise <slide> définit le début d'un nouveau transparant ;

* TITRE(Introduction) permet de définir le titre de ce nouveau transparant (toujours pas d'espace avant le '(') ;

* une tabulation en début de fichier sera transformée en une puce dans la version HTML, deux tabulations en une autre puce décalée ;

* la balise </slide> clot le transparent courant ;

* la balise </presentation> clot la présentation. Tout le texte après cette balise sera ignoré.


Formattage du texte


* Le texte entre les balises <slide> et </slide> sera mis tel quel dans la présentation ; toutes les balises HTML sont donc acceptées

* En particulier pour formatter le texte il suffit de le faire comme dans un fichier HTML classique

* Pour les images, elles seront copiées dans le répertoire de destination. On peut donc mettre indifférement des liens relatifs ou absolus. Les liens du style http:// seront laissés tels quels


Fichiers de style


* Pour essayer d'être propre, le fond et la forme sont dissociés : tout ce qui concerne l'aspect de la page HTML se trouve dans des fichiers indépendants du script, donc totalement modifiables :

    - pour slide-m4, il s'agit des fichiers look.m4 et lang-fr.m4 pour la langue francaise (le fichier lang-en.m4 existe aussi mais le script ne gère pas encore le multi-langue, je le ferai un jour si j'en ai besoin) ;

    - pour slide-sed, les fichiers header (et header-tt-en-un pour la version tout-en-un), footer (et footer-tt-en-un pour la version tout-en-un), index et compte ;

    - pour les deux versions, une feuille de style est utilisée : look.css.

* Pour modifier le style de la présentation, il suffit d'éditer l'un de ces fichiers.


Options


* slide.sh [-d <rep_doc>] [-i <rep_images>] <fic>

* Option obligatoire :

    - nom du fichier à parser

* Options facultatives :

    - -d suivie du nom du répertoire où mettre les pages HTML

    - -i suivie du répertoire ou se trouveront les images (si c'est un chemin relatif, c'est par rapport au répertoire où seront les pages HTML)

* Exemple : slide-sed/slide.sh -d /public slide.sh.txt


That's all folks


* L'idéal pour remplacer slide.sh serait d'utiliser les feuilles de style XSLT, ces scripts pourraient donc bientôt devenir inutiles.

Enjoy,

Mathieu DECORE <mdecore@linux-france.org>


GNU/Linux Page maintenue par Mathieu DECORE
Dernière mise à jour : 08/02/02 - © mdecore@linux-france.org 2002