ADOBE Dreamweaver CS3 User Manual [fr]

ADOBE® DREAMWEAVER® CS

EXTENSION DE DREAMWEAVER

Adobe Extending Dreamweaver® pour Windows® et Macintosh

Si ce guide est fourni avec un logiciel qui inclut un contrat utilisateur final (CLUF), ces deux éléments font l'objet d'une licence et ne peuvent être utilisés ou copiés que conformément aux termes de cette licence. Sauf mention du contraire dans la licence, ce guide ne doit pas être reproduit en tout ou partie, stocké dans un système d'archivage ou transmis, sous quelque forme ou quelque moyen que ce soit, électronique, mécanique, enregistrement ou autre, sans le consentement écrit préalable d'Adobe Systems Incorporated. Le contenu de ce guide est protégé par les lois du copyright, même s'il n'est pas distribué avec des logiciels qui font l'objet d'un contrat de licence utilisateur final.

Le contenu de ce guide est fourni à titre d'information uniquement et est sujet à modification sans préavis. Il n'engage en rien la responsabilité d'Adobe Systems Incorporated. Adobe Systems Incorporated n'accepte aucune responsabilité en cas d'erreurs ou d'imprécisions qui risquent de figurer dans le contenu de ce guide.

Les illustrations ou les images que vous souhaitez inclure dans vos projets p euvent également faire l'objet d'un copywright. Toute utilisation non autorisée de ce type de document risque d'enfreindre des droits d'auteur. Vous devez obtenir les autorisations nécessaires à la publication de ce type de document.

Toute référence à des noms de société dans des modèles standard sont fournis à des fins de démonstration et ne font pas intentionnellement mention d'organisations existantes.

Adobe, le logo Adobe, ActionScript, ColdFusion, Dreamweaver, HomeSite, Fireworks et Flash sont des marques commerciales ou des marques déposées d'Adobe Systems Incorporated aux Etats-Unis et/ou dans d'autres pays.

Mac OS et Macintosh est une marque d’Apple Computer, Inc., déposée aux Etats-Unis et dans d’autres pays. ActiveX, Microsoft et Windows sont des marques ou des marques déposées de Microsoft Corporation aux Etats-Unis et/ou dans d’autres pays. Java est une marque ou une marque déposée de Sun Microsystems, Inc. aux Etats-Unis et/ou dans d’autres pays. Toutes les autres marques citées sont la propriété de leurs détenteurs respectifs.

Ce produit inclut des logiciels développés par Apache Software Foundation (http://www.apache.org/). Le format GIF© (Graphics Interchange Format) fait l'objet d'un copyright appartenant CompuServe Incorporated. GIF(sm) est une marque de service de CompuServe Incorporated. Technologie de compression audio MPEG Layer-3 utilisée sous licence de Fraunhofer IIS et Thomson Multimedia (http://www.mp3licensing.com). Vous n'êtes pas autorisé à utiliser les données audio MP3 compressées fournies avec le Logiciel pour les d iffusi ons en temps ré el ou en d irect. Si vou s nécessite z un déco deur MP 3 pour ce type de diffus ion, vous devez acqué rir une licence p our cette technologie MP3. Technologie de compression et décompression de la parole utilisée sous licence de Nellymoser, Inc. (www.nellymoser.com). Les vidéos Flash CS3 reposent sur la technologie vidéo On2 TrueMotion. © 1992-2005 On2 Technologies, Inc. Tous droits réservés. http://www.on2.com. Ce produit inclut des logiciels développés par OpenSymphony Group (http://www.opensymphony.com/). Technologie de compression et décompression vidéo Sorenson™ Spark™ sous licence de Sorenson Media, Inc.

Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, Etats-Unis. Note à l'intention du gouvernement des Etats-Unis. Le logiciel et sa documentation constituent des « éléments commerciaux », comme défini par 48 C.F.R. §2.101, qui incluent un « logiciel commercial » et la « documentation relative à ce logiciel », selon les termes utilisés par 48 C.F.R. §12.212 ou 48 C.F.R. §227.7202, en fonction du contexte. Conformément à 48 C.F.R. §12.212 ou 48 C.F.R. §§227.7202-1 jusqu'à 227.7202-4, selon le contexte, le logiciel commercial et la documentation correspondante sont concédés sous licence au gouvernement des Etats-Unis (a) uniquement en tant qu'éléments com merc iaux et (b ) et uniq ueme nt ave c les droi ts qu i son t acc ordé s à to us le s autr es ut ilis ateu rs co nfor méme nt aux ter mes e t conditions contenues ici. Droits non publiés réservés conformément aux lois du copyright des Etats-Unis. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, Etats-Unis. Pour les utilisateurs qui appartiennent au gouvernement des Etats-Unis, Adobe accepte de se conformer à toutes les lois relatives à l'égalité des chances, si nécessaire, conformément au règlement Executive Order 11246, et ses sous-amendements, Section 402 de la loi Vietnam Era Veterans Readjustment Assistance de 1974 (38 USC 4212) et à la section 503 de la loi Rehabilitation de 1973, et ses sous-amendements, ainsi que les règlements 41 CFR des sections 60-1 à 60-60, 60-250 et 60-741. La clause d'action affirmative et les règlements qui en découlent dans la phrase précédente doivent être incorporés par référence.

Table des matières

Chapitre 1 : Introduction

Informations préliminaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Installation d'une extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Création d'une extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Ressources supplémentaires pour les créateurs d'extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Nouveautés de Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Conventions utilisées dans ce manuel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Chapitre 2 : Personnalisation de Dreamweaver

Techniques de personnalisation de Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

Personnalisation de Dreamweaver dans un environnement multi-utilisateur . . . . . . . . . . . . . . . 11

Modification des mappages FTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Types de documents extensibles dans Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Modification des raccourcis clavier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

iii

Chapitre 3 : Personnalisation du mode Code

Indicateurs de code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Coloration du code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Validation du code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Modification du formatage HTML par défaut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Chapitre 4 : Extension de Dreamweaver

Types d'extensions Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Extensions et dossiers de configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

API d'extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Localisation d'une extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Utilisation de Extension Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Chapitre 5 : Interfaces utilisateur destinées aux extensions

Conception d'une interface utilisateur d'extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Commande de rendu HTML de Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Utilisation de commandes d'interface utilisateur personnalisées dans les extensions . . . . . . . 75

Ajout de contenu Flash à Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82

Chapitre 6 : Modèle d'objet de document (DOM) Dreamweaver

De quel DOM de document parlons-nous ? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

DOM Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Chapitre 7 : Objets de la barre Insertion

Fonctionnement des fichiers d'objet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

Fichier de définition de la barre Insertion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Modification de la barre Insertion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Exemple simple d'insertion d'un objet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101

Fonction de l'API des objets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109

Chapitre 8 : API de vérification des problèmes de compatibilité du navigateur

Procédure de détection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115

Exemple de fichiers Issue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116

Fonctions de l'API de vérification des problèmes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117

Chapitre 9 : Commandes

Fonctionnement des commandes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121

Ajout de commandes au menu Commandes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122

Exemple de commande simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122

Fonctions de l'API des commandes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127

Chapitre 10 : Menus et commandes de menu

A propos du fichier menus.xml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131

Modification des menus et des commandes de menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138

Commandes de menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .141

Exemple de commande de menu simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143

Exemple de menu dynamique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146

Fonctions de l'API des commandes de menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .152

Chapitre 11 : Barres d'outils

Fonctionnement des barres d'outils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .157

Fichier simple de commande de barre d'outils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159

Fichier de définition de la barre d'outils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .161

Balises d'éléments de barre d'outils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .165

Attributs des balises d'éléments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169

Fonctions de l'API de commande de barre d'outils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .173

Chapitre 12 : Rapports

Rapports de site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181

Rapports autonomes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183

Fonctions de l'API de rapports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .185

Chapitre 13 : Bibliothèques et éditeurs de balises

Format de fichier bibliothèque de balises . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .190

Sélecteur de balises . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .193

Exemple simple de création d'un éditeur de balise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .195

Fonctions de l'API de l'éditeur de balises . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .198

Chapitre 14 : Inspecteurs Propriétés

Fichiers d'inspecteur Propriétés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201

Fonctionnement des fichiers d'inspecteur Propriétés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .202

Exemple simple d'inspecteur Propriétés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .203

Fonctions de l'API de l'inspecteur Propriétés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .206

Chapitre 15 : Panneaux flottants

Mode de fonctionnement des fichiers de panneau flottant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .209

Exemple de panneau flottant simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .210

Fonctions de l'API du panneau flottant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215

Chapitre 16 : Comportements

Fonctionnement des comportements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221

Exemple de comportement simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .223

Fonction de l'API des comportements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .226

Chapitre 17 : Comportements de serveur

Architecture de Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234

Exemple de comportement de serveur simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .235

Comment appeler les fonctions de l'API de comportement de serveur . . . . . . . . . . . . . . . . . . . .237

API de comportement de serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .238

Fonctions d'implémentation des comportements de serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . .243

Modification des fichiers EDML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .245

Balises de fichiers EDML Groupe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .247

Fichiers EDML Participant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .252

Techniques de comportements de serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .268

Chapitre 18 : Sources de données

Fonctionnement des sources de données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .275

Exemple simple de source de données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .277

Fonctions de l'API des sources de données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .283

Chapitre 19 : Formats de serveur

Fonctionnement du formatage de données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .289

Mise en service des fonctions de formatage de données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .291

Fonctions de l'API des formats de serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .291

Chapitre 20 : Composants

Composants de base . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .295

Extension du panneau Composants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .295

Personnalisation du panneau Composants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .296

Fichiers du panneau Composants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .296

Fonctions de l'API du panneau Composants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .298

Chapitre 21 : Modèles de serveur

Fonctionnement de la personnalisation des modèles de serveur . . . . . . . . . . . . . . . . . . . . . . . . . .307

Fonctions de l'API des modèles de serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307

Chapitre 22 : Traducteurs de données

Fonctionnement des traducteurs de données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .313

Choix du type de traducteur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .314

Ajout d'un attribut traduit à une balise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .314

Inspection des attributs traduits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .315

Verrouillage des balises ou des blocs de code traduits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .316

Création d'inspecteurs Propriétés pour du contenu verrouillé . . . . . . . . . . . . . . . . . . . . . . . . . . . . .317

Recherche de bogues dans le traducteur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .319

Exemple de traducteur d'attributs simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .320

Exemple de traducteur de blocs/balises simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .323

Fonctions de l'API du traducteur de données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .327

Chapitre 23 : Extensions C

Intégration des fonctions C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .331

Extensions C et interpréteur JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .333

Types de données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .333

API d'extension C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .334

API de configuration multi-utilisateur et d'accès aux fichiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .340

Appel d'une fonction C à partir de JavaScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .346

Chapitre 24 : Dossier Shared

Contenu du dossier Shared . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .349

Utilisation du dossier Shared . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .354

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .355

Chapitre 1 : Introduction

Ce guide décrit l'API (interface de programmation d'application) et la plate-forme Adobe® Dreamweaver® CS3 qui vous permettent des créer des extensions de Dreamweaver. Il contient des informations sur le fonctionnement de chaque type d'extension, les fonctions API appelées par Dreamweaver pour mettre en œuvre les divers objets, menus, panneaux flottants, comportements de serveur, etc. qui composent Dreamweaver, ainsi qu'un exemple simple de chaque type d'extension. Il explique également comment personnaliser Dreamweaver en modifiant des balises dans divers fichiers HTML et XML pour ajouter des éléments de menu ou des types de documents.

Pour ajouter un objet, un menu, un panneau flottant ou toute autre fonctionnalité à Dreamweaver, vous devez encoder les fonctions requises par le type d'extension désirée. Ce guide décrit les arguments transmis par Dreamweaver à ces fonctions, ainsi que les valeurs attendues en retour par le programme.

Pour plus d'informations sur l'utilité et les possibilités offertes par les API JavaScript™, utilisables pour effectuer diverses opérations dans vos extensions Dreamweaver, consultez le Guide des API de Dreamweaver. Si vous envisagez de créer des extensions fonctionnant avec des bases de données, vous pouvez également consulter les sections du manuel Utilisation de Dreamweaver consacrées aux connexions de bases de données.

Informations préliminaires

La plupart des extensions Dreamweaver sont rédigées en langage HTML et en langage JavaScript. Les instructions présentées ici supposent que vous possédez une bonne maîtrise des éléments suivants : Dreamweaver et programmation JavaScript, HTML et XML. Par ailleurs, si vous implémentez des extensions C, vous devez savoir comment créer et utiliser des bibliothèques de liens dynamiques (DLL) C. Pour rédiger vos propres extensions afin de créer des applications Web, vous devez connaître les langages de script côté serveur et au moins l'une des plates-formes suivantes : Active Server Pages (ASP), ASP.net, PHP: Hypertext Preprocessor (PHP), Macromedia® ColdFusion® d'Adobe® ou JavaServer Pages (JSP).

Installation d'une extension

Pour vous familiariser avec la procédure de rédaction d'extensions, vous pouvez consulter les extensions, ainsi que les ressources disponibles sur le site Web d'Adobe Exchange (http://www.adobe.com/go/exchange_fr). L'installation d'une extension existante vous permet de découvrir quelques-uns des outil s qui vous seront ut iles pour travaill er avec vos propres extensions.

Pour installer une extension :

1 Téléchargez et installez Adobe® Extension Manager, qui est disponible sur le site de téléchargement d'Adobe, sur

http://www.adobe.com/go/downloads.

2 Connectez-vous au site Web Adobe Exchange sur http://www.adobe.com/go/exchange_fr.

3 Sélectionnez l'extension que vous souhaitez récupérer parmi celles disponibles. Cliquez sur le lien de téléchargement

pour télécharger le progiciel d'extension.

4 Enregistrez le progiciel d'extension dans le dossier Downloaded Extensions de votre dossier Dreamweaver.

5 Dans Extension Manager, choisissez Fichier > Installer une extension. Depuis Dreamweaver, choisissez Commandes >

Gérer les extensions pour lancer Extension Manager.

Extension Manager installe automatiquement l'extension dans Dreamweaver, depuis le dossier Downloaded Extensions.

Il est nécessaire de redémarrer Dreamweaver avant de pouvoir utiliser certaines extensions. Si Dreamweaver est en cours d'exécution pendant l'installation de l'extension, il vous sera peut-être demandé de fermer et de redémarrer l'application avant de poursuivre l'installation.

Pour afficher des informations de base sur l'extension à la suite de son installation, depuis Dreamweaver, ouvrez Extension Manager (Commandes > Gérer les extensions).

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

Création d'une extension

Avant de créer une extension Dreamweaver, consultez le site Web Adobe Exchange à

http://www.adobe.com/go/exchange_fr pour déterminer si l'extension à créer existe déjà. Si aucune extension existante ne

répond à vos besoins, procédez comme suit pour en créer une :

• Déterminez le type d'extension à créer. Pour plus d'informations sur les types d'extension, voir « Types d'extensions

Dreamweaver », page 65.

• Recherchez dans la documentation le type d'extension que vous souhaitez créer. Pour vous familiariser avec la procédure

de création du type d'extension requis, il est recommandé de créer l'exemple simple d'extension en vous reportant à la rubrique correspondante.

• Déterminez les fichiers à modifier ou créer.

• Le cas échéant, effectuez des préparatifs concernant l'interface utilisateur requise pour l'extension.

• Créez les fichiers requis et enregistrez-les dans les dossiers appropriés.

• Redémarrez Dreamweaver pour qu'il reconnaisse la nouvelle extension.

• Testez l'extension.

• Empaquetez l'extension pour pouvoir la partager avec d'autres utilisateurs. Pour plus d'informations, voir « Utilisation

de Extension Manager », page 72.

Ressources supplémentaires pour les créateurs d'extensions

Pour entrer en contact avec d'autres développeurs d'extensions, vous pouvez rejoindre le forum de discussion consacré à l'extensibilité de Dreamweaver. Vous pouvez accéder au site Web Adobe pour ce groupe de discussion sur

http://www.adobe.com/support/dreamweaver/extend/form/.

Nouveautés de Dreamweaver

Dreamweaver CS3 comprend les nouvelles fonctionnalités et interfaces extensibles suivantes. A chacune de ces fonctionnalités correspondent de nouvelles fonctions, répertoriées dans le Guide des API de Dreamweaver.

• Communication avec l'application Bridge

• Emulation de périphérique mobile

• Création d'un jeu de données Spry XML

• Modification et insertion de widget Spry

• Vérification de la compatibilité avec le navigateur

Pour plus d'informations sur les nouvelles fonctions ajoutées à l'API d'utilitaire ou à l'API JavaScript, consultez le Guide des API de Dreamweaver.

Centre de documentation

Approfondissez votre connaissance de Dreamweaver grâce aux ouvrages édités par Adobe. Consultez le contenu le plus récent et rédigé par des experts sur http://www.adobe.com/support/documentation/buy_books.html.

Fonctions supprimées

Diverses fonctions ont été supprimées de Dreamweaver CS3. Pour plus d'informations sur les fonctions éliminées de l'API d'utilitaire et de l'API JavaScript, voir le Guide des API de Dreamweaver.

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

Conventions utilisées dans ce manuel

Ce manuel utilise les conventions typographiques suivantes :

• La police de code indique des fragments de code et des constantes d'API, notamment des noms de classe, des noms de

méthodes, des noms de fonctions, des noms de type, des scripts, des instructions SQL et des noms de balises et d'attributs HTML et XML.

• La police de code en italique identifie les éléments remplaçables dans le code.

• Le symbole de continuation (¬) indique qu'une longue ligne de code a été fractionnée sur deux lignes ou plus. En raison

des limites de marge du format de ce guide, il n'est pas possible d'afficher certaines lignes de code sur une ligne. Lorsque vous copiez les lignes de code, supprimez le symbole de continuation et entrez-les comme une seule ligne.

• Les accolades ({ }) placées avant et après un argument de fonction indiquent que cet argument est facultatif.

• Les noms de fonction portant le préfixe dreamweaver. (comme dans dreamweaver.nomfonc) peuvent être abrégés en

dw.nomfonc lorsque vous écrivez le code. Ce manuel utilise le préfixe dreamweaver. complet dans les définitions de

fonctions et dans l'index. De nombreux exemples utilisent néanmoins le préfixe court (

Conventions de noms utilisées dans ce manuel :

• Vous le développeur responsable de la rédaction des extensions

• L'utilisateur la personne utilisant Dreamweaver

• Le visiteur la personne qui visualise la page Web créée par l'utilisateur.

dw.)

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

Chapitre 2 : Personnalisation de Dreamweaver

Outre créer et utiliser des extensions Adobe Dreamweaver CS3, vous pouvez personnaliser Dreamweaver de différentes manières afin de l'adapter au mieux à vos besoins.

Techniques de personnalisation de Dreamweaver

Il existe plusieurs approches pour personnaliser Dreamweaver. Certaines sont présentées dans Utilisation de Dreamweaver. Ces approches vous permettent de personnaliser l'espace de travail. Vous pouvez également modifier les paramètres dans les boîtes de dialogue de Dreamweaver. Vous pouvez définir des préférences dans divers domaines (accessibilité, coloration du code, polices, surbrillance et prévisualisation dans un navigateur), à l'aide du panneau Préférences (Edition > Préférences ou Dreamweaver > Préférences (Mac OS X)). Vous pouvez également modifier les raccourcis clavier à l'aide de l'éditeur de raccourcis clavier (Edition > Raccourcis clavier) ou en modifiant un fichier de configuration.

La liste suivante présente les diverses méthodes permettant de personnaliser Dreamweaver par la modification des fichiers de configuration :

• Modifier l'ordre des objets dans la barre Insertion, créer de nouveaux onglets pour réorganiser les objets ou ajouter de

nouveaux objets. Voir « Modification de la barre Insertion », page 99.

• Changer le nom des éléments de menu, ajouter de nouvelles commandes aux menus et supprimer des commandes

existantes des menus. Voir « Menus et commandes de menu », page 131.

• Modifier l'affichage des balises propriétaires (balises ASP et JSP comprises) dans la fenêtre de document en mode

Création. Voir « Personnalisation de l'interprétation de balises propriétaires », page 7.

• Adapte les raccourcis clavier en fonction de la disposition de votre clavier. Voir « Modification des raccourcis clavier »,

page 25.

Vous pouvez en outre adapter Dreamweaver à vos besoins en procédant comme suit :

• « Personnalisation des documents par défaut », page 5

• « Personnalisation des conceptions de pages », page 6

• « Personnalisation de l'aspect des boîtes de dialogue », page 6

• « Modification du type de fichier par défaut », page 6

• « Personnalisation de l'interprétation de balises propriétaires », page 7

• « Personnalisation des présentations de l'espace de travail », page 21

• « Personnalisation de la barre d'outils de codage », page 25

Personnalisation des documents par défaut

Le dossier DocumentTypes/NewDocuments contient, par défaut, un document (vierge) de chaque type de document que vous pouvez créer à l'aide de Dreamweaver. Lorsque vous créez un nouveau document vierge en sélectionnant Fichier > Nouveau et en sélectionnant un élément dans les listes Page de base, Page dynamique ou Autres catégories, Dreamweaver base le nouveau document sur le document par défaut correspondant dans ce dossier. Pour modifier les éléments par défaut d'un type de document donné, modifiez le document correspondant dans ce dossier.

Remarque : Si vous souhaitez que toutes les pages de votre site contiennent certains éléments communs (par exemple une mention sur le copyright) ou une présentation constante, il est préférable d'utiliser des modèles et des éléments de bibliothèque plutôt que de changer les documents par défaut. (Pour plus d'informations sur les modèles et les éléments de bibliothèque, voir Utilisation de Dreamweaver.)

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

Personnalisation des conceptions de pages

Dreamweaver propose divers éléments prédéfinis : feuilles de style CSS, jeux de cadres et conceptions de pages. Vous pouvez créer des pages basées sur ces conceptions en cliquant sur Fichier > Nouveau.

Pour personnaliser les conceptions disponibles, modifiez les fichiers présents dans les dossiers BuiltIn/css, BuiltIn/framesets, BuiltIn/Templates et BuiltIn/TemplatesAccessible

Remarque : Les conceptions répertoriées dans les catégories Conception de page et Conception de page (Accessibilité) sont les fichiers modèles de Dreamweaver. Pour plus d'informations sur les modèles, voir Utilisation de Dreamweaver.

Vous pouvez également créer des conceptions de pages en ajoutant des fichiers dans les sous-dossiers du dossier BuiltIn. Pour qu'une description du fichier s'affiche dans la boîte de dialogue Nouveau document, créez un fichier Design Notes (dans le dossier _notes approprié) correspondant au fichier de conception de page.

Personnalisation de l'aspect des boîtes de dialogue

La mise en forme des boîtes de dialogue pour les objets, les commandes et les comportements sont définis comme des formulaires HTML. Ils résident dans des fichiers HTML du dossier Configuration au sein du dossier d'application Dreamweaver. Ces formulaires peuvent être modifiés comme tout autre formulaire Dreamweaver. Pour plus d'informations, voir Utilisation de Dreamweaver.

Remarque : Dans le cadre d'un système d'exploitation multi-utilisateur, vous devez modifier les copies des fichiers de configuration contenues dans votre dossier de configuration utilisateur plutôt que les fichiers Configuration de Dreamweaver. Pour plus d'informations, voir « Dossiers de configuration multi-utilisateur », page 68.

Pour modifier l'aspect d'une boîte de dialogue :

1 Dans Dreamweaver, sélectionnez Edition > Préférences, puis la catégorie Correction du code.

2 Désélectionnez l'option Renommer les éléments de formulaire lors du collage.

Cette opération vous assure que les éléments de formulaire conserveront leur nom original une fois ceux-ci copiés et collés.

3 Cliquez sur OK pour fermer la boîte de dialogue Préférences.

4 Sur votre disque dur, localisez le fichier HTM approprié dans le dossier Configuration/Objects, Configu-

ration/Commands ou Configuration/Behaviors.

5 Faites une copie du fichier dans un dossier autre que le dossier Configuration.

6 Ouvrez cette copie dans Dreamweaver, modifiez le formulaire et enregistrez le document.

7 Quittez Dreamweaver.

8 Copiez le fichier modifié à la place de l'original dans le dossier Configuration. Il est toutefois conseillé de conserver une

sauvegarde du fichier original pour pouvoir l'utiliser à nouveau en cas de besoin.

9 Redémarrez Dreamweaver pour constater les changements.

Il est recommandé de ne modifier que l'aspect de la boîte de dialogue et non son fonctionnement. Le type des éléments de formulaire doit être identique, tout comme les noms, afin que l'information obtenue par Dreamweaver à partir de la boîte de dialogue puisse être utilisée de la même manière.

Par exemple, l'objet Commentaire prend le texte entré dans une zone de texte de boîte de dialogue et utilise une fonction JavaScript simple pour transformer ce texte en commentaire HTML et l'insérer dans votre document. Le formulaire qui décrit la boîte de dialogue se trouve dans le fichier Comment.htm dans le dossier Configuration/Objects/Invisibles. Vous pouvez ouvrir ce fichier et modifier la taille ou d'autres attributs dans la zone de texte, mais si vous supprimez intégralement la balise

textarea ou si vous modifiez la valeur de son attribut name, l'objet Commentaire ne fonctionne plus correctement.

Modification du type de fichier par défaut

Par défaut, Dreamweaver affiche tous les types de fichiers reconnus dans la boîte de dialogue Fichier > Ouvrir. Vous pouvez utiliser un menu contextuel dans cette boîte de dialogue pour limiter l'affichage de certains types de fichiers. Si la plupart de vos travaux impliquent un type de fichier spécifique (par exemple, les fichiers ASP), vous pouvez modifier l'affichage par défaut. Le type de fichier indiqué sur la première ligne du fichier Extensions.txt de Dreamweaver devient le type par défaut.

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

Remarque : Pour afficher tous les types de fichiers dans la boîte de dialogue Fichier > Ouvrir (y compris les fichiers que Dreamweaver ne peut pas ouvrir), vous devez sélectionner Tous les fichiers (*.*). Ne confondez pas cette option avec Tous les documents, qui répertorie uniquement les fichiers que Dreamweaver peut ouvrir.

Pour modifier le type de fichier par défaut de Dreamweaver dans Fichier > Ouvrir :

1 Créez une copie de sauvegarde du fichier Extensions.txt dans le dossier Configuration.

2 Ouvrez le fichier Extensions.txt dans Dreamweaver ou dans un éditeur de texte.

3 Coupez la ligne correspondant au nouveau type par défaut et collez-la en tête du fichier, en première ligne.

4 Enregistrez le fichier.

5 Redémarrez Dreamweaver.

Pour afficher le nouveau type par défaut, sélectionnez Fichier > Ouvrir, puis examinez le menu contextuel de types de fichiers.

Pour ajouter de nouveaux types de fichier dans le menu de la boîte de dialogue Fichier > Ouvrir :

1 Créez une copie de sauvegarde du fichier Extensions.txt dans le dossier Configuration.

2 Ouvrez le fichier Extensions.txt dans Dreamweaver ou dans un éditeur de texte.

3 Ajoutez une nouvelle ligne pour chaque nouveau type de fichier.

a Tapez en majuscules les extensions de fichier gérées par le nouveau type de fichier, en les séparant par une virgule.

b Ajoutez le signe deux points et une brève description, qui apparaîtra dans le menu contextuel de types de fichiers associé

à la boîte de dialogue qui s'affiche lorsque vous sélectionnez Fichier > Ouvrir.

Par exemple, pour les fichiers JPEG, entrez les informations suivantes :

JPG,JPEG,JFIF:Fichiers image JPEG

4 Enregistrez le fichier.

5 Redémarrez Dreamweaver.

Pour observer les modifications, sélectionnez Fichier > Ouvrir, puis cliquez sur le menu contextuel de types de fichiers.

Personnalisation de l'interprétation de balises propriétaires

Les technologies côté serveur telles que ASP, ColdFusion, JSP et PHP utilisent du code spécial non HTML au sein des fichiers HTML. Les serveurs créent et servent du contenu HTML basé sur ce code. Lorsque Dreamweaver rencontre des balises non HTML, il les compare aux informations contenues dans les fichiers de balises propriétaires, lesquels définissent comment lire et afficher ces balises non HTML.

Par exemple, les fichiers ASP contiennent (outre le code HTML habituel) du code ASP que le serveur doit interpréter. Le code ASP ressemble à une balise HTML, mais il est signalé par des délimiteurs : il commence par dossier Configuration/ThirdPartyTags de Dreamweaver contient un fichier nommé Tags.xml. Ce fichier décrit le format des diverses balises propriétaires, dont le code ASP, et décrit comment Dreamweaver doit afficher ce code. La façon dont le code ASP est spécifié dans le fichier Tags.xml conduit Dreamweaver à ne pas tenter d'interpréter le code situé entre les délimiteurs. A la place, en mode Création, seule une icône indiquant la présence de code ASP s'affiche. Vos propres fichiers de données de balises peuvent définir l'affichage et la lecture de vos balises par Dreamweaver. Créez un nouveau fichier de données de balises pour chaque jeu de balises afin d'indiquer à Dreamweaver comment les afficher.

Remarque : Cette section vous explique comment définir l'affichage d'une balise personnalisée par Dreamweaver, mais ne décrit pas comment modifier le contenu ou les propriétés d'une balise personnalisée. Pour plus d'informations sur la création d'un inspecteur Propriétés permettant de vérifier et modifier les propriétés d'une balise personnalisée, voir « Inspecteurs Propriétés », page 201.

Chaque fichier de données de balises définit le nom, le type, le modèle de contenu, le modèle de rendu et l'icône pour une ou plusieurs balises. Vous pouvez créer un nombre illimité de fichiers de données de balises, mais tous doivent se trouver dans le dossier Configuration/ThirdPartyTags afin d'être consultés et traités par Dreamweaver. Les fichiers de données de balises portent l'extension .xml.

<% et s'arrête par %>. Le

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

Si vous travaillez sur plusieurs sites distincts à la fois (par exemple, en tant que développeur indépendant), vous pouvez regrouper toutes les spécifications de balises relatives à un site dans un fichier. Il suffit ensuite de remettre ce fichier de

données de balises avec les icônes personnalisées et les inspecteurs Propriétés aux responsables qui géreront le site.

Vous pouvez définir une spécification de balise à l'aide d'une balise XML nommée décrit les spécifications d'une balise nommée

happy :

tagspec. Par exemple, le code suivant

Vous pouvez définir deux types de balises à l'aide de tagspec :

• Balises de type HTML standard

happy est un exemple de balise de type HTML standard. Elle débute par une balise d'ouverture <happy>, des données sont

placées entre les balises d'ouverture et de fermeture, et elle se termine par une balise

</happy> de fermeture.

• Balises délimitées par des chaînes

Les balises délimitées par des chaînes débutent par une chaîne et se terminent par une autre chaîne. Elles se comportent comme des balises HTML vides (telle de fermeture. Si la balise

start_string et end_string. Une balise ASP est une balise délimitée par des chaînes. Elle commence par la chaîne <% et se

termine par la chaîne

happy était délimitée par des chaînes, les spécifications de balises incluraient les attributs

%>, sans balise de fermeture.

img), car elles n'entourent pas les données de balises et ne comportent pas de balises

Les informations suivantes décrivent les attributs et les valeurs valides de la balise tagspec. Les attributs marqués d'un astérisque (*) sont ignorés dans le cadre des balises délimitées par des chaînes. Les attributs optionnels sont définis par des accolades (

{}) dans la liste des attributs ; les attributs ne comportant pas d'accolades sont donc requis.

<tagspec>

Description

Fournit des informations à propos d'une balise propriétaire.

Attributs

tag_name, {tag_type}, {render_contents}, {content_model}, {start_string}, {end_string}, {detect_in_attribute}, {parse_attributes}, icon, icon_width, icon_height, {equivalent_tag}, {is_visual}, {server_model}

• tag_name est le nom de la balise personnalisée. Pour les balises délimitées par des chaînes, tag_name n'est utilisé que pour

déterminer si un inspecteur Propriétés donné peut être utilisé pour la balise. Si la première ligne de l'inspecteur Propriétés contient ce nom de balise encadré par des astérisques, l'inspecteur peut être utilisé pour les balises de ce type. Par exemple, le nom de balise associé au code ASP correspond à

ASP. Les inspecteurs Propriétés pouvant examiner le code

ASP doivent comporter la mention *ASP* sur la première ligne. Pour plus d'informations sur l'inspecteur Propriétés API, voir « Inspecteurs Propriétés », page 201.

• tag_type détermine si la balise est vide (telle que img) ou si un contenu est présent entre les balises d'ouverture et de

fermeture (telles que est ignoré pour les balises délimitées par des chaînes, ces dernières étant toujours vides. Les valeurs valides sont et "nonempty".

code). Cet attribut est requis pour les balises normales (non délimitées par des chaînes). Cet élément

"empty"

• render_contents détermine si le contenu de la balise doit s'afficher en mode Création ou s'il est remplacé par l'icône

spécifiée. Cet attribut est requis pour les balises nonempty et n'est pas pris en compte pour les balises empty (les balises empty sont vides de contenu). Cet attribut ne s'applique qu'aux balises affichées hors des attributs. Le contenu des balises imbriquées à l'intérieur des valeurs d'attributs d'autres balises n'est pas affiché. Les valeurs valides sont

"true" et "false".

• content_model décrit les différents types de contenu que la balise peut contenir et l'emplacement où la balise peut

s'afficher dans un fichier HTML. Les valeurs valides sont

"script_model".

"block_model", "head_model", "marker_model" et

• block_model spécifie que la balise peut contenir des éléments de niveau de bloc comme div et p et que la balise

peut apparaître uniquement dans la section body ou dans d'autres balises au contenu body, telles que

td.

div, layer

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

• head_model spécifie que le contenu de la balise peut être composé de texte et que la balise peut uniquement

apparaître dans la section head.

• marker_model spécifie que la balise peut contenir tout code HTML valide et peut se trouver à tout endroit du

fichier HTML. Le validateur HTML de Dreamweaver ignore les balises spécifiées comme

marker_model.

Néanmoins, le validateur n'ignore pas le contenu de ces balises. En conséquence, même si la balise peut apparaître à n'importe quel emplacement, le contenu de la balise peut corrompre le document HTML à certains endroits. Par exemple, du texte simple ne peut apparaître dans la section head d'un document (à l'exception des éléments head valides). Il est donc impossible de placer une balise

marker_model qui contient du texte simple

dans la section head. Pour placer une balise personnalisée dans la section head, définissez le modèle de contenu de la balise comme s'afficher en ligne (dans un élément de niveau de bloc, comme

head_model au lieu de marker_model. Utilisez marker_model pour les balises qui doivent

p ou div, par exemple, dans un paragraphe).

N'utilisez pas ce modèle si la balise doit être affichée seule dans un paragraphe, encadrée par des sauts de ligne.

• script_model permet un emplacement libre de la balise entre les balises d'ouverture et de fermeture d'un

document. Lorsque Dreamweaver rencontre une balise de ce modèle, il ignore totalement le contenu de la balise. Utilisez cette balise pour le marquage (comme certaines balises ColdFusion) que Dreamweaver ne doit pas analyser.

• start_string spécifie un délimiteur qui marque le début d'une balise délimitée par des chaînes. Les balises délimitées

par des chaînes peuvent être présentes en tout point du document pouvant contenir un commentaire. Dreamweaver n'analyse pas les balises et ne décode pas les entités ou URL comprises entre est requis si

end_string est spécifié.

start_string et end_string. Cet attribut

• end_string spécifie un délimiteur qui marque la fin d'une balise délimitée par une chaîne. Cet attribut est requis si

start_string est spécifié.

• detect_in_attribute indique si les éléments contenus entre start_string et end_string (ou entre les balises

d'ouverture et de fermeture si ces chaînes ne sont pas définies) doivent être ignorés même si ces chaînes apparaissent dans les valeurs ou noms d'attributs. Vous devez généralement régler la valeur sur chaînes. La valeur par défaut est

"false". Ainsi, les balises ASP sont parfois imbriquées dans des valeurs d'attributs et

contiennent parfois des guillemets ("). Parce que la balise ASP spécifie

"true" pour les balises délimitées par des

detect_in_attribute="true", Dreamweaver ne

tient pas compte des balises ASP, y compris des guillemets internes, lorsqu'elles sont imbriquées dans des valeurs d'attributs.

• parse_attributes indique si les attributs de la balise doivent être analysés. Si la valeur définie est "true" (par défaut),

Dreamweaver analyse les attributs. Si elle est définie sur situé hors des guillemets. Par exemple, cet attribut doit être réglé sur exemple,

<cfif a is 1>, que Dreamweaver ne peut pas analyser comme ensemble de paires nom d'attribut/valeur).

"false", Dreamweaver ignore tous les éléments jusqu'au crochet

"false" pour les balises telles que cfif (par

• icon spécifie le chemin et le nom de fichier de l'icône associée à la balise. Cet attribut est requis pour les balises empty

ainsi que pour les balises nonempty dont le contenu ne s'affiche pas dans la fenêtre de document en mode Création.

• icon_width spécifie la largeur de l'icône en pixels.

• icon_height spécifie la hauteur de l'icône en pixels.

• equivalent_tag spécifie des équivalents HTML simples pour certaines balises liées à des formulaires ColdFusion. Ceci

ne doit pas être utilisé avec d'autres balises.

• is_visual indique si la balise a un impact visuel sur la page. Par exemple, la balise ColdFusion cfgraph ne spécifie

aucune valeur pour ColdFusion Eléments invisibles dans la boîte de dialogue Préférences. La visibilité des balises de marquage de serveur visuel peut être définie indépendamment de celle des balises de marquage de serveur non visuel.

is_visual ; la valeur par défaut "true" est donc appliquée. La valeur is_visual de la balise

cfset est définie sur false. La visibilité des balises de marquage de serveur est contrôlée par la catégorie

• server_model, si spécifié, indique que la balise tagspec s'applique uniquement aux pages appartenant au modèle de

serveur spécifié. Si teurs des balises ASP et JSP sont identiques, mais la balise sur

"JSP". Par conséquent, lorsque Dreamweaver rencontre ce code avec les délimiteurs adéquats sur une page JSP, il

affiche une icône JSP. Lorsque ce code est rencontré sur une page autre qu'une page JSP, une icône ASP s'affiche.

server_model n'est pas spécifié, la balise tagspec s'applique à toutes les pages. Par exemple, les délimi-

tagspec pour JSP spécifie un paramètre server_model défini

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

Contenu

Aucun (balise vide).

Contenant

Aucun.

Exemple

Affichage des balises personnalisées dans le mode Création

L'affichage des balises personnalisées dans la fenêtre de document en mode Création dépend des valeurs entrées pour les attributs l'attribut s'affiche de la même façon que pour une balise vide. L'exemple suivant indique comment une instance de la balise

tag_type et render_contents de la balise tagspec. Si la valeur de tag_type est "empty", l'icône spécifiée dans icon s'affiche. Si la valeur de tag_type est "nonempty" mais que la valeur de render_contents est "false", l'icône

happy

définie antérieurement peut apparaître dans le code HTML :

<p> Paragraphe incluant une occurrence de <code>happy</code> tag (<happy>Joe</happy>).</p>

Dans la mesure où render_contents est réglé sur "false" dans la spécification de balise, le contenu de la balise happy (le mot

Joe) ne s'affiche pas. Les balises de début et de fin et leur contenu sont alors remplacés par une icône unique.

Pour les balises nonempty dont la valeur render_contents est réglée sur "true", l'icône ne s'affiche pas dans le mode Création. C'est le contenu inséré entre les balises d'ouverture et de fermeture qui s'affiche (par exemple, le texte contenu entre les balises dans

<mytag>Ceci est le contenu inséré entre les balises d'ouverture et de fermeture</mytag>).

Si l'option Affichage > Eléments invisibles est activée, le contenu est mis en surbrillance à l'aide de balises propriétaires, comme spécifié dans les préférences de surbrillance (la mise en surbrillance ne s'applique qu'aux balises définies dans les fichiers de données de balises).

Pour modifier la couleur de surbrillance des balises propriétaires :

1 Sélectionnez Edition > Préférences, puis la catégorie Surbrillance.

2 Cliquez sur la zone de sélection de couleurs de balises propriétaires pour afficher le sélecteur de couleur.

3 Sélectionnez une couleur, puis cliquez sur OK pour fermer la boîte de dialogue Préférences. Pour plus d'informations sur

la sélection d'une couleur, voir Utilisation de Dreamweaver.

Comment éviter la modification de balises propriétaires

Dreamweaver corrige certains types d'erreurs dans le code HTML. Pour plus d'informations, voir Utilisation de Dreamweaver. Par défaut, Dreamweaver évite toute modification du code HTML dans les fichiers portant certaines extensions,

comme .asp (ASP), .cfm (ColdFusion), .jsp (JSP) et .php (PHP). Ce paramètre est défini pour éviter toute modification accidentelle du code contenu dans de telles balises non HTML. Vous pouvez modifier le comportement de correction de Dreamweaver par défaut afin que le code HTML soit modifié lors de l'ouverture de tels fichiers. Vous pouvez également ajouter d'autres types de fichiers auxquels Dreamweaver n'apportera pas de modifications.

Dreamweaver encode certains caractères spéciaux en les remplaçant par des valeurs numériques lorsque vous les entrez dans l'inspecteur Propriétés. Il est normalement préférable de laisser Dreamweaver effectuer cet encodage car, ainsi, les caractères spéciaux seront reconnus par un nombre plus important de plates-formes et de navigateurs. Néanmoins, cette opération d'encodage peut interférer avec les balises propriétaires. Vous pouvez donc modifier le comportement de Dreamweaver concernant l'encodage des balises lorsque vous travaillez avec des fichiers comportant des balises propriétaires.

Pour permettre à Dreamweaver de corriger le code HTML dans plus de types de fichiers :

1 Sélectionnez Edition > Préférences, puis la catégorie Correction du code.

2 Sélectionnez l'une des options suivantes :

• Corriger les balises incorrectement imbriquées et non fermées

• Supprimer les balises de fermeture superflues

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

3 Effectuez l’une des tâches suivantes :

• Supprimez une ou plusieurs des extensions de la liste dans l'option Ne jamais corriger le code : Dans les fichiers

avec extensions.

• Désélectionnez l'option Ne jamais corriger le code : Dans les fichiers avec extensions. La désactivation de cette

option permet à Dreamweaver de réécrire le code HTML dans tous types de fichiers.

Pour ajouter des fichiers dans lesquels Dreamweaver ne doit pas apporter de corrections :

1 Sélectionnez Edition > Préférences, puis la catégorie Correction du code.

2 Sélectionnez l'une des options suivantes :

• Corriger les balises incorrectement imbriquées et non fermées

• Supprimer les balises de fermeture superflues

3 Assurez-vous que l'option Ne jamais corriger le code : Dans les fichiers avec extensions est sélectionnée et ajoutez les nouvelles extensions de fichiers à la liste dans la zone de texte.

Si le nouveau type de fichier ne s'affiche pas dans le menu contextuel Types de fichiers dans la boîte de dialogue Fichier > Ouvrir, vous pouvez l'ajouter dans le fichier Configuration/Extensions.txt. Pour plus de détails, voir « Modification du type de fichier par défaut », page 6.

Pour désactiver les options d'encodage de Dreamweaver :

1 Sélectionnez Edition > Préférences, puis la catégorie Correction du code.

2 Désélectionnez les options de caractères spéciaux de votre choix.

Pour plus d'informations sur les autres préférences de correction de code, voir Utilisation de Dreamweaver.

Personnalisation de Dreamweaver dans un environnement multi-utilisateur

Vous pouvez personnaliser Dreamweaver dans un système d'exploitation multi-utilisateur tel que Microsoft® Windows® 2000, Windows XP ou Mac OS® X. Aucune configuration personnalisée de Dreamweaver ne peut affecter celle d'un autre utilisateur. Pour ce faire, lors de la première exécution de Dreamweaver sous un système d'exploitation multiutilisateur reconnu, Dreamweaver copie divers fichiers de configuration dans un dossier Configuration utilisateur destiné à votre utilisation personnelle. Lorsque vous personnalisez Dreamweaver à l'aide des panneaux et boîtes de dialogue, l'application modifie vos fichiers de configuration utilisateur au lieu de modifier les fichiers de configuration de Dreamweaver. Pour personnaliser Dreamweaver en modifiant un fichier de configuration dans un environnement multi-utilisateur, modifiez le fichier de configuration utilisateur correspondant au lieu de modifier les fichiers du dossier Configuration de Dreamweaver. Pour apporter une modification affectant la plupart des utilisateurs, vous pouvez modifier un fichier Configuration de Dreamweaver, mais les utilisateurs disposant déjà de fichiers de configuration personnels ne seront pas affectés. En général, si vous souhaitez apporter une modification affectant tous les utilisateurs, il est préférable de créer une extension et de l'installer à l'aide de Extension Manager.

Remarque : Sur des systèmes d'exploitation plus anciens (Windows 98, Windows ME et Mac OS 9.x), un seul groupe de fichiers de configuration de Dreamweaver est partagé par tous les utilisateurs, même si la configuration du système d'exploitation prend en charge plusieurs utilisateurs.

L'emplacement du dossier Configuration varie selon la plate-forme utilisateur.

Les plates-formes Windows 2000 et Windows XP utilisent l'emplacement suivant :

lecteur:\Documents and Settings\nom_utilisateur\Application Data\Adobe\Dreamweaver 9\Configuration

Remarque : Sous Windows XP, ce dossier peut se trouver dans un dossier masqué.

Les plates-formes Mac OS X utilisent l'emplacement suivant :

lecteur:Users/nom_utilisateur/Library/Application Support/Adobe/Dreamweaver 9/Configuration

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

Remarque : Pour installer des extensions accessibles à tous les utilisateurs dans un système d'exploitation multi-utilisateur, vous devez disposer des droits Administrateur (Windows) ou root (Mac OS X).

Lorsque vous exécutez Dreamweaver pour la première fois, il ne copie que certains fichiers de configuration dans votre dossier de configuration utilisateur. (les fichiers copiés sont spécifiés dans le fichier version.xml dans le dossier Configuration). Lorsque vous personnalisez Dreamweaver depuis l'application même (par exemple, lorsque vous modifiez un des fragments de code prédéfinis dans le panneau Fragments de code), Dreamweaver copie les fichiers concernés dans votre dossier de configuration utilisateur. La version d'un fichier présente dans le dossier de configuration utilisateur prime toujours sur celle du dossier Configuration de Dreamweaver. Pour personnaliser un fichier de configuration qui n'a pas été copié par Dreamweaver dans le dossier de configuration utilisateur, copiez en premier lieu le fichier du dossier Configuration de Dreamweaver vers l'emplacement correspondant dans votre dossier de configuration utilisateur. Modifiez ensuite cette copie dans votre dossier de configuration utilisateur.

Suppression de fichiers de configuration dans un environnement multi-utilisateur

Lors de toute opération engendrant l'effacement d'un fichier de configuration dans Dreamweaver sous un système d'exploitation multi-utilisateur (par exemple, la suppression d'un fragment de code prédéfini dans le panneau Fragments de code), Dreamweaver crée un fichier nommé mm_deleted_files.xml dans votre dossier Configuration. Lorsqu'un fichier est répertorié dans le fichier mm_deleted_files.xml, Dreamweaver se comporte comme si le fichier n'existait plus.

Pour désactiver un fichier de configuration :

1 Quittez Dreamweaver.

2 A l'aide d'un éditeur de texte, modifiez le fichier mm_deleted_files.xml dans votre dossier de configuration utilisateur,

ajoutez une balise d'élément dans ce fichier en indiquant le chemin (relatif au dossier Configuration de Dreamweaver) du fichier de configuration à désactiver.

Remarque : Ne modifiez pas le fichier mm_deleted_files.xml dans Dreamweaver.

3 Enregistrez et fermez mm_deleted_files.xml.

4 Lancez à nouveau Dreamweaver.

A propos de la syntaxe de la balise mm_deleted_files.xml

Le fichier mm_deleted_files.xml contient une liste structurée d'éléments qui indiquent les fichiers de configuration que Dreamweaver doit ignorer. Ces éléments sont spécifiés par des balises XML, que vous pouvez modifier dans un éditeur de texte.

Les sections suivantes décrivent la syntaxe des balises du fichier mm_deleted_files.xml. Les attributs optionnels sont définis par des accolades (

<deleteditems>

{}) dans la liste des attributs ; les attributs ne comportant pas d'accolades sont donc requis.

Description

Balise de conteneur renfermant une liste d'éléments à considérer comme supprimés par Dreamweaver.

Attributs

Aucun.

Contenu

Cette balise doit contenir une ou plusieurs balises item.

Contenant

Aucun.

Exemple

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

<item>

Description

Définit un fichier de configuration à ignorer par Dreamweaver.

Attributs

name

L'attribut name spécifie le chemin du fichier de configuration par rapport au dossier Configuration. Sous Windows, utilisez une barre oblique inversée (\) pour séparer les éléments constitutifs du chemin ; sur Macintosh®, utilisez deux points (:).

Contenu

Aucun (balise vide).

Contenant

Cette balise doit se trouver dans une balise deleteditems.

Exemple

Réinstallation et désinstallation de Dreamweaver dans un environnement multiutilisateurs

Après avoir installé Dreamweaver, si vous souhaitez réinstaller le programme ou le mettre à jour, Dreamweaver sauvegarde automatiquement une copie des fichiers de configuration utilisateur existants. Vos paramètres personnels resteront donc accessibles. Lors de la désinstallation de Dreamweaver dans un environnement multi-utilisateur (opération possible uniquement pour les utilisateurs disposant de privilèges administratifs), Dreamweaver peut supprimer tous les dossiers de configuration utilisateur à votre demande.

Modification des mappages FTP

Le fichier FTPExtensionMap.txt (Windows) et le fichier FTPExtensionMapMac.txt (Macintosh) mappent les extensions de nom de fichier en modes de transfert FTP (ASCII ou BINAIRE).

Chaque ligne dans chacun des deux fichiers comprend une extension de nom de fichier (par exemple, GIF) ainsi que le mot ASCII ou le mot BINARY (binaire) pour indiquer quel mode utiliser lors du transfert d'un fichier comportant cette extension. Sur Macintosh, chaque ligne comprend également un code créateur (tel que DmWr) et un type de fichier (tel que TEXT). Lorsque vous téléchargez un fichier portant l'extension donnée, Dreamweaver lui assigne alors le créateur et le type de fichier désignés.

Si un fichier que vous transférez ne comporte pas d'extension de nom de fichier, Dreamweaver utilise le mode de transfert BINAIRE.

Remarque : Dreamweaver ne peut pas transférer de fichiers en mode Macbinary. Si vous devez transférer des fichiers en mode Macbinary, vous devez utiliser un autre client FTP.

Les exemples suivants illustrent une ligne (du fichier Macintosh) indiquant que les fichiers portant l'extension .html doivent être transférés en mode ASCII :

HTML DmWr TEXT ASCII

Dans le fichier FTPExtensionMap.txt et le fichier FTPExtensionMapMac.txt (Macintosh), tous les éléments placés sur une même ligne sont séparés par des tabulations. L'extension et le mode de transfert sont écrits en majuscules.

Pour modifier un paramètre par défaut, modifiez le fichier dans un éditeur de texte.

Pour ajouter des informations relatives à une nouvelle extension de nom de fichier :

1 Modifiez le fichier extension-map dans un éditeur de texte.

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

2 Sur une ligne vierge, entrez l'extension de nom de fichier (en majuscules), puis appuyez sur la touche de tabulation.

3 Sur Macintosh, ajoutez le code créateur, un caractère de tabulation, puis le type de fichier suivi d'un autre caractère de

tabulation.

4 Choisissez entre ASCII ou BINARY pour spécifier un mode de transfert FTP.

5 Enregistrez le fichier.

Types de documents extensibles dans Dreamweaver

XML est doté d'un système performant pour définir des documents et des structures de données complexes. Dreamweaver organise selon plusieurs schémas XML les informations sur les comportements de serveur, les balises et les boîtes de dialogue de balises, les composants, les types de documents et des références.

Lorsque vous créez et utilisez des extensions dans Dreamweaver, vous pouvez souvent créer ou modifier les fichiers XML existants afin de gérer les données utilisées par ces extensions. Dans la plupart des cas, vous pouvez copier un fichier existant du sous-dossier approprié du dossier Configuration vers le dossier à utiliser comme modèle.

Fichier de définition de type de document

Le concept de type de document s'articule autour d'un composant central, à savoir le fichier de définition de type de document. Vous pouvez être en présence de plusieurs fichiers de définition ; le cas échéant, ils résident tous dans le dossier Configuration/DocumentTypes. Chaque fichier de définition contient des informations concernant au moins un type de document. Des informations essentielles, telles que le modèle de serveur, le style de codage par couleurs, les descriptions, etc., sont décrits pour chacun de ces types de documents.

Remarque : Attention, il ne faut pas confondre fichiers de définition de type de document de Dreamweaver et définition de type de document XML (DTD). Les fichiers de définition de type de document de Dreamweaver contiennent un ensemble d'éléments

documenttype, chacun d'entre eux définissant une collection prédéfinie de balises et d'attributs associés à un type de document.

Au lancement, Dreamweaver analyse les fichiers de définition de type de document et place en mémoire une base de données d'informations concernant tous les types de documents définis.

Dreamweaver fournit un fichier de définition de type de document initial. Ce fichier, nommé MMDocumentTypes.xml, contient les définitions de type de document fournies par Adobe :

Type de document Modèle de serveur Type interne Extensions de

fichier

A SP. NE T C # A SP. N ET -C s ha r p D yn a mi qu e a sp x, as cx

A SP. NE T V B A SP. NE T- VB D yn a mi qu e a sp x, as cx

ASP JavaScript ASP-JS Dynamique asp

ASP VBScript ASP-VB Dynamique asp

ColdFusion ColdFusion Dynamique cfm, cfml UltraDev 4 ColdFusion

Composant ColdFusion Dynamique cfc

JSP JSP Dynamique jsp

PHP PHP Dynamique php, php3

Elément de bibliothèque Extension DW lbi

Modèle ASP.NET C# Modèle DW axcs.dwt

Modèle ASP.NET VB Modèle DW axvb.dwt

Modèle ASP JavaScript Modèle DW aspjs.dwt

Modèle de serveur antérieur

Modèle ASP VBScript Modèle DW aspvb.dwt

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

Type de document Modèle de serveur Type interne Extensions de

fichier

Modèle ColdFusion Modèle DW cfm.dwt

Modèle HTML Modèle DW dwt

Modèle JSP Modèle DW jsp.dwt

Modèle PHP Modèle DW php.dwt

HTML HTML htm, html

ActionScript Texte as

CSharp Texte cs

CSS Texte CSS

Java Texte java

JavaScript Texte js

VB Texte vb

VBScript Texte vbs

Tex te Tex te t xt

EDML XML edml

TLD XML tld

VTML XML vtm, vtml

WML XML wml

Modèle de serveur antérieur

XML XML xml

Si vous avez besoin de créer un nouveau type de document, vous pouvez soit ajouter votre entrée dans le fichier de définition de document fourni par Adobe (MMDocumentTypes.xml), soit ajouter votre propre fichier de définition dans le dossier Configuration/DocumentTypes.

Remarque : Le sous-dossier NewDocuments résidant dans le dossier Configuration/DocumentTypes contient des pages par défaut (modèles) propres à chaque type de document.

Structure des fichiers de définition de type de document

L'exemple suivant représente un fichier classique de définition de type de document :

<?xml version="1.0" encoding="utf-8"?> <documenttypes xmlns:MMString="http://www.Macromedia.com/schemes/data/string/">

<documenttype

id="dt-ASP-JS" servermodel="ASP-JS" internaltype="Dynamic" winfileextension="asp,htm, html" macfileextension=asp, html" previewfile="default_aspjs_preview.htm" file="default_aspjs.htm" priorversionservermodel="UD4-ASP-JS" > <titre>

</documenttype> ...

</documenttypes>

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

Remarque : Le codage par couleurs des types de documents est défini dans les fichiers XML qui résident dans le dossier Configuration/CodeColoring.

Dans l'exemple précédent, l'élément

loadstring identifie les chaînes localisées que Dreamweaver devrait utiliser pour le

titre et la description des documents de type ASP-JS. Pour plus d'informations sur les chaînes localisées, voir « Chaînes localisées », page 19.

Le tableau ci-dessous recense les balises et les attributs autorisés dans un fichier de définition de type de document.

Type d'élément Obligatoire Description

Balise Attribut

documenttype

(root)

id Oui Identificateur unique pour tous les fichiers de définition de type de

servermodel Non Spécifie le modèle de serveur associé (casse prise en compte). Les

internaltype Oui Classification générale des modes de traitement des fichiers

dynamicid Non Référence à l'identificateur unique d'un type de document dynamique.

Oui Nœud parent.

document.

valeurs suivantes sont valides par défaut :

ASP.NET C# ASP.NET VB ASP VBScript ASP JavaScript ColdFusion JSP PHP MySQL

Un appel des fonctions getServerModelDisplayName() renvoie ces noms. Les fichiers d'implémentation des modèles de serveur se trouvent dans le dossier Configuration/ServerModels.

Les nouveaux modèles de serveur créés par les développeurs d'extensions viendront compléter cette liste.

dans Dreamweaver. Le type interne détermine si le mode Création est activé pour ce document et traite des cas particuliers tels que les extensions ou les modèles Dreamweaver.

Les valeurs suivantes sont valides :

Dynamique DWExtension (zones d'affichage spéciales) DWTemplate (zones d'affichage spéciales) HTML HTML4 Text (mode Code uniquement) XHTML1 XML (mode Code uniquement)

Tous les types de documents liés au serveur de modèle doivent être associés à la valeur Dynamic. HTML doit être en correspondance avec HTML. Les fichiers de script, notamment les fichiers .css, .js, .vb et .cs doivent être en correspondance avec Text.

Si internaltype correspond à DWTemplate, il convient également de spécifier dynamicid. Si, dans le cas présent, vous omettez de spécifier dynamicid, le type de document du nouveau modèle vierge créé à partir de la boîte de dialogue Nouveau document ne sera pas reconnu par les panneaux Comportements de serveur ou Liaisons. Les instances de ce modèle sont des modèles HTML.

Cet attribut n'est pertinent que lorsque internaltype correspond à DWTemplate. I l vo us p er met d'a ss oci er un m odè le dyn am iqu e av ec u n type de document dynamique.

Type d'élément Obligatoire Description

Balise Attribut

winfileextension Oui Extension de fichier associée au type de document sous Windows.

Utilisez une liste séparée par des virgules pour spécifier plusieurs extensions. La première extension de cette liste correspond à l'extension utilisée par Dreamweaver lorsque l'utilisateur enregistre un document de type documenttype.

Lorsque deux types de documents non liés à un modèle de serveur portent la même extension de fichier, Dreamweaver reconnaît le premier comme le type de document associé à l'extension.

macfileextension Oui Extension de fichier associée au type de document sur Macintosh.

Lorsque deux types de documents non associés à un modèle de serveur portent la même extension de fichier, Dreamweaver reconnaît le premier comme le type de document associé à l'extension.

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

titre

(sous-balise)

description

(sous-balise)

previewfile Non Fichier rendu dans la zone Aperçu de la boîte de dialogue Nouveau

file Oui Le fichier situé dans le dossier DocumentTypes/NewDocuments

priorversionservermodel Non S'il existe un équivalent du modèle de serveur de ce document dans

Oui Chaîne qui apparaît comme élément de catégorie sous la section

Non Chaîne de description du type de document. Vous pouvez insérer cette

document.

contenant le contenu du modèle des nouveaux documents de type documenttype.

Dreamweaver UltraDev 4, spécifiez le nom de la version antérieure du modèle de serveur.

UltraDev 4 ColdFusion est un modèle de serveur antérieur valide.

Document vierge de la boîte de dialogue Nouveau document. Vous pouvez insérer cette chaîne directement dans le fichier de défin ition ou pointer vers elle indirectement pour la localiser. Pour plus d'informations sur la localisation de cette chaîne, voir « Chaînes localisées », page 19.

La mise en forme n'étant pas autorisée, il est impossible de spécifier les balises HTML.

chaîne directement dans le fichier de définition ou pointer vers elle indirectement pour la localiser. Pour plus d'informations sur la localisation de cette chaîne, voir « Chaînes localisées », page 19.

La mise en forme étant autorisée, il est possible de spécifier les balises HTML.

Remarque : Lorsque l'utilisateur enregistre un nouveau document, Dreamweaver examine la liste des extensions de la plateforme actuelle qui sont associées avec le type de document (

winfileextension et macfileextension). Dreamweaver sélec-

tionne la première chaîne de la liste pour l'utiliser comme l'extension de fichier par défaut. Pour changer cette extension de fichier par défaut, les extensions de la liste séparées par des virgules doivent être réorganisées de telle sorte que la nouvelle extension par défaut soit la première entrée de la liste.

Au lancement, Dreamweaver lit tous les fichiers de définition de type de document et crée une liste des types de documents valides. Dreamweaver traite toutes les entrées des fichiers de définition pour lesquels des modèles de serveur inexistants sont utilisés comme types de documents non serveur de modèle. Dreamweaver ignore les entrées dont le contenu est incorrect ou dont les ID ne sont pas uniques.

Si, pendant l'analyse du dossier Configuration/DocumentTypes, Dreamweaver ne détecte aucun fichier de définition de type de document ou si l'un des fichiers de définition semble endommagé, Dreamweaver s'arrête en affichant un message d'erreur.

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

Modèles dynamiques

Vous pouvez créer des modèles d'après des types de documents dynamiques, appelés des modèles dynamiques. La notion de modèle dynamique repose sur les deux éléments fondamentaux suivants :

• La valeur de l'attribut internaltype d'un nouveau type de document doit être DWTemplate.

• L'attribut dynamicid doit être défini et sa valeur doit faire référence à l'identificateur d'un type de document existant.

L'exemple suivant définit un type de document dynamique :

<documenttype

id="PHP_MySQL" servermodel="PHP MySQL" internaltype="Dynamic" winfileextension="php,php3" macfileextension="php,php3" file="Default.php"> <title>PHP</title> <description><![CDATA[PHP document]]></description>

</documenttype>

Vous pouvez désormais définir le modèle dynamique suivant, basé sur ce type de document PHP_MySQL :

<documenttype

id="DWTemplate_PHP" internaltype="DWTemplate" dynamicid="PHP_MySQL" winfileextension="php.dwt" macfileextension="php.dwt" file="Default.php.dwt"> <title>PHP Template</title> <description><![CDATA[Dreamweaver PHP Template document]]></description>

</documenttype>

Lorsqu'un utilisateur de Dreamweaver crée un nouveau modèle vierge de type DWTemplate_PHP, Dreamweaver lui permet de créer des comportements de serveur PHP dans le fichier. En outre, lorsque cet utilisateur crée des instances du nouveau modèle, il peut leur définir aussi des comportements de serveur PHP.

Dans l'exemple précédent, où l'utilisateur enregistre le modèle, Dreamweaver ajoute automatiquement l'extension .php.dwt au fichier. De même, lorsque cet utilisateur enregistre une instance du modèle, le fichier reçoit l'extension .php.

Extensions de documents et types de fichiers

Par défaut, Dreamweaver affiche tous les types de fichiers reconnus dans la boîte de dialogue Fichier > Ouvrir. Une fois le nouveau type de document créé, il incombe aux développeurs d'extensions de mettre à jour le fichier Extensions.txt approprié. Si l'utilisateur travaille sur un système multi-utilisateur (par exemple, Windows XP, Windows 2000 ou Mac OS X), son dossier Configuration contient un autre fichier Extensions.txt. L'utilisateur doit mettre à jour le fichier Extensions.txt car il s'agit de l'instance recherchée et analysée par Dreamweaver.

L'emplacement du dossier Configuration varie selon la plate-forme utilisateur.

Les plates-formes Windows 2000 et Windows XP utilisent l'emplacement suivant :

lecteur:\Documents and Settings\nom_utilisateur\Application Data\Adobe\Dreamweaver 9\Configuration

Remarque : Sous Windows XP, ce dossier peut se trouver dans un dossier masqué.

Les plates-formes Mac OS X utilisent l'emplacement suivant :

lecteur:Use rs/ nom_utilisateur/Library/Application Support/Adobe/Dreamweaver 9/Configuration

Si Dreamweaver ne parvient pas à localiser le fichier Extensions.txt dans le dossier Configuration de l'utilisateur, Dreamweaver le recherche dans le dossier Dreamweaver Configuration.

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

Remarque : Sur les plates-formes multi-utilisateur, toute modification de la copie du fichier Extensions.txt qui réside dans le dossier Dreamweaver Configuration, et non pas celle du dossier Configuration de l'utilisateur, est transparente pour Dreamweaver, lequel analyse la copie du fichier Extensions.txt située dans le dossier Configuration de l'utilisateur, et non pas celle du dossier Dreamweaver Configuration.

Pour cela, vous avez le choix entre ajouter la nouvelle extension à un type de document existant ou créer un nouveau type de document.

Pour ajouter une nouvelle extension à un type de document existant :

1 Modifiez le fichier MMDocumentTypes.xml.

2 Ajoutez la nouvelle extension aux attributs winfileextension et macfileextension du type de document existant.

Pour ajouter un nouveau type de document :

1 Créez une copie de sauvegarde du fichier Extensions.txt dans le dossier Configuration.

2 Ouvrez le fichier Extensions.txt dans Dreamweaver ou un éditeur de texte.

3 Ajoutez une nouvelle ligne pour chaque nouveau type de fichier. Entrez, en majuscules, les extensions de noms de

fichiers compatibles avec le nouveau type de fichier et séparez-les par des virgules. Ajoutez ensuite deux points et une brève description à afficher dans le menu contextuel pour les types de fichiers qui s'affichent dans la boîte de dialogue Fichier > Ouvrir.

Par exemple, pour les fichiers JPEG, entrez

JPG,JPEG,JFIF:Fichiers image JPEG

4 Enregistrez le fichier Extensions.txt.

5 Redémarrez Dreamweaver.

Pour observer les modifications, sélectionnez Fichier > Ouvrir et cliquez sur le menu contextuel répertoriant les types de fichiers.

Pour modifier le type de fichier indiqué par défaut dans Fichier > Ouvrir de Dreamweaver :

1 Créez une copie de sauvegarde du fichier Extensions.txt dans le dossier Configuration.

2 Ouvrez le fichier Extensions.txt dans Dreamweaver ou un éditeur de texte.

3 Coupez la ligne correspondant au nouveau type par défaut et collez-la en tête de fichier, sur la première ligne.

4 Enregistrez le fichier Extensions.txt.

5 Redémarrez Dreamweaver.

Pour observer les modifications, sélectionnez Fichier > Ouvrir et cliquez sur le menu contextuel répertoriant les types de fichiers.

Chaînes localisées

Dans un fichier de définition de type de document, les sous-balises <title> et <description> désignent le titre d'affichage et la description du type de document. Vous pouvez utiliser la directive espace réservé pour les chaînes localisées de ces deux sous-balises. Ce procédé, similaire à la programmation de scripts côté serveur, permet de spécifier l'utilisation d'une chaîne particulière dans votre page en utilisant un identificateur de chaîne comme espace réservé. Cet espace réservé accepte les balises spéciales ou les attributs de balises dont la valeur est remplacée.

MMString:loadstring dans les sous-balises comme

Pour fournir des chaînes localisées :

1 Placez l'instruction suivante en tête du fichier de définition de type de document :

<?xml version="1.0" encoding="utf-8"?>

2 Déclarez les espaces de nom MMString dans la balise <documenttypes> :

<documenttypes

xmlns:MMString="http://www.Macromedia.com/schemes/data/string/">

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

3 A l'emplacement du fichier de définition de type de document auquel insérer une chaîne localisée, utilisez la directive

MMString:loadstring pour définir un espace réservé à cette chaîne. Vous pouvez spécifier cet espace réservé en procédant

comme suit, au choix :

<loadstring>myJSPDocType/Description</loadstring>

</description>la balise

</description>

Dans ces exemples, myJSPDocType/Description est un identificateur de chaîne unique faisant office d'espace réservé à la chaîne localisée. La chaîne localisée est définie à l'étape suivante.

4 Dans le dossier Configuration/Strings, créez un fichier XML (ou modifiez un fichier existant) définissant la chaîne localisée. Par exemple, lorsque le code suivant est inséré dans le fichier Configuration/Strings/strings.xml, il définit la chaîne

myJSPDocType/Description :

<chaînes> ...

<string id="myJSPDocType/Description"

value=

"<![CDATA[JavaServer Page with <em>special</em> features]]>" />

... </strings>

Remarque : Les identificateurs de chaîne, tels que myJSPDocType/Description dans l'exemple précédent, doivent être uniques dans l'application Dreamweaver. Au lancement, Dreamweaver analyse tous les fichiers XML du dossier Configuration/Strings et charge ces chaînes uniques.

Règles d'utilisation des fichiers de définition de type de document

Dreamweaver autorise les types de documents associés à un modèle de serveur à partager des extensions de fichiers. Par exemple, ASP-JS et ASP-VB peuvent adopter l'extension .asp. (pour savoir quel modèle de serveur prévaut, voir « canRecognizeDocument() », page 307).

Dreamweaver n'autorise pas les types de documents non associés à un modèle de serveur à partager des extensions de fichiers.

Si une extension de fichier est revendiquée par deux types de documents alors qu'un type est associé à un modèle de serveur et que l'autre ne l'est pas, ce dernier prévaut. Supposons que vous ayez défini un type de document appelé SAM, non associé à un modèle de serveur et portant l'extension de fichier .sam, et que vous ajoutiez cette extension au type de document ASPJS. Lorsqu'un utilisateur ouvre un fichier portant l'extension .sam dans Dreamweaver, le programme lui affecte le type de document SAM, et non pas le type ASP-JS.

Ouverture d'un document dans Dreamweaver

Lorsqu'un utilisateur ouvre un document, Dreamweaver identifie en plusieurs étapes le type de document d'après son extension de fichier.

Si Dreamweaver détecte un type de document unique, il l'utilise et charge le modèle de serveur associé (le cas échéant) pour le document que l'utilisateur ouvre. Si cet utilisateur a opté pour l'utilisation des comportements de serveur de Dreamweaver UltraDev 4, Dreamweaver charge le modèle de serveur UltraDev 4 correspondant.

Si l'extension de fichier est commune à plusieurs types de documents, Dreamweaver effectue les opérations suivantes :

• Si un type de document statique figure dans la liste des types de documents, il prévaut.

• Si tous les types de documents sont dynamiques, Dreamweaver génère une liste alphabétique des modèles de serveur

associés à ces types de documents, puis appelle la fonction serveur (voir « canRecognizeDocument() », page 307). Dreamweaver collecte les valeurs de retour et identifie le modèle de serveur qui a renvoyé l'entier positif le plus grand. Le type de document dont le modèle de serveur a renvoyé l'entier

canRecognizeDocument() pour chacun des modèles de

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

le plus grand correspond au type de document assigné par Dreamweaver au document en cours d'ouverture. Si, toutefois, plusieurs modèles de serveur renvoient le même entier, Dreamweaver passe en revue la liste alphabétique de ces modèles de serveur, choisit le premier de la liste, puis l'utilise. Si, par exemple, les types ASP-JS et ASP-VB portent la même extension .asp et que leur fonction

canRecognizeDocument() respective renvoie une valeur égale, Dreamweaver affecte

au document le type ASP-JS (puisque ASP-JS apparaît en premier dans l'ordre alphabétique).

Si Dreamweaver ne peut pas faire correspondre l'extension de fichier à un type de document, Dreamweaver ouvre le document au format texte.

Personnalisation des présentations de l'espace de travail

Dreamweaver vous permet de personnaliser la présentation de l'espace de travail. Vous pouvez ainsi spécifier les panneaux inclus dans la présentation indiquée, ainsi que divers autres attributs tels que la position et la taille des panneaux, leur état (réduit ou développé), la position et la taille de la fenêtre d'application, ainsi que la position et la taille de la fenêtre de document.

La présentation de l'espace de travail est spécifiée dans les fichiers XML stockés dans le dossier Configuration/Workspace layouts. Les sections suivantes décrivent la syntaxe des balises XML. Les attributs optionnels sont définis par des accolades (

{}) dans la liste des attributs ; les attributs ne comportant pas d'accolades sont donc requis.

<panelset>

Description

Balise d'extrémité, qui signale le début de la description du jeu de panneaux.

Attributs

Aucun.

Contenu

Cette balise peut contenir une ou plusieurs balises application, document ou panelset.

Contenant

Aucun.

Exemple

</panelset>

<application>

Description

Stipule la position et la taille initiales de la fenêtre d'application.

Attributs

rect, maximize

• rect spécifie la position et la taille de la fenêtre d'application. La chaîne est exprimée au format « gauche haut droite bas »,

spécifié sous forme de nombres entiers.

• maximize est une valeur booléenne : true si la fenêtre d'application est agrandie au démarrage, false dans le cas

contraire. La valeur par défaut est

true.

Contenu

Aucun.

Contenant

Cette balise doit être imbriquée dans une balise panelset.

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

Exemple

</panelset>

<document>

Description

Stipule la position et la taille initiales de la fenêtre de document.

Attributs

rect, maximize

• rect spécifie la position et la taille de la fenêtre de document. La chaîne est exprimée au format « gauche haut droite bas »,

spécifié sous forme de nombres entiers. Si la valeur

maximize est réglée sur true, la valeur rect n'est pas prise en compte.

• maximize est une valeur booléenne : true si la fenêtre de document est agrandie au démarrage, false dans le cas

contraire. La valeur par défaut est

true.

Contenu

Aucun.

Contenant

Cette balise doit être imbriquée dans une balise panelset.

Exemple

</panelset>

<panelframe>

Description

Décrit un groupe entier de panneaux.

Attributs

x, y, {width, height}, dock, collapse

• x indique la position de gauche du groupe de panneaux. Vous pouvez le régler sur un nombre entier ou sur une valeur

relative à l'écran. Si le nombre entier excède les limites de l'écran, le groupe de panneaux s'affiche à l'emplacement le plus proche possible pour être visible à l'écran. Les valeurs relatives gérées sont « left » ou « right » et identifient la bordure du groupe de panneaux alignée sur la bordure de l'écran virtuel.

• y indique la position supérieure du groupe de panneaux. Vous pouvez le régler sur un nombre entier ou sur une valeur

relative à l'écran. Si le nombre entier excède les limites de l'écran, le groupe de panneaux s'affiche à l'emplacement le plus proche possible pour être visible à l'écran. Les valeurs relatives gérées sont « top » ou « bottom » et identifient la bordure du groupe de panneaux alignée sur la bordure de l'écran virtuel.

• width indique la largeur du groupe de panneaux, exprimée en pixels. Cet attribut est facultatif. Si vous ne spécifiez pas

de largeur, la valeur par défaut du groupe de panneaux est utilisée.

• height indique la hauteur du groupe de panneaux, exprimée en pixels. Cet attribut est facultatif. Si vous ne spécifiez pas

de hauteur, la valeur par défaut du groupe de panneaux est utilisée.

• dock est une chaîne qui identifie la bordure du cadre d'application sur laquelle est ancré le groupe de panneaux. Cet

attribut n'est pas pris en compte sur Macintosh, car il est impossible d'ancrer les groupes de panneaux.

• collapse est une valeur booléenne : true indique que le groupe de panneaux est réduit, false indique que le groupe de

panneaux est développé. Cet attribut n'est pas pris en compte sur Macintosh, car les panneaux flottent.

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

Contenu

Cette balise doit contenir une ou plusieurs balises panelcontainer.

Contenant

Cette balise doit être imbriquée dans une balise panelset.

Exemple

</panelframe>

</panelset>

<panelcontainer>

Description

Décrit un groupe entier de panneaux.

Attributs

expanded, title,{ height,} activepanel, visible, maximize, maxRestorePanel, maxRestoreIndex, maxRect, tabsinheader

• expanded est une valeur booléenne : true si le panneau est développé, false s'il ne l'est pas.

• title est une chaîne qui indique le titre du panneau.

• height est un nombre entier qui indique la hauteur des panneaux, exprimée en pixels. Cet attribut est facultatif. Si vous

ne spécifiez pas

Remarque : La largeur est héritée du parent.

height, la valeur par défaut de chaque panneau est utilisée.

• activepanel est une valeur numérique correspondant à l'ID du panneau avant.

• visible est une valeur booléenne : true si le panneau est visible, false s'il ne l'est pas.

• maximize est une valeur booléenne : true si le panneau doit être agrandi au lancement, false dans le cas contraire.

• maxRestorePanel est une valeur numérique correspondant à l'ID du panneau à afficher suite à une restauration.

• maxRect est une chaîne qui indique la position et la taille du panneau agrandi. La chaîne est exprimée au format « gauche

haut droite bas », spécifié sous forme de nombres entiers.

• tabsinheader est une valeur booléenne : true indique que les onglets doivent être placés dans le titre plutôt que sous la

barre de titre,

false stipule l'inverse.

Contenu

Cette balise doit contenir une ou plusieurs balises panel.

Contenant

Cette balise doit être imbriquée dans une balise panelframe.

Exemple

</panelcontainer>

</panelframe>

</panelset>

ADOBE DREAMWEAVER 9.0

Extension de Dreamweaver

<panel>

Description

Spécifie le panneau qui s'affiche dans le contenant.

Attributs

id, visibleTab

• id est une valeur numérique correspondant à l'ID du panneau. Le tableau ci-dessous contient une liste de valeurs.

Logiciel ID Panneau

Adobe® Flash® 1 Propriétés

2Actions

3Alignement

4 Comportements

5 Composants

6Inspecteur de composants

7Mélangeur

8Nuanciers

9Historique

10 Info

11 Bibliothèque

12 Explorateur d'animations

13 Sortie

14 Propriétés

15 Projet

16 Transformer

17 Séquence

18 Chaînes

19 Débogueur

101–110 Bibliothèque

Dreamweaver 1 Propriétés

Flex Builder 1 Propriétés

• visibleTab est une valeur booléenne : true pour afficher l'onglet et le panneau et false dans le cas contraire.

Contenu

Aucun.

Contenant

Cette balise doit être imbriquée dans une balise panelcontainer.

+ 340 hidden pages

ADOBE Dreamweaver CS3 User Manual [fr]

Specifications and Main Features

Frequently Asked Questions

User Manual

Table des matières

Chapitre 1 : Introduction

Informations préliminaires

Installation d'une extension

Création d'une extension

Ressources supplémentaires pour les créateurs d'extensions

Nouveautés de Dreamweaver

Centre de documentation

Fonctions supprimées

Conventions utilisées dans ce manuel

Chapitre 2 : Personnalisation de Dreamweaver

Techniques de personnalisation de Dreamweaver

Personnalisation des documents par défaut

Personnalisation des conceptions de pages

Personnalisation de l'aspect des boîtes de dialogue

Modification du type de fichier par défaut

Personnalisation de l'interprétation de balises propriétaires

<tagspec>

Affichage des balises personnalisées dans le mode Création

Comment éviter la modification de balises propriétaires

Personnalisation de Dreamweaver dans un environnement multi-utilisateur

Suppression de fichiers de configuration dans un environnement multi-utilisateur

A propos de la syntaxe de la balise mm_deleted_files.xml

<deleteditems>

<item>

Modification des mappages FTP

Types de documents extensibles dans Dreamweaver

Fichier de définition de type de document

Structure des fichiers de définition de type de document

Modèles dynamiques

Extensions de documents et types de fichiers

Chaînes localisées

Règles d'utilisation des fichiers de définition de type de document

Ouverture d'un document dans Dreamweaver

Personnalisation des présentations de l'espace de travail

<panelset>

<application>

<document>

<panelframe>

<panelcontainer>

<panel>