SELFHTML actuel Articles spécialisés CGI/Perl
Stefan Münz:
Comment représenter du code HTML en HTML?
Stefan Münz
Remarques sur le sujet
Exemple avec explications
Liens contextuels
| SELFHTML actuel Articles spécialisés CGI/Perl |
|
|
Stefan Münz: |
|
|
|
| |
|
| E-Mail: |  stefan.muenz@selfhtml.org |
| Homepage-URL: |  http://aktuell.de.selfhtml.org |
Il s'agit ici d'un article traduit de l'allemand par la rédaction de SELFHTML actuel. Veuillez poser vos questions relatives à cet article uniquement à son auteur, prenant compte que celui-ci ne maîtrise peut-être pas la langue française!
 |
HTML est fréquemment employé pour les documentations de langages - particulièrement en ce qui concerne les technologies Internet qui elles-même décrivent HTML ou des langages basés sur XML. C'est ici que se présente le problème de devoir représenter bien souvent en quantité du code HTML ou du code XML pour les exemples afférents. Il faut pour celà transcrire en HTML tous les signes propres à HTML en les remplaçant par les entités correspondantes:
le signe < par la suite de signes <,
le signe > par la suite de signes >,
le signe & par la suite de signes &,
le signe " par la suite de signes ".
C'est une quantité de travail de codage pour lequel de nombreux logiciels laisseront l' utilisateur se débrouiller.
Pour accélérer ces travaux de codage, un petit utilitaire qui décharge de ce travail peut se révéler bien utile. Le script Perl présenté ici travaille comme script CGI dans le navigateur. Si vous le désirez, vous pouvez vous servir de l'utilitaire en ligne ici sur le serveur. Vous pouvez également copier le code Perl du script pour l'installer localement. Un environnement HTTP local (voir SELFHTML: 
Installer un serveur WWW localement sur un ordinateur personnel) est la condition préalable à une utilisation sur votre ordinateur, ainsi qu'un interpréteur Perl installé ( Installer Perl localement sur un ordinateur personnel).
Si vous désirez utiliser l'utilitaire en ligne sur le serveur, employez le formulaire ci-après:
| |
Tout d'abord, le script Perl est présenté.
#! /usr/bin/perl
use strict;
use CGI;
my $cgi = new CGI;
my $code = $cgi->param('code');
$code =~ s/\&/&/g;
$code =~ s/</</g;
$code =~ s/>/>/g;
$code =~ s/\"/"/g;
print "Content-type: text/plain\n\n";
print $code;
|
Le script lit les données de formulaire au moyen du module « CGI » disponible dans Perl (use GGI;). C'est le contenu d'un champ de formulaire nommé code qui est attendu (voir ci-après). Quatre expressions régulières sont appliquées tour à tour au contenu du champ ainsi lu. Celles-ci assurent la conversion des signes propres à HTML en entités HTML. Il est important de traiter en premier lieu l'esperluette (&), étant donné que toutes les autres conversions utilisent le & comme premier signe des entités HTML. À la fin, le script retourne le contenu converti sous forme de texte pur au navigateur qui a envoyé la demande. Vous pouvez copier le texte représenté dans la fenêtre de votre navigateur dans le presse-papiers pour le coller ensuite dans votre éditeur HTML.
Et maintenant, voici un exemple montrant l'aspect que pourrait avoir le fichier HTML avec le formulaire qui appelle le script.
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html><head><title>représenter du code HTML en HTML </title> </head><body> <form action="/cgi-bin/htm-en-html.pl" method="post"> <p><b>Code:</b></p> <p><textarea cols="60" rows="20" name="code"></textarea></p> <p><input type="submit" value="Convertir"></p> </form> </body></html> |
L'élément textarea du formulaire sert à recevoir le code désiré qui doit être converti en code HTML. Lors de l'envoi du formulaire, le script présenté plus haut, qui doit opérer la conversion, est appelé et le résultat affiché dans le navigateur.
Si cous utilisez PHP, vous pouvez obtenir la fontionnalité du script Perl présenté avec la fonction htmlentities(). Pour Perl existe aussi un module CPAN qui remplit la fonctionnalité du script Perl ci-dessus avec un seul appel de fonction: le module HTML::Entities.
| |
Les adresses qui suivent sont recommandées pour mieux comprendre les exemples ci-dessus ou pour approfondir et apprendre d'autres possiblités.
SELFHTML: Le module CGI (Perl)
|
| SELFHTML actuel Articles spécialisés CGI/Perl |