ADOBE Dreamweaver CS5 User Manual [fr]

Extension

ADOBE® DREAMWEAVER® CS5 & CS5.5

d’

Mentions légales

Mentions légales

Vous trouverez des informations juridiques à l'adresse http://help.adobe.com/fr_FR/legalnotices/index.html.

Dernière mise à jour le 22/6/2011

Sommaire

Chapitre 1 : Introduction

A propos des extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

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

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

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

Nouvelles fonctionnalités de Dreamweaver CS5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

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

Chapitre 2 : Personnalisation de Dreamweaver

Techniques de personnalisation de Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

iii

Chapitre 3 : Personnalisation du mode Code

A propos des conseils de code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

A propos de la coloration du code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

A propos de la validation du code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

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

A propos du mode Fractionnement vertical . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

A propos des fichiers apparentés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

A propos de l'affichage en direct . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Chapitre 4 : Extension de Dreamweaver

Types d'extensions Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Extensions et dossiers de configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

API d'extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

Localisation d'une extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Utilisation d'Extension Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Chapitre 5 : Interfaces utilisateur destinées aux extensions

Instructions de conception d'une interface utilisateur d'extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Commande de rendu HTML de Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

Commandes d'interface utilisateur personnalisées dans les extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Ajout de contenu Flash à Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

Intégration de Photoshop et d'objets dynamiques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

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

A propos du DOM de Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

Distinction entre les DOM de document utilisateur et d'extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

DOM Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Sommaire

Chapitre 7 : Objets de la barre Insertion

Fonctionnement des fichiers d'objet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

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

Modification de la barre Insertion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

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

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

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

Procédure de détection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

Exemple de fichiers de problèmes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131

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

Chapitre 9 : Commandes

Fonctionnement des commandes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

Ajout de commandes au menu Commandes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

Exemple de commande simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

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

Chapitre 10 : Menus et commandes de menu

Fichier menus.xml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

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

Commandes de menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158

Exemple de commande de menu simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

Exemple de menu dynamique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

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

iv

Chapitre 11 : Barres d'outils

Fonctionnement des barres d'outils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

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

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

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

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

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

Chapitre 12 : Rapports

Rapports de site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

Rapports autonomes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

Fonctions de l'API de rapports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

Chapitre 13 : Bibliothèques et éditeurs de balises

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

Sélecteur de balises . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

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

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

Chapitre 14 : Inspecteurs Propriétés

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

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

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Sommaire

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

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

Chapitre 15 : Panneaux flottants

Fonctionnement des fichiers de panneau flottant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

Exemple de panneau flottant simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232

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

Chapitre 16 : Comportements

Fonctionnement des comportements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

Exemple de comportement simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245

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

Chapitre 17 : Comportements de serveur

Terminologie des comportements de serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256

Architecture de Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257

Exemple de comportement de serveur simple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

Scénarios dans lesquels les fonctions de l'API de comportement de serveur sont appelées . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

API de comportement de serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

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

Fichiers EDML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268

Balises de fichiers EDML Groupe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270

Fichiers EDML Participant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

Techniques de comportements de serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294

v

Chapitre 18 : Sources de données

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

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

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

Chapitre 19 : Formats de serveur

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

Scénarios dans lesquels les fonctions de formatage des données sont appelées . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318

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

Chapitre 20 : Composants

A propos des notions de base des composants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322

Extension du panneau Composants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322

Personnalisation du panneau Composants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323

Personnalisation des fichiers du panneau Composants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323

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

Chapitre 21 : Modèles de serveur

Personnalisation des modèles de serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335

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

Chapitre 22 : Traducteurs de données

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

Détermination du type de traducteur à utiliser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Sommaire

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

Inspection des attributs traduits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344

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

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

Recherche de bogues dans le traducteur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349

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

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

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

Chapitre 23 : Extensions C

Intégration des fonctions C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361

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

Types de données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363

API d'extension C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364

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

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

Chapitre 24 : Dossier Shared

Contenu du dossier Shared . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381

Utilisation du dossier Shared . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386

vi

Dernière mise à jour le 22/6/2011

Chapitre 1 : Introduction

Ce guide décrit l'API (interface de programmation d'application) et la plate-forme Adobe® Dreamweaver® CS5 qui
vous permettent des créer des extensions de Dreamweaver. Le guide Extension de Dreamweaver CS5 fournit des
informations sur les thèmes suivants :

• la façon dont chaque type d'extension fonctionne ;

• les fonctions d'API que Dreamweaver appelle pour mettre en oeuvre les différents objets ;

• les menus, panneaux flottants, comportements de serveur, etc. qui constituent les fonctionnalités de Dreamweaver ;

• un exemple simple de chaque type d'extension ;

• la façon de personnaliser Dreamweaver en modifiant des balises dans divers fichiers HTML et XML, afin d'ajouter

des commandes ou des types de documents.

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, consultez les sections du manuel Utilisation de
Dreamweaver consacrées aux connexions de bases de données.

1

A propos des extensions

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), Adobe® ColdFusion®, 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 outils qui vous seront utiles pour travailler avec
vos propres extensions.

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_fr.

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.

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Introduction

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).

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'extensions, voir « Types

d'extensions Dreamweaver » à la page 79.

• 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 d'Extension Manager » à la page 86.

2

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

Pour entrer en contact avec d'autres développeurs d'extensions, rejoignez le forum de discussion consacré à
l'extensibilité de Dreamweaver. Vous trouverez ce forum sur le site Web d'Adobe, à l'adresse

http://www.adobe.com/cfusion/webforums/forum/categories.cfm?forumid=12&catid=190&entercat=y.

Nouvelles fonctionnalités de Dreamweaver CS5

Nouveautés

chacune de ces fonctionnalités possède de nouvelles fonctions apparentées qui ont été ajoutées à l'API d'utilitaire et à
l'API JavaScript. Pour plus d'informations sur les nouvelle fonctions, voir Nouveautés de Dreamweaver CS5.

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Introduction

Centre de documentation

Approfondissez votre connaissance de Dreamweaver grâce aux ouvrages publié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. 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.

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 manuel, une ligne de code continue doit ici être coupée. 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
définitions de fonctions et dans l'index. De nombreux exemples utilisent néanmoins le préfixe court (

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

dw.).

3

Ce manuel utilise les conventions de dénomination suivantes :

• 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

Dernière mise à jour le 22/6/2011

Chapitre 2 : Personnalisation de Dreamweaver

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

Techniques de personnalisation de Dreamweaver

Vous pouvez personnaliser Dreamweaver en employant plusieurs méthodes générales. Certaines sont présentées dans
Utilisation de Dreamweaver. Vous pouvez définir des préférences dans divers domaines, comme l'accessibilité, la
coloration de code, les polices, la mise en surbrillance et l'aperçu dans les navigateurs, par l'intermédiaire du panneau
Préférences (Edition > Préférences ou Dreamweaver > Préférences (MacOs 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.

4

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.

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.

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

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 » à la page 82.

Modification de l'aspect d'une boîte de dialogue

1 Dans Dreamweaver, choisissez 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,

Configuration/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.

5

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.

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), choisissez Tous les fichiers (*.*). Ne confondez pas cette option avec Tous les
documents, qui répertorie uniquement les fichiers que Dreamweaver peut ouvrir.

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

Modification du 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 un éditeur de texte.

3 Coupez la ligne correspondant à la nouvelle valeur par défaut. Collez-la ensuite au début du fichier, de façon à ce

qu'elle devienne sa première ligne.

4 Enregistrez le fichier.

5 Redémarrez Dreamweaver.

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

Ajout 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 un éditeur de texte.

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

gérées par le nouveau type de fichier, en les séparant par une virgule. 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

JPG,JPEG,JFIF:Fichiers image JPEG

6

4 Enregistrez le fichier.

5 Redémarrez Dreamweaver.

Pour observer les modifications, choisissez 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, Adobe 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 est marqué par une paire de délimiteurs : il commence par
termine par

%>. Le 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 » à la page 223.

<% et se

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

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.

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 tagspec. Par exemple, le code
suivant décrit les spécifications d'une balise nommée

<tagspec tag_name="happy" tag_type="nonempty" render_contents="false" content_model=
"marker_model" icon="happy.gif" icon_width="18" icon_height="18"></tagspec>

happy :

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

7

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
comportent pas de balises de fermeture. Si la balise
balises incluraient les attributs
chaînes. Elle commence par la chaîne

start_string et end_string. Une balise ASP est une balise délimitée par des

<% et se termine par la chaîne %>, sans balise de fermeture.

Les informations suivantes décrivent les attributs et les valeurs valides de la balise

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

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

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 facultatifs sont définis
par des accolades (

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

<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 à
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 » à la page 223.

ASP. Les inspecteurs Propriétés

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

• 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

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

Il est ignoré pour les balises délimitées par des chaînes, car celles-ci sont toujours vides. Les valeurs valides sont

"empty" et "nonempty".

• 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.

et

div, layer

• 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

end_string. Cet attribut est requis si end_string est spécifié.

start_string et

• 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

start_string est spécifié.

si

• 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
balises délimitées par des chaînes. La valeur par défaut est

"false". Ainsi, les balises ASP sont parfois imbriquées

"true" pour les

dans des valeurs d'attributs et contiennent parfois des guillemets ("). Parce que la balise ASP spécifie

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.

8

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

• 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
jusqu'au crochet situé hors des guillemets. Par exemple, cet attribut doit être réglé sur

cfif (par exemple, <cfif a is 1>, que Dreamweaver ne peut pas analyser comme ensemble de paires nom

que

"false", Dreamweaver ignore tous les éléments

"false" pour les balises telles

d'attribut/valeur).

• 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

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 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.

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

de serveur spécifié. Si
les délimiteurs des balises ASP et JSP sont identiques, mais la balise

server_model défini sur "JSP". Par conséquent, lorsque Dreamweaver rencontre ce code avec les délimiteurs

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

tagspec pour JSP spécifie un paramètre

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.

9

Contenu

Aucun (balise vide).

Conteneur

Aucun.

Exemple

<tagspec tag_name="happy" tag_type="nonempty" render_contents="false" content_model=
"marker_model" icon="happy.gif" icon_width="18" icon_height="18"></tagspec>

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
spécifiée dans l'attribut

render_contents est "false", l'icône s'affiche de la même façon que pour une balise vide. L'exemple suivant indique

comment une instance de la balise

<p>This is a paragraph that includes an instance of the <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.

tag_type et render_contents de la balise tagspec. Si la valeur de tag_type est "empty", l'icône

icon s'affiche. Si la valeur de tag_type est "nonempty" mais que la valeur de

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

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

Pour les balises nonempty dont la valeur render_contents est réglée sur "true", l'icône ne s'affiche pas en 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

fermeture</mytag>). Si l'option Affichage > Eléments invisibles est activée, le contenu est mis en surbrillance à l'aide

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

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).

Modification de la couleur de surbrillance des balises propriétaires

1 Choisissez 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.

Prévention de la correction 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.

10

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
les caractères spéciaux seront ainsi 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.

Permettre à Dreamweaver de corriger le code HTML dans plus de types de fichiers

1 Choisissez 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 Effectuez l'une des opérations suivantes :

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

les fichiers avec extensions.

• Désactivez 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.

Ajout de fichiers dans lesquels Dreamweaver ne doit pas apporter de corrections

1 Choisissez 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

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

3 Assurez-vous que l'option Ne jamais corriger le code: Dans les fichiers avec extensions est sélectionnée. 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 d'informations, voir
« Modification du type de fichier par défaut » à la page 5.

Désactivation des options d'encodage de Dreamweaver

1 Choisissez 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 sous un système d'exploitation multi-utilisateur tel que Microsoft®
Windows® XP, Windows Vista ou Mac OS® X. Aucune configuration personnalisée de Dreamweaver ne peut affecter
celle d'un autre utilisateur. Lorsque vous exécutez pour la première fois Dreamweaver sous un système d'exploitation
multi-utilisateur, Dreamweaver copie les fichiers de configuration dans un dossier Configuration utilisateur. 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 dans un environnement multi-utilisateur, modifiez le fichier de configuration utilisateur approprié au
lieu de modifier les fichiers de configuration de Dreamweaver. Pour apporter des modifications qui influeront la
plupart des utilisateurs, modifiez un fichier Configuration de Dreamweaver. Toutefois, les utilisateurs auxquels
correspondent déjà des fichiers de configuration utilisateur ne seront pas concernés par ces modifications. Pour
apporter des modifications qui influeront sur tous les utilisateurs, créez une extension et installez-la à l'aide
d'Extension Manager.

11

Remarque : Dans les anciens systèmes d'exploitation multi-utilisateur (Windows 98, Windows ME et Mac OS 9.x), tous
les utilisateurs partagent le même ensemble de fichiers de configuration de Dreamweaver.

L'emplacement du dossier Configuration de l'utilisateur dépend de la plate-forme employée par l'utilisateur.

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

disque dur:\Documents and Settings\

Remarque : Il se peut que ce dossier se trouve dans un dossier caché.

Les plates-formes Windows Vista utilisent l'emplacement suivant :

disque dur: \Users\

Les plates-formes MacOS X utilisent l'emplacement suivant :

disque dur: \Users/

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

nom d'utilisateur\AppData\Roaming\Adobe\Dreamweaver CS5\Configuration

nom d'utilisateur/Library/Application Support/Adobe/Dreamweaver CS5/Configuration

nom_utilisateur\Application Data\Adobe\Dreamweaver CS5\Configuration

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

Lorsque vous exécutez Dreamweaver pour la première fois, il ne copie que certains fichiers de configuration dans votre
dossier 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, Dreamweaver copie les fichiers de
configuration dans votre dossier Configuration utilisateur. Par exemple, Dreamweaver copie les fichiers lorsque vous
modifiez l'un des fragments de code prédéfinis dans le panneau Fragments de code. La version d'un fichier présente
dans le dossier Configuration utilisateur prime toujours sur celle du dossier Configuration de Dreamweaver. Pour
personnaliser un fichier de configuration, il doit se trouver dans le dossier Configuration de l'utilisateur. Si
Dreamweaver n'a pas déjà copié le fichier, copiez le fichier dans le dossier Configuration de l'utilisateur puis modifiez-le.

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.

Désactivation d'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.

12

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

3 Enregistrez et fermez mm_deleted_files.xml.

4 Lancez à nouveau Dreamweaver.

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.

Dans les descriptions de syntaxe des balises mm_deleted_files.xml ci-après, les attributs facultatifs dans les listes
d'attributs sont indiqués par des accolades(
obligatoires.

{}). Les attributs qui ne sont pas signalés ainsi sont considérés comme

<deleteditems>

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.

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

Conteneur

Aucun.

Exemple

<deleteditems>
<!-- item tags here -->
</deleteditems>

<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 (:).

13

Contenu

Aucun (balise vide).

Conteneur

Cette balise doit se trouver dans une balise

Exemple

<item name="snippets\headers\5columnwith4links.csn" />

deleteditems.

Réinstallation et désinstallation de Dreamweaver dans un environnement multi-utilisateur

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.

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

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.

Ajout d'informations relatives à une nouvelle extension de nom de fichier

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

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.

14

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.

Fichiers 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
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 :

documenttype, chacun d'entre eux définissant une collection prédéfinie de balises et d'attributs

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

15

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

ASP.NET C# ASP.NET-Csharp Dynamique aspx, ascx

ASP.NET VB ASP.NET-VB Dynamique aspx, ascx

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 ASP VBScript Modèle DW aspvb.dwt

Modèle ColdFusion Modèle DW cfm.dwt

Modèle HTML Modèle DW dwt

Modèle JSP Modèle DW jsp.dwt

antérieur

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

Texte Texte txt

EDML XML edml

TLD XML tld

VTML XML vtm, vtml

WML XML wml

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.

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

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.adobe.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" >
<title>

<loadString id="mmdocumenttypes_0title" />
</title>
<description>

<loadString id="mmdocumenttypes_0descr" />
</description>

</documenttype>
...

</documenttypes>

16

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 utilise pour le titre

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

de chaînes localisées » à la page 21.

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

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

Balise Attribut Obligatoire Description

17

documenttype

(root)

Oui Nœud parent.

id Oui Identificateur unique pour tous les fichiers de

définition de type de document.

servermodel Non Spécifie le modèle de serveur associé (casse prise en

compte). Les 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 développeurs d'extensions peuvent créer de
nouveaux modèles de serveur en complétant cette
liste.

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

fichiers 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 possibles :

Dynamique

DWExtension

DWTemplate (zones d'affichage spéciales)

HTML

HTML4

Text

XHTML1

(mode Code uniquement)

XML

(zones d'affichage spéciales)

(mode Code uniquement)

Tous les types de documents liés au serveur de
modèle sont associés à la valeur
HTML sont associés à

HTML. Les fichiers de script

Dynamic. Les fichiers

(notamment les fichiers .css, .js, .vb et .cs) sont associés

Text.

à

internaltype vaut DWTemplate, définissez la

Si

dynamicid. Dans le cas contraire, le panneau

valeur
Comportement de serveur ou Liaisons ne reconnaît
pas le nouveau modèle vierge créé par la boîte de
dialogue Nouveau document. Les instances de ce
modèle sont des modèles HTML.

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

Balise Attribut Obligatoire Description

18

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

winfileextension Oui Extension de nom de fichier associée au type de

macfileextension Oui Extension de nom de fichier associée au type de

document dynamique. Cet attribut n'est pertinent
que lorsque

DWTemplate. Il vous permet d'associer un modèle

dynamique avec un type de document dynamique.

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 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.

document sur Macintosh. 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 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.

internaltype correspond à

file Oui Le fichier situé dans le dossier

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

dialogue Nouveau document.

DocumentTypes/NewDocuments contenant le
contenu du modèle des nouveaux documents de type

documenttype.

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

Balise Attribut Obligatoire Description

19

priorversionservermodel Non Si le modèle serveur de ce document possède un

title

(sous-balise)

description

(sous-balise)

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

Non Chaîne de description du type de document. Vous

équivalent Dreamweaver UltraDev 4, spécifiez le nom
de l'ancienne version du modèle serveur.

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

sous la section Document vierge de la boîte de
dialogue Nouveau document. Vous pouvez insérer
cette 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 « Fourniture de chaînes localisées » à la
page 21.

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

pouvez insérer cette 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 « Fourniture de

chaînes localisées » à la page 21.

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
plate-forme actuelle qui sont associées avec le type de document (par exemple

macfileextension). Dreamweaver sélectionne la première chaîne de la liste pour l'utiliser comme l'extension de nom

winfileextension et

de fichier par défaut. Pour changer cette extension de nom de fichier par défaut, réorganisez les extensions de la liste
séparées par des virgules de 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 les fichiers de définition de type de document sont endommagés ou ne sont pas disponibles dans le dossier
Configuration/DocumentTypes, Dreamweaver se ferme en affichant un message d'erreur.

Définition de 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 :

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

<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>

20

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.

Ajout et modification d'extensions de documents et de types de fichiers

Par défaut, Dreamweaver affiche tous les types de fichiers reconnus dans la boîte de dialogue Fichier > Ouvrir. Après
avoir créé un type de document, le développeur d'une extension doit mettre à jour le fichier Extensions.txt approprié.
Il se peut que l'utilisateur emploie un système multi-utilisateur (comme Windows XP, Windows Vista ou MacOS X).
Dans de tel cas, il existe un autre fichier Extensions.txt dans le dossier Configuration de l'utilisateur. 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 de l'utilisateur dépend de la plate-forme employée par l'utilisateur.

La plate-forme Windows XP emploie l'emplacement suivant :

disque dur:\Documents and Settings\nom_utilisateur\Application Data\Adobe\Dreamweaver CS5\Configuration

Remarque : Il se peut que ce dossier se trouve dans un dossier caché.

La plate-forme Windows Vista emploie l'emplacement suivant :

disque dur:\Users\nom d'utilisateur\AppData\Roaming\Adobe\Dreamweaver CS5\Configuration

La plate-forme MacOS X utilise l'emplacement suivant :

disque dur:\Users/nom d'utilisateur/Library/Application Support/Adobe/Dreamweaver CS5/Configuration

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

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

Remarque : Sur une plate-forme multi-utilisateur, Dreamweaver analyse la copie du fichier Extensions.txt dans le
dossier Configuration de l'utilisateur, et pas celle qui se trouve dans son propre dossier Configuration. Dès lors, si vous
modifiez la copie du fichier Extensions.txt qui se trouve dans le dossier Configuration de Dreamweaver, Dreamweaver
n'est pas informé de ces modifications.

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

Ajout d'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.

Ajout d'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 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 déroulant des 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

21

4 Enregistrez le fichier Extensions.txt.

5 Redémarrez Dreamweaver.

Pour observer les modifications, choisissez Fichier > Ouvrir, puis cliquez sur le menu déroulant des types de fichiers.

Modification du 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 un éditeur de texte.

3 Coupez la ligne correspondant à la nouvelle valeur par défaut. Collez-la ensuite au début du fichier, de façon à ce

qu'elle devienne sa première ligne.

4 Enregistrez le fichier Extensions.txt.

5 Redémarrez Dreamweaver.

Pour observer les modifications, choisissez Fichier > Ouvrir, puis cliquez sur le menu déroulant des types de fichiers.

Voir aussi

http://www.adobe.com/go/16410_fr

Fourniture de 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
sous-balises comme 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

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

Fourniture de 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.adobe.com/schemes/data/string/">

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 d'une des façons suivantes :

<description>

<loadstring>myJSPDocType/Description</loadstring>

</description>

ou

<description>

<loadstring id="myJSPDocType/Description" />

</description>

22

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

<strings>

myJSPDocType/Description :

...

<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() » à la page 335.

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 ASP-JS. 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.

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

Définition des déclarations de document

Dreamweaver permet de définir des DTD pour les documents à l'aide du fichier MMDocumentTypeDeclarations.xml
qui se trouve dans le dossier Configuration/DocumentTypes. La liste de DTD disponibles et des documents auxquels
elles s'appliquent est définie dans le fichier

MMDocumentTypeDeclarations.xml.

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 UltraDev4, Dreamweaver charge le modèle de serveur UltraDev4 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
modèles de serveur (voir « canRecognizeDocument() » à la page 335). 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 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
renvoie une valeur égale, Dreamweaver affecte au document le type ASP-JS (puisque ASP-JS apparaît en premier
dans l'ordre alphabétique).

canRecognizeDocument() pour chacun des

canRecognizeDocument() respective

23

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 facultatifs
sont définis par des accolades (
obligatoires.

<panelset>

Description

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

Attributs

Aucun.

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

Dernière mise à jour le 22/6/2011

EXTENSION DE DREAMWEAVER

Personnalisation de Dreamweaver

Contenu

Cette balise peut contenir une ou plusieurs balises

application, document ou panelset.

Conteneur

Aucun.

Exemple

<panelset>

<!-- panelset tags here -->

</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 doit être agrandie au démarrage, et false dans

le cas contraire. La valeur par défaut est

true.

24

Contenu

Aucun.

Conteneur

Cette balise doit être imbriquée dans une balise

panelset.

Exemple

<panelset>

<application rect="0 0 1000 1200" maximize="false">
</application>

</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
prise en compte.

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

le cas contraire. La valeur par défaut est

true.

maximize est réglée sur true, la valeur rect n'est pas

Dernière mise à jour le 22/6/2011