John COLIBRI

u_c_pascal_to_html - John COLIBRI.

• mots clé: transformation - Pascal - Html Web - gestion de fichier ASCII - utilitaire
  
• logiciel utilisé: Windows 98, Delphi 5.0
  
• matériel utilisé: Pentium 500Mhz, 128 M de mémoire
  
• champ d'application: Delphi 1 à 6 sur Windows, Kylix
  
• niveau: moyen en Pascal et Delphi
  
• uses: u_c_text_file, u_loaded, u_types_constants, u_c_display, (u_c_basic_file, u_c_line, u_display_hex, u_c_file_name, u_c_log, u_c_basic_object, u_strings, u_dir)
  
• plan:
  
  • Introduction
    
  • Utilisation
    
  • Programmation
    
  • Améliorations
    
  • Télécharger
    

1 - Introduction

Pour Pascalissime, il y a longtemps que le brave ED avait réglé le problème:

• des balises 'début de programme' et 'fin de programme' marquaient le début et la fin des codes .PAS importés
  
• ED se chargeait alors de numéroter les lignes et de cracher le Postscript artistiquement décoré:
  
• mise en gras des mots clés
  
  • italique pour les identificateurs
    
  • correction de l'indentation. En effet, l'espace n'a pas la bonne valeur en point par rapport à la police en chasse variable pour les structures "en peigne":

    VAR total: Integer;
    montant: Double;
    

1.2 - L'objectif

• part d'un fichier ASCII classique (généré par NotePad ou par Delphi
  
• crée un fichier .HTML que vous pouvez visualiser avec un Browser quelconque en cliquant dessus
  

2 - Utilisation

• d'importer u_c_pascal_to_html
  
• de créer la classe c_pascal_to_html et d'appeler la méthode pascal_to_html:
  

2.2 - Répertoires et Directives de compilation

C:
  programs
    colibri_utilities
      web
        pascal_to_html

Vous pouvez naturellement changer cette organisation par Projet | Options | Directories

Les directives de compilation sont:

• R+ (vérification des intervalles)
  
• S+ (vérification de la pile)
  
• pas d'optimisation
  

3 - Programmation

Le texte est analysé lexicalement pour débiter le programme en symboles.

Le principe de cette analyse est toujours le même:

• une boucle pour sauter les caractères indésirables
  
• une boucle qui récupère dans une String les caractères utiles
  

• les chaînes littérales:
  
  • il faut sauter les guillemets dédoublés
    
  • les commentaires inclus dans les chaînes littérales ne doivent pas être pris en compte:

    Memo1.Lines.Add('ce n''est pas un (* commentaire');
    

• les commentaires de toute race doivent être ananlisés, sans empilement et en sautant les lignes au besoin

  { début
  (* emboîté non pris en compte *)
  'idem pour les chaînes, même non terminées
  } // c'est la fin
  

• .HTML gère les espaces et les retours chariots de façon très spéciale:
  
  • le texte est censé être découpé en paragraphes. Le début d'un paragraphe est censé être signalé par la balise <P> et est censé se terminer par un </P>.

    Je dis "censé", car ce <P> est ou non présent, et est très souvent implicite: après un trait horizontal (la balise <HR>), un paragraphe semble démarrer automatiquement. Quant au </P> c'est une bête très rare dans les pages Web de nos jours: lorsque un <P> est rencontré, un </P> est sous-entendu.

    Un peu comme si en Pascal cela vous fatiguait de mettre BEGIN et que le END vous ennuyait si profondément que vous laissiez au compilateur le soin d'en parsemer vos programmes ici ou là. Drole de mentalité...

  • les fins de lignes sont marquées par la balise <BR>. L'équivaleut en somme du retour chariot des traitements de texte. Fort bien.

  • les blancs de votre fichier ASCII (espace, tabulation je crois, Return et LineFeed (en gros 32, 9, 13 et 10) sont tous concaténés: plusieurs blancs consécutifs sont transformés en un seul blanc.

    Pour formater, plusieurs choix:

    • soit passer en text pré-formatté (la balise <PRE>), ce qui se traduit par une police à chasse fixe (type courrier) et conservation des espaces et des retours chariots de votre texte

    • soit placer dans le texte des espaces qui ne sont pas concaténés, en insérant les caractères:

       

      pour chaque espace à produire
      

• les caractères utilisés pour la grammaire HTML, tels que < et > doivent être transformés par un mécanisme d'échappement. Classique, certes, mais oh combien lourd dans le cas d'HTML. Ainsi

  < devient <
  espace devient  
  etc.
  

• les mots clés en capitales rouges et grasses
  
• les identificateurs en noir italique
  
• les chaînes littérales Pascal en bleu
  
• les commentaires Pascal de tout poil (soit // soit { soit (* ) en violet
  

4 - Améliorations

• d'incorporer ce programme dans l'utilitaire qui permet le changement de répertoires avec un tDirectoryListBox, et le balayage récursif en utilisant c_dirs
  
• de permettre l'inclusion de fichiers .PAS dans un fichier .TXT (par une notation similaire à $INCLUDE, par exemple), ce qui permet la transformation du .TXT en .HTML en une seule passe (c'est en vérité ce que fait le brave ED)
  

5 - Télécharger

• u_c_pascal_to_html.zip: l'unité seule (4 K)
  
• test_u_c_pascal_to_html.zip: (28 K) qui contient:
  
  • l'unité
    
  • toutes les unités qu'elle utilise
    
  • le projet de démonstration
    

• j'apprécie tous les commentaires, remarques ou critiques
  
• signalez-moi les bugs que vous trouverez.
  

L'auteur

John COLIBRI est surtout intéressé par la programmation en Pascal, Delphi et Kylix. Son site contient des articles, la descriptions de ses livres, le programme des stages de formation qu'il anime et son CV.