Dream Weaver Cs4 Extending

Embed Size (px)

Citation preview

ADOBE DREAMWEAVER CS4

Extension

2008 Adobe Systems Incorporated. Tous droits rservs.Copyright

Extension d'Adobe Dreamweaver CS4 pour Windows et Mac OS Si le prsent guide est distribu avec un logiciel sous contrat de licence de lutilisateur final, ce guide, de mme que le logiciel dont il traite, est cd sous licence et ne peut tre copi ou utilis que conformment cette licence. Sauf autorisation spcifie dans la licence, aucune partie de cette publication ne peut tre reproduite, enregistre sur un systme de recherche ou transmise sous quelque forme ou par quelque moyen que ce soit (enregistrement lectronique, mcanique ou autre), sans lautorisation crite pralable dAdobe Systems Incorporated. Notez que le contenu de ce manuel est protg par des droits dauteur, mme sil nest pas distribu avec un logiciel accompagn dun contrat de licence pour lutilisateur final. Les informations contenues dans ce guide sont fournies titre informatif uniquement ; elles sont susceptibles dtre modifies sans pravis et ne doivent pas tre interprtes comme tant un engagement de la part dAdobe Systems Incorporated. Adobe Systems Incorporated naccepte aucune responsabilit quant aux erreurs ou inexactitudes pouvant tre contenues dans le prsent guide. Nous attirons votre attention sur le fait que les illustrations ou images que vous pouvez tre amen incorporer vos projets peuvent tre protges par des droits dauteur. Linclusion non autorise de tels lments dans vos nouveaux travaux peut constituer une violation des droits du dtenteur du copyright. Veuillez vous assurer que vous obtenez toute autorisation ncessaire auprs du dtenteur du copyright. Toute rfrence des noms de socits dans les modles types nest utilise qu titre dexemple et ne fait rfrence aucune socit relle. Adobe, the Adobe logo, ActionScript, ColdFusion, Dreamweaver, Fireworks, Flash, Flex Builder, HomeSite, JRun, Macromedia, Photoshop, and UltraDev are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Apple and Macintosh are trademarks of Apple Inc., registered in the United States and other countries. Java is a trademark or registered trademark of Sun Microsystems, Inc. in the United States and other countries. ActiveX, Microsoft, and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. This work is licensed under the Creative Commons Attribution Non-Commercial 3.0 License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc/3.0/us/ This product includes software developed by the Apache Software Foundation (http://www.apache.org/). The Graphics Interchange Format is the Copyright property of CompuServe Incorporated. GIF is a Service Mark property of CompuServe Incorporated. MPEG Layer-3 audio compression technology licensed by Fraunhofer IIS and Thomson Multimedia (http://www.mp3licensing.com). You cannot use the MP3 compressed audio within the Software for real time or live broadcasts. If you require an MP3 decoder for real time or live broadcasts, you are responsible for obtaining this MP3 technology license. Speech compression and decompression technology licensed from Nellymoser, Inc. (www.nellymoser.com). Video in Flash Player is powered by On2 TrueMotion video technology. 1992-2005 On2 Technologies, Inc. All Rights Reserved. http://www.on2.com. This product includes software developed by the OpenSymphony Group (http://www.opensymphony.com/) Sorenson Spark video compression and decompression technology licensed from Sorenson Media, Inc. The Proximity/Merriam-Webster Inc./Franklin Electronic Publishers Inc. Database 1990/1994 Merriam-Webster Inc./Franklin Electronic Publishers Inc., 1994. All Rights Reserved. Proximity Technology Inc. The Proximity/Merriam-Webster Inc./Franklin Electronic Publishers Inc. 1990 Williams Collins Sons & Co. Ltd. 1997 - All rights reserved Proximity Technology Inc. 1990 Williams Collins Sons & Co. Ltd. 1990 - All rights reserved Proximity Technology Inc. Oxford University Press 2000. All rights reserved Proximity Technology Inc. 1990 IDE a.s. 1990 - All rights reserved Proximity Technology Inc. This product includes software developed by Fourthought, Inc. (http://www.fourthought.com). This product includes software developed by CollabNet (http://www.Collab.Net/). Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA. Notice to U.S. Government End Users. The Software and Documentation are Commercial Items, as that term is defined at 48 C.F.R. 2.101, consisting of Commercial Computer Software and Commercial Computer Software Documentation, as such terms are used in 48 C.F.R. 12.212 or 48 C.F.R. 227.7202, as applicable. Consistent with 48 C.F.R. 12.212 or 48 C.F.R. 227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, USA. For U.S. Government End Users, Adobe agrees to comply with all applicable equal opportunity laws including, if appropriate, the provisions of Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment Assistance Act of 1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 60-1 through 60-60, 60-250, and 60-741. The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference.

iii

SommaireChapitre 1 : Introduction A propos des extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Installation d'une extension Cration d'une extension ............................................................................................ 1 .............................................................................................. 2 ............................................................ 2 ........................................................................ 2

Ressources supplmentaires pour les crateurs d'extensions Nouvelles fonctionnalits de Dreamweaver CS4 Conventions utilises dans ce manuel

.................................................................................. 3

Chapitre 2 : Personnalisation de Dreamweaver Techniques de personnalisation de Dreamweaver Modification des mappages FTP Modification des raccourcis clavier

...................................................................... 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Personnalisation de Dreamweaver dans un environnement multi-utilisateur Types de documents extensibles dans Dreamweaver

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Chapitre 3 : Personnalisation du mode Code A propos des indicateurs de code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 A propos de la coloration du code A propos de la validation du code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Modification du formatage HTML par dfaut A propos du mode Fractionnement vertical A propos des fichiers apparents A propos de l'affichage en direct

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Chapitre 4 : Extension de Dreamweaver Types d'extensions Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 Extensions et dossiers de configuration API d'extension Localisation d'une extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Utilisation d'Extension Manager

Chapitre 5 : Interfaces utilisateur destines aux extensions Instructions de conception d'une interface utilisateur d'extension Commande de rendu HTML de Dreamweaver Ajout de contenu Flash Dreamweaver

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

Commandes d'interface utilisateur personnalises dans les extensions Intgration de Photoshop et d'objets dynamiques

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Chapitre 6 : Modle d'objet de document (DOM) Dreamweaver A propos du DOM de Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 Distinction entre les DOM de document utilisateur et d'extension DOM Dreamweaver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

EXTENSION DE DREAMWEAVER CS4 ivSommaire

Chapitre 7 : Objets de la barre Insertion Fonctionnement des fichiers d'objet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Fichier de dfinition de la barre Insertion Modification de la barre Insertion Fonction de l'API des objets Exemple simple d'insertion d'un objet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

Chapitre 8 : API de vrification des problmes de compatibilit du navigateur Procdure de dtection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 Exemple de fichiers de problmes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Fonctions de l'API de vrification des problmes Chapitre 9 : Commandes Fonctionnement des commandes Exemple de commande simple

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

Ajout de commandes au menu Commandes Fonctions de l'API des commandes

Chapitre 10 : Menus et commandes de menu Fichier menus.xml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 Modification des menus et des commandes de menu Commandes de menu Exemple de commande de menu simple Exemple de menu dynamique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

Fonctions de l'API des commandes de menu Chapitre 11 : Barres d'outils Fonctionnement des barres d'outils

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181

Fichier simple de commande de barre d'outils Fichier de dfinition de la barre d'outils Balises d'lments de barre d'outils Attributs des balises d'lments

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

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

Chapitre 12 : Rapports Rapports de site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204 Rapports autonomes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 Fonctions de l'API de rapports

Chapitre 13 : Bibliothques et diteurs de balises Format de fichier bibliothque de balises . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213 Slecteur de balises . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223 Exemple simple de cration d'un diteur de balise Fonctions de l'API de l'diteur de balises

Chapitre 14 : Inspecteurs Proprits Fichiers d'inspecteur Proprits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226 Fonctionnement des fichiers d'inspecteur Proprits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227

EXTENSION DE DREAMWEAVER CS4 vSommaire

Exemple simple d'inspecteur Proprits

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

Fonctions de l'API de l'inspecteur Proprits

Chapitre 15 : Panneaux flottants Fonctionnement des fichiers de panneau flottant Exemple de panneau flottant simple Fonctions de l'API du panneau flottant Chapitre 16 : Comportements Fonctionnement des comportements Exemple de comportement simple Fonction de l'API des comportements

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

Chapitre 17 : Comportements de serveur Terminologie des comportements de serveur Architecture de Dreamweaver Exemple de comportement de serveur simple API de comportement de serveur Fichiers EDML

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260

Scnarios dans lesquels les fonctions de l'API de comportement de serveur sont appeles Fonctions d'implmentation des comportements de serveur Balises de fichiers EDML Groupe Fichiers EDML Participant

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

Techniques de comportements de serveur Chapitre 18 : Sources de donnes Fonctionnement des sources de donnes Exemple simple de source de donnes Fonctions de l'API des sources de donnes Chapitre 19 : Formats de serveur Fonctionnement du formatage de donnes Fonctions de l'API des formats de serveur

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321

Scnarios dans lesquels les fonctions de formatage des donnes sont appeles

Chapitre 20 : Composants A propos des notions de base des composants Extension du panneau Composants Personnalisation du panneau Composants Fonctions de l'API du panneau Composants Chapitre 21 : Modles de serveur Personnalisation des modles de serveur Fonctions de l'API des modles de serveur

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328

Personnalisation des fichiers du panneau Composants

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338

Chapitre 22 : Traducteurs de donnes Fonctionnement des traducteurs de donnes Dtermination du type de traducteur utiliser

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

EXTENSION DE DREAMWEAVER CS4 viSommaire

Ajout d'un attribut traduit une balise Inspection des attributs traduits

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347

Verrouillage des balises ou des blocs de code traduits Recherche de bogues dans le traducteur Exemple de traducteur d'attributs simple

Cration d'inspecteurs Proprits pour du contenu verrouill

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

Exemple de traducteur de blocs/balises simple Fonctions de l'API du traducteur de donnes Chapitre 23 : Extensions C Intgration des fonctions C Types de donnes API d'extension C

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366

Extensions C et interprteur JavaScript

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382

API de configuration multi-utilisateur et d'accs aux fichiers Appel d'une fonction C partir de JavaScript

Chapitre 24 : Dossier Shared Contenu du dossier Shared . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384 Utilisation du dossier Shared Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391

1

Chapitre 1 : IntroductionCe guide dcrit l'API (interface de programmation d'application) et la plate-forme Adobe Dreamweaver CS4 qui vous permettent des crer des extensions de Dreamweaver. Le guide Extension de Dreamweaver CS4 fournit des informations sur les thmes suivants :

la faon dont chaque type d'extension fonctionne ; les fonctions d'API que Dreamweaver appelle pour mettre en oeuvre les diffrents objets ; les menus, panneaux flottants, comportements de serveur, etc. qui constituent les fonctionnalits de Dreamweaver ; un exemple simple de chaque type d'extension ; la faon de personnaliser Dreamweaver en modifiant des balises dans divers fichiers HTML et XML, afin d'ajouterdes commandes ou des types de documents. Pour plus d'informations sur l'utilit et les possibilits offertes par les API JavaScript, utilisables pour effectuer diverses oprations dans vos extensions Dreamweaver, consultez le Guide des API de Dreamweaver. Si vous envisagez de crer des extensions fonctionnant avec des bases de donnes, consultez les sections du manuel Utilisation de Dreamweaver consacres aux connexions de bases de donnes.

A propos des extensionsLa plupart des extensions Dreamweaver sont rdiges en langage HTML et en langage JavaScript. Les instructions prsentes ici supposent que vous possdez une bonne matrise des lments suivants : Dreamweaver et programmation JavaScript, HTML et XML. Par ailleurs, si vous implmentez des extensions C, vous devez savoir comment crer et utiliser des bibliothques de liens dynamiques (DLL) C. Pour rdiger vos propres extensions afin de crer des applications Web, vous devez connatre les langages de script ct 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 extensionPour vous familiariser avec la procdure de rdaction 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 dcouvrir quelques-uns des outils qui vous seront utiles pour travailler avec vos propres extensions.1 Tlchargez et installez Adobe Extension Manager, qui est disponible sur le site de tlchargement 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 Slectionnez l'extension que vous souhaitez rcuprer parmi celles disponibles. Cliquez sur le lien de

tlchargement pour tlcharger 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 > Grer les extensions pour lancer Extension Manager.

EXTENSION DE DREAMWEAVER CS4 2Introduction

Extension Manager installe automatiquement l'extension dans Dreamweaver, depuis le dossier Downloaded Extensions. Il est ncessaire de redmarrer Dreamweaver avant de pouvoir utiliser certaines extensions. Si Dreamweaver est en cours d'excution pendant l'installation de l'extension, il vous sera peut-tre demand de fermer et de redmarrer 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 > Grer les extensions).

Cration d'une extensionAvant de crer une extension Dreamweaver, consultez le site Web Adobe Exchange (http://www.adobe.com/go/exchange_fr) pour dterminer si l'extension crer existe dj. Si aucune extension existante ne rpond vos besoins, procdez comme suit pour en crer une :

Dterminez le type d'extension crer. Pour plus d'informations sur les types d'extensions, voir Typesd'extensions Dreamweaver la page 80.

Recherchez dans la documentation le type d'extension que vous souhaitez crer. Pour vous familiariser avec laprocdure de cration du type d'extension requis, il est recommand de crer l'exemple simple d'extension en vous reportant la rubrique correspondante.

Dterminez les fichiers modifier ou crer. Le cas chant, effectuez des prparatifs concernant l'interface utilisateur requise pour l'extension. Crez les fichiers requis et enregistrez-les dans les dossiers appropris. Redmarrez 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 87.

Ressources supplmentaires pour les crateurs d'extensionsPour entrer en contact avec d'autres dveloppeurs 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 fonctionnalits de Dreamweaver CS4Dreamweaver CS4 comprend les nouvelles fonctionnalits et interfaces extensibles suivantes.

Affichage et modification de pages Web l'aide de la fonctionnalit Fichiers apparents Affichage des pages Web telles qu'elles seront rendues dans un navigateur Web l'aide de la fonctionnalitAffichage en direct

EXTENSION DE DREAMWEAVER CS4 3Introduction

Affichage des modes Code et Cration des pages HTML cte cte l'aide du mode d'affichage Fractionnementvertical

Affichage des messages d'erreur sans interruption du flux d'activits Mise jour des images source sans ouvrir Adobe Photoshop, l'aide des objets dynamiques Photoshopchacune de ces fonctionnalits possde de nouvelles fonctions apparentes qui ont t ajoutes l'API d'utilitaire et l'API JavaScript. Pour plus d'informations sur les nouvelles fonctions, voir le Guide des API de Dreamweaver. Centre de documentation Approfondissez votre connaissance de Dreamweaver grce aux ouvrages publis par Adobe. Consultez le contenu le plus rcent et rdig par des experts sur http://www.adobe.com/support/documentation/buy_books.html. Fonctions supprimes Diverses fonctions ont t supprimes de Dreamweaver. Pour plus d'informations sur les fonctions limines de l'API d'utilitaire et de l'API JavaScript, voir le Guide des API de Dreamweaver.

Conventions utilises dans ce manuelCe 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 nomsde mthodes, 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 lments remplaables dans le code.

Le symbole de continuation () indique qu'une longue ligne de code a t fractionne sur deux lignes ou plus. Enraison des limites de marge du format de ce manuel, une ligne de code continue doit ici tre coupe. Lorsque vous copiez les lignes de code, supprimez le symbole de continuation et entrez-les comme une seule ligne.

Les accolades ({ }) places avant et aprs un argument de fonction indiquent que cet argument est facultatif. Les noms de fonction portant le prfixe dreamweaver. (comme dans dreamweaver.nomfonc) peuvent treabrgs en dw.nomfonc lorsque vous crivez le code. Ce manuel utilise le prfixe dreamweaver. complet dans les dfinitions de fonctions et dans l'index. De nombreux exemples utilisent nanmoins le prfixe court (dw.). Ce manuel utilise les conventions de dnomination suivantes :

Vous le dveloppeur responsable de la rdaction des extensions L'utilisateur la personne utilisant Dreamweaver Le visiteur la personne qui visualise la page Web cre par l'utilisateur

4

Chapitre 2 : Personnalisation de DreamweaverOutre crer et utiliser des extensions Adobe Dreamweaver , vous pouvez personnaliser Dreamweaver de diffrentes manires afin de l'adapter au mieux vos besoins.

Techniques de personnalisation de DreamweaverVous pouvez personnaliser Dreamweaver en employant plusieurs mthodes gnrales. Certaines sont prsentes dans Utilisation de Dreamweaver. Vous pouvez dfinir des prfrences dans divers domaines, comme l'accessibilit, la coloration de code, les polices, la mise en surbrillance et l'aperu dans les navigateurs, par l'intermdiaire du panneau Prfrences (Edition > Prfrences ou Dreamweaver > Prfrences (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.

Personnalisation des documents par dfautLe dossier DocumentTypes/NewDocuments contient, par dfaut, un document (vierge) de chaque type de document que vous pouvez crer l'aide de Dreamweaver. Lorsque vous crez un nouveau document vierge en slectionnant Fichier > Nouveau et en slectionnant un lment dans les listes Page de base, Page dynamique ou Autres catgories, Dreamweaver base le nouveau document sur le document par dfaut correspondant dans ce dossier. Pour modifier les lments par dfaut 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 lments communs (par exemple une mention sur le copyright) ou une prsentation constante, il est prfrable d'utiliser des modles et des lments de bibliothque plutt que de changer les documents par dfaut. Pour plus d'informations sur les modles et les lments de bibliothque, voir Utilisation de Dreamweaver.

Personnalisation des conceptions de pagesDreamweaver propose divers lments prdfinis: feuilles de style CSS, jeux de cadres et conceptions de pages. Vous pouvez crer des pages bases sur ces conceptions en cliquant sur Fichier > Nouveau. Pour personnaliser les conceptions disponibles, modifiez les fichiers prsents dans les dossiers BuiltIn/css, BuiltIn/framesets, BuiltIn/Templates et BuiltIn/TemplatesAccessible Remarque : Les conceptions rpertories dans les catgories Conception de page et Conception de page (Accessibilit) sont les fichiers modles de Dreamweaver. Pour plus d'informations sur les modles, voir Utilisation de Dreamweaver. Vous pouvez galement crer 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 bote de dialogue Nouveau document, crez un fichier Design Notes (dans le dossier _notes appropri) correspondant au fichier de conception de page.

EXTENSION DE DREAMWEAVER CS4 5Personnalisation de Dreamweaver

Personnalisation de l'aspect des botes de dialogueLa mise en forme des botes de dialogue pour les objets, les commandes et les comportements sont dfinis comme des formulaires HTML. Ils rsident dans des fichiers HTML du dossier Configuration au sein du dossier d'application Dreamweaver. Ces formulaires peuvent tre modifis comme tout autre formulaire Dreamweaver. Pour plus d'informations, voir Utilisation de Dreamweaver. Remarque : Dans le cadre d'un systme d'exploitation multi-utilisateur, vous devez modifier les copies des fichiers de configuration contenues dans votre dossier de configuration utilisateur plutt que les fichiers Configuration de Dreamweaver. Pour plus d'informations, voir Dossiers de configuration multi-utilisateur la page 83. Modification de l'aspect d'une bote de dialogue 1 Dans Dreamweaver, choisissez Edition > Prfrences, puis la catgorie Correction du code.2 Dslectionnez l'option Renommer les lments de formulaire lors du collage.

Cette opration vous assure que les lments de formulaire conserveront leur nom original une fois ceux-ci copis et colls.3 Cliquez sur OK pour fermer la bote de dialogue Prfrences. 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 Redmarrez Dreamweaver pour constater les changements.

Il est recommand de ne modifier que l'aspect de la bote de dialogue et non son fonctionnement. Le type des lments de formulaire doit tre identique, tout comme les noms, afin que l'information obtenue par Dreamweaver partir de la bote de dialogue puisse tre utilise de la mme manire. Par exemple, l'objet Commentaire prend le texte entr dans une zone de texte de bote de dialogue et utilise une fonction JavaScript simple pour transformer ce texte en commentaire HTML et l'insrer dans votre document. Le formulaire qui dcrit la bote 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 intgralement 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 dfautPar dfaut, Dreamweaver affiche tous les types de fichiers reconnus dans la bote de dialogue Fichier > Ouvrir. Vous pouvez utiliser un menu contextuel dans cette bote de dialogue pour limiter l'affichage de certains types de fichiers. Si la plupart de vos travaux impliquent un type de fichier spcifique (par exemple, les fichiers ASP), vous pouvez modifier l'affichage par dfaut. Le type de fichier indiqu sur la premire ligne du fichier Extensions.txt de Dreamweaver devient le type par dfaut. Remarque : Pour afficher tous les types de fichiers dans la bote 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 rpertorie uniquement les fichiers que Dreamweaver peut ouvrir.

EXTENSION DE DREAMWEAVER CS4 6Personnalisation de Dreamweaver

Modification du type de fichier par dfaut de Dreamweaver dans Fichier > Ouvrir 1 Crez 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 dfaut. Collez-la ensuite au dbut du fichier, de faon ce

qu'elle devienne sa premire ligne.4 Enregistrez le fichier. 5 Redmarrez Dreamweaver.

Pour afficher le nouveau type par dfaut, choisissez Fichier > Ouvrir, puis examinez le menu contextuel de types de fichiers. Ajout de nouveaux types de fichier dans le menu de la bote de dialogue Fichier > Ouvrir 1 Crez 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

gres par le nouveau type de fichier, en les sparant par une virgule. Ajoutez le signe deux points et une brve description, qui apparatra dans le menu contextuel de types de fichiers associ la bote de dialogue qui s'affiche lorsque vous slectionnez Fichier > Ouvrir. Par exemple, pour les fichiers JPEG, entrez JPG,JPEG,JFIF:Fichiers image JPEG4 Enregistrez le fichier. 5 Redmarrez Dreamweaver.

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

Personnalisation de l'interprtation de balises propritairesLes technologies ct serveur telles que ASP, Adobe ColdFusion, JSP et PHP utilisent du code spcial non-HTML au sein des fichiers HTML. Les serveurs crent 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 propritaires, lesquels dfinissent 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 interprter. Le code ASP ressemble une balise HTML mais est marqu par une paire de dlimiteurs : il commence par . Le dossier Configuration/ThirdPartyTags de Dreamweaver contient un fichier nomm Tags.xml. Ce fichier dcrit le format des diverses balises propritaires, dont le code ASP, et dcrit comment Dreamweaver doit afficher ce code. La faon dont le code ASP est spcifi dans le fichier Tags.xml conduit Dreamweaver ne pas tenter d'interprter le code situ entre les dlimiteurs. A la place, en mode Cration, seule une icne indiquant la prsence de code ASP s'affiche. Vos propres fichiers de donnes de balises peuvent dfinir l'affichage et la lecture de vos balises par Dreamweaver. Crez un nouveau fichier de donnes de balises pour chaque jeu de balises afin d'indiquer Dreamweaver comment les afficher. Remarque : Cette section vous explique comment dfinir l'affichage d'une balise personnalise par Dreamweaver, mais ne dcrit pas comment modifier le contenu ou les proprits d'une balise personnalise. Pour plus d'informations sur la cration d'un inspecteur Proprits permettant de vrifier et modifier les proprits d'une balise personnalise, voir Inspecteurs Proprits la page 226.

EXTENSION DE DREAMWEAVER CS4 7Personnalisation de Dreamweaver

Chaque fichier de donnes de balises dfinit le nom, le type, le modle de contenu, le modle de rendu et l'icne pour une ou plusieurs balises. Vous pouvez crer un nombre illimit de fichiers de donnes de balises, mais tous doivent se trouver dans le dossier Configuration/ThirdPartyTags afin d'tre consults et traits par Dreamweaver. Les fichiers de donnes de balises portent l'extension .xml. Si vous travaillez sur plusieurs sites distincts la fois (par exemple, en tant que dveloppeur indpendant), vous pouvez regrouper toutes les spcifications de balises relatives un site dans un fichier. Il suffit ensuite de remettre ce fichier de donnes de balises avec les icnes personnalises et les inspecteurs Proprits aux responsables qui greront le site. Vous pouvez dfinir une spcification de balise l'aide d'une balise XML nomme tagspec. Par exemple, le code suivant dcrit les spcifications d'une balise nomme happy :

Vous pouvez dfinir deux types de balises l'aide de tagspec :

Balises de type HTML standardhappy est un exemple de balise de type HTML standard. Elle dbute par une balise d'ouverture , des

donnes sont places entre les balises d'ouverture et de fermeture, et elle se termine par une balise de fermeture.

Balises dlimites par des chanesLes balises dlimites par des chanes dbutent par une chane et se terminent par une autre chane. Elles se comportent comme des balises HTML vides (telle img), car elles n'entourent pas les donnes de balises et ne comportent pas de balises de fermeture. Si la balise happy tait dlimite par des chanes, les spcifications de balises incluraient les attributs start_string et end_string. Une balise ASP est une balise dlimite par des chanes. Elle commence par la chane , sans balise de fermeture. Les informations suivantes dcrivent les attributs et les valeurs valides de la balise tagspec. Les attributs marqus d'un astrisque (*) sont ignors dans le cadre des balises dlimites par des chanes. Les attributs facultatifs sont dfinis par des accolades ({}) dans la liste des attributs ; les attributs ne comportant pas d'accolades sont donc obligatoires.

Description Fournit des informations propos d'une balise propritaire. Attributstag_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 personnalise. Pour les balises dlimites par des chanes, tag_name n'est utilis

que pour dterminer si un inspecteur Proprits donn peut tre utilis pour la balise. Si la premire ligne de l'inspecteur Proprits contient ce nom de balise encadr par des astrisques, 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 Proprits pouvant examiner le code ASP doivent comporter la mention *ASP* sur la premire ligne. Pour plus d'informations sur l'inspecteur Proprits API, voir Inspecteurs Proprits la page 226.

EXTENSION DE DREAMWEAVER CS4 8Personnalisation de Dreamweaver

tag_type dtermine si la balise est vide (telle que img) ou si un contenu est prsent entre les balises d'ouverture et de fermeture (telles que code). Cet attribut est requis pour les balises normales (non dlimites par des chanes). Il est ignor pour les balises dlimites par des chanes, car celles-ci sont toujours vides. Les valeurs valides sont "empty" et "nonempty". render_contents dtermine si le contenu de la balise doit s'afficher en mode Cration ou s'il est remplac par

l'icne spcifie. 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 affiches hors des attributs. Le contenu des balises imbriques l'intrieur des valeurs d'attributs d'autres balises n'est pas affich. Les valeurs valides sont "true" et "false".

content_model dcrit les diffrents 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 "block_model", "head_model", "marker_model" et "script_model".

block_model spcifie que la balise peut contenir des lments de niveau de bloc comme div et p et que la balise

peut apparatre uniquement dans la section body ou dans d'autres balises au contenu body, telles que div, layer et td.

head_model spcifie que le contenu de la balise peut tre compos de texte et que la balise peut uniquement

apparatre dans la section head.marker_model spcifie 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 spcifies comme marker_model. Nanmoins, le validateur n'ignore pas le contenu de ces balises. En consquence, mme si la balise peut apparatre n'importe quel emplacement, le contenu de la balise peut corrompre le document HTML certains endroits. Par exemple, du texte simple ne peut apparatre dans la section head d'un document ( l'exception des lments 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 personnalise dans la section head, dfinissez le modle de contenu de la balise comme head_model au lieu de marker_model. Utilisez marker_model pour les balises qui doivent s'afficher en ligne (dans un lment de niveau de bloc, comme p ou div, par exemple, dans un paragraphe). N'utilisez pas ce modle si la balise doit tre affiche seule dans un paragraphe, encadre par des sauts de ligne.

script_model permet un emplacement libre de la balise entre les balises d'ouverture et de fermeture d'undocument. Lorsque Dreamweaver rencontre une balise de ce modle, 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 spcifie un dlimiteur qui marque le dbut d'une balise dlimite par des chanes. Les balises dlimites par des chanes peuvent tre prsentes en tout point du document pouvant contenir un commentaire. Dreamweaver n'analyse pas les balises et ne dcode pas les entits ou URL comprises entre start_string et end_string. Cet attribut est requis si end_string est spcifi. end_string spcifie un dlimiteur qui marque la fin d'une balise dlimite par une chane. Cet attribut est requis

si start_string est spcifi.detect_in_attribute indique si les lments contenus entre start_string et end_string (ou entre les balises d'ouverture et de fermeture si ces chanes ne sont pas dfinies) doivent tre ignors mme si ces chanes apparaissent dans les valeurs ou noms d'attributs. Vous devez gnralement rgler la valeur sur "true" pour les balises dlimites par des chanes. La valeur par dfaut est "false". Ainsi, les balises ASP sont parfois imbriques dans des valeurs d'attributs et contiennent parfois des guillemets ("). Parce que la balise ASP spcifie detect_in_attribute="true", Dreamweaver ne tient pas compte des balises ASP, y compris des guillemets internes, lorsqu'elles sont imbriques dans des valeurs d'attributs.

EXTENSION DE DREAMWEAVER CS4 9Personnalisation de Dreamweaver

parse_attributes indique si les attributs de la balise doivent tre analyss. Si la valeur dfinie est "true" (par dfaut), Dreamweaver analyse les attributs. Si elle est dfinie sur "false", Dreamweaver ignore tous les lments jusqu'au crochet situ hors des guillemets. Par exemple, cet attribut doit tre rgl sur "false" pour les balises telles que cfif (par exemple, , que Dreamweaver ne peut pas analyser comme ensemble de paires nom d'attribut/valeur). icon spcifie le chemin et le nom de fichier de l'icne associe 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 fentre de document en mode Cration. icon_width spcifie la largeur de l'icne en pixels. icon_height spcifie la hauteur de l'icne en pixels. equivalent_tag spcifie des quivalents HTML simples pour certaines balises lies 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 spcifie

aucune valeur pour is_visual ; la valeur par dfaut "true" est donc applique. La valeur is_visual de la balise ColdFusion cfset est dfinie sur false. La visibilit des balises de marquage de serveur est contrle par la catgorie Elments invisibles dans la bote de dialogue Prfrences. La visibilit des balises de marquage de serveur visuel peut tre dfinie indpendamment de celle des balises de marquage de serveur non visuel.

server_model, si spcifi, indique que la balise tagspec s'applique uniquement aux pages appartenant au modle de serveur spcifi. Si server_model n'est pas spcifi, la balise tagspec s'applique toutes les pages. Par exemple, les dlimiteurs des balises ASP et JSP sont identiques, mais la balise tagspec pour JSP spcifie un paramtre server_model dfini sur "JSP". Par consquent, lorsque Dreamweaver rencontre ce code avec les dlimiteurs adquats sur une page JSP, il affiche une icne JSP. Lorsque ce code est rencontr sur une page autre qu'une page JSP, une icne ASP s'affiche.

Contenu Aucun (balise vide). Contenant Aucun. Exemple

Affichage des balises personnalises dans le mode CrationL'affichage des balises personnalises dans la fentre de document en mode Cration dpend des valeurs entres pour les attributs tag_type et render_contents de la balise tagspec. Si la valeur de tag_type est "empty", l'icne spcifie dans l'attribut icon s'affiche. Si la valeur de tag_type est "nonempty" mais que la valeur de render_contents est "false", l'icne s'affiche de la mme faon que pour une balise vide. L'exemple suivant indique comment une instance de la balise happy dfinie antrieurement peut apparatre dans le code HTML :This is a paragraph that includes an instance of the happy tag (Joe).

Dans la mesure o render_contents est rgl sur "false" dans la spcification de balise, le contenu de la balise happy (le mot Joe) ne s'affiche pas. Les balises de dbut et de fin et leur contenu sont alors remplacs par une icne unique.

EXTENSION DE DREAMWEAVER CS4 10Personnalisation de Dreamweaver

Pour les balises nonempty dont la valeur render_contents est rgle sur "true", l'icne ne s'affiche pas en mode Cration. C'est le contenu insr entre les balises d'ouverture et de fermeture qui s'affiche (par exemple, le texte contenu entre les balises dans Ceci est le contenu insr entre les balises d'ouverture et de fermeture). Si l'option Affichage > Elments invisibles est active, le contenu est mis en surbrillance l'aide de balises propritaires, comme spcifi dans les prfrences de surbrillance (la mise en surbrillance ne s'applique qu'aux balises dfinies dans les fichiers de donnes de balises). Modification de la couleur de surbrillance des balises propritaires 1 Choisissez Edition > Prfrences, puis la catgorie Surbrillance.2 Cliquez sur la zone de slection de couleurs de balises propritaires pour afficher le slecteur de couleur. 3 Slectionnez une couleur, puis cliquez sur OK pour fermer la bote de dialogue Prfrences. Pour plus

d'informations sur la slection d'une couleur, voir Utilisation de Dreamweaver.

Prvention de la correction de balises propritairesDreamweaver corrige certains types d'erreurs dans le code HTML. Pour plus d'informations, voir Utilisation de Dreamweaver. Par dfaut, Dreamweaver vite toute modification du code HTML dans les fichiers portant certaines extensions, comme .asp (ASP), .cfm (ColdFusion), .jsp (JSP) et .php (PHP). Ce paramtre est dfini pour viter toute modification accidentelle du code contenu dans de telles balises non-HTML. Vous pouvez modifier le comportement de correction de Dreamweaver par dfaut 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 caractres spciaux en les remplaant par des valeurs numriques lorsque vous les entrez dans l'inspecteur Proprits. Il est normalement prfrable de laisser Dreamweaver effectuer cet encodage, car les caractres spciaux seront ainsi reconnus par un nombre plus important de plates-formes et de navigateurs. Nanmoins, cette opration d'encodage peut interfrer avec les balises propritaires. Vous pouvez donc modifier le comportement de Dreamweaver concernant l'encodage des balises lorsque vous travaillez avec des fichiers comportant des balises propritaires. Permettre Dreamweaver de corriger le code HTML dans plus de types de fichiers 1 Choisissez Edition > Prfrences, puis la catgorie Correction du code.2 Slectionnez l'une des options suivantes :

Corriger les balises incorrectement imbriques et non fermes Supprimer les balises de fermeture superflues3 Effectuez l'une des oprations suivantes :

Supprimez une ou plusieurs extensions de la liste d'extensions dans l'option Ne jamais corriger le code : Dansles fichiers avec extensions.

Dsactivez l'option Ne jamais corriger le code : Dans les fichiers avec extensions. La dsactivation de cette optionpermet Dreamweaver de rcrire le code HTML dans tous types de fichiers. Ajout de fichiers dans lesquels Dreamweaver ne doit pas apporter de corrections1 Choisissez Edition > Prfrences, puis la catgorie Correction du code. 2 Slectionnez l'une des options suivantes :

Corriger les balises incorrectement imbriques et non fermes Supprimer les balises de fermeture superflues

EXTENSION DE DREAMWEAVER CS4 11Personnalisation de Dreamweaver

3 Assurez-vous que l'option Ne jamais corriger le code: Dans les fichiers avec extensions est slectionne. 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 bote 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 dfaut la page 5. Dsactivation des options d'encodage de Dreamweaver 1 Choisissez Edition > Prfrences, puis la catgorie Correction du code.2 Dslectionnez les options de caractres spciaux de votre choix.

Pour plus d'informations sur les autres prfrences de correction de code, voir Utilisation de Dreamweaver.

Personnalisation de Dreamweaver dans un environnement multi-utilisateurVous pouvez personnaliser Dreamweaver sous un systme d'exploitation multi-utilisateur tel que Microsoft Windows XP, Windows Vista ou Mac OS X. Aucune configuration personnalise de Dreamweaver ne peut affecter celle d'un autre utilisateur. Lorsque vous excutez pour la premire fois Dreamweaver sous un systme d'exploitation multi-utilisateur, Dreamweaver copie les fichiers de configuration dans un dossier Configuration utilisateur. Lorsque vous personnalisez Dreamweaver l'aide des panneaux et botes 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 dj des fichiers de configuration utilisateur ne seront pas concerns par ces modifications. Pour apporter des modifications qui influeront sur tous les utilisateurs, crez une extension et installez-la l'aide d'Extension Manager. Remarque : Dans les anciens systmes d'exploitation multi-utilisateur (Windows 98, Windows ME et Mac OS 9.x), tous les utilisateurs partagent le mme ensemble de fichiers de configuration de Dreamweaver. L'emplacement du dossier Configuration de l'utilisateur dpend de la plate-forme employe par l'utilisateur. Les plates-formes Windows XP utilisent l'emplacement suivant : disque dur:\Documents and Settings\nom_utilisateur\Application Data\Adobe\Dreamweaver CS4\Configuration 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\nom d'utilisateur\AppData\Roaming\Adobe\Dreamweaver CS4\Configuration Les plates-formes MacOS X utilisent l'emplacement suivant : disque dur: \Users/nom d'utilisateur/Library/Application Support/Adobe/Dreamweaver CS4/Configuration Remarque : Pour installer des extensions accessibles tous les utilisateurs dans un systme d'exploitation multiutilisateur, vous devez disposer des droits de niveau Administrateur (Windows) ou root (MacOS X).

EXTENSION DE DREAMWEAVER CS4 12Personnalisation de Dreamweaver

Lorsque vous excutez Dreamweaver pour la premire fois, il ne copie que certains fichiers de configuration dans votre dossier Configuration utilisateur. (les fichiers copis sont spcifis 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 prdfinis dans le panneau Fragments de code. La version d'un fichier prsente 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 dj copi le fichier, copiez le fichier dans le dossier Configuration de l'utilisateur puis modifiez-le.

Suppression de fichiers de configuration dans un environnement multiutilisateurLors de toute opration engendrant l'effacement d'un fichier de configuration dans Dreamweaver sous un systme d'exploitation multi-utilisateur (par exemple, la suppression d'un fragment de code prdfini dans le panneau Fragments de code), Dreamweaver cre un fichier nomm mm_deleted_files.xml dans votre dossier Configuration. Lorsqu'un fichier est rpertori dans le fichier mm_deleted_files.xml, Dreamweaver se comporte comme si le fichier n'existait plus. Dsactivation 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'lment dans ce fichier en indiquant le chemin (relatif au dossier Configuration de Dreamweaver) du fichier de configuration dsactiver. 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.xmlLe fichier mm_deleted_files.xml contient une liste structure d'lments qui indiquent les fichiers de configuration que Dreamweaver doit ignorer. Ces lments sont spcifis 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-aprs, les attributs facultatifs dans les listes d'attributs sont indiqus par des accolades({}). Les attributs qui ne sont pas signals ainsi sont considrs comme obligatoires.

Description Balise de conteneur renfermant une liste d'lments considrer comme supprims par Dreamweaver. Attributs Aucun. Contenu Cette balise doit contenir une ou plusieurs balises item.

EXTENSION DE DREAMWEAVER CS4 13Personnalisation de Dreamweaver

Contenant Aucun. Exemple

Description Dfinit un fichier de configuration ignorer par Dreamweaver. Attributsname

L'attribut name spcifie le chemin du fichier de configuration par rapport au dossier Configuration. Sous Windows, utilisez une barre oblique inverse (\) pour sparer les lments constitutifs du chemin ; sur Macintosh, utilisez deux points (:). Contenu Aucun (balise vide). Contenant Cette balise doit se trouver dans une balise deleteditems. Exemple

Rinstallation et dsinstallation de Dreamweaver dans un environnement multi-utilisateurAprs avoir install Dreamweaver, si vous souhaitez rinstaller le programme ou le mettre jour, Dreamweaver sauvegarde automatiquement une copie des fichiers de configuration utilisateur existants. Vos paramtres personnels resteront donc accessibles. Lors de la dsinstallation de Dreamweaver dans un environnement multi-utilisateur (opration possible uniquement pour les utilisateurs disposant de privilges administratifs), Dreamweaver peut supprimer tous les dossiers de configuration utilisateur votre demande.

Modification des mappages FTPLe 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 crateur (tel que DmWr) et un type de fichier (tel que TEXT). Lorsque vous tlchargez un fichier portant l'extension donne, Dreamweaver lui assigne alors le crateur et le type de fichier dsigns.

EXTENSION DE DREAMWEAVER CS4 14Personnalisation de Dreamweaver

Si un fichier que vous transfrez ne comporte pas d'extension de nom de fichier, Dreamweaver utilise le mode de transfert BINAIRE. Remarque : Dreamweaver ne peut pas transfrer de fichiers en mode Macbinary. Si vous devez transfrer 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 transfrs en mode ASCII :HTML DmWr TEXT ASCII

Dans le fichier FTPExtensionMap.txt et le fichier FTPExtensionMapMac.txt (Macintosh), tous les lments placs sur une mme ligne sont spars par des tabulations. L'extension et le mode de transfert sont crits en majuscules. Pour modifier un paramtre par dfaut, 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 crateur, un caractre de tabulation, puis le type de fichier suivi d'un autre caractre

de tabulation.4 Choisissez entre ASCII ou BINARY pour spcifier un mode de transfert FTP. 5 Enregistrez le fichier.

Types de documents extensibles dans DreamweaverXML est dot d'un systme performant pour dfinir des documents et des structures de donnes complexes. Dreamweaver organise selon plusieurs schmas XML les informations sur les comportements de serveur, les balises et les botes de dialogue de balises, les composants, les types de documents et des rfrences. Lorsque vous crez et utilisez des extensions dans Dreamweaver, vous pouvez souvent crer ou modifier les fichiers XML existants afin de grer les donnes utilises 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 modle.

Fichiers de dfinition de type de documentLe concept de type de document s'articule autour d'un composant central, savoir le fichier de dfinition de type de document. Vous pouvez tre en prsence de plusieurs fichiers de dfinition ; le cas chant, ils rsident tous dans le dossier Configuration/DocumentTypes. Chaque fichier de dfinition contient des informations concernant au moins un type de document. Des informations essentielles, telles que le modle de serveur, le style de codage par couleurs, les descriptions, etc., sont dcrits pour chacun de ces types de documents. Remarque : Attention : il ne faut pas confondre fichiers de dfinition de type de document de Dreamweaver et dfinition de type de document XML (DTD). Les fichiers de dfinition de type de document de Dreamweaver contiennent un ensemble d'lments documenttype, chacun d'entre eux dfinissant une collection prdfinie de balises et d'attributs associs un type de document. Au lancement, Dreamweaver analyse les fichiers de dfinition de type de document et place en mmoire une base de donnes d'informations concernant tous les types de documents dfinis. Dreamweaver fournit un fichier de dfinition de type de document initial. Ce fichier, nomm MMDocumentTypes.xml, contient les dfinitions de type de document fournies par Adobe :

EXTENSION DE DREAMWEAVER CS4 15Personnalisation de Dreamweaver

Type de document

Modle de serveur ASP.NET-Csharp ASP.NET-VB ASP-JS ASP-VB ColdFusion

Type interne

Extensions de fichier aspx, ascx aspx, ascx asp asp cfm, cfml cfc jsp php, php3 lbi axcs.dwt axvb.dwt aspjs.dwt aspvb.dwt cfm.dwt dwt jsp.dwt php.dwt htm, html as cs CSS java js vb vbs txt edml tld vtm, vtml wml xml

Modle de serveur antrieur

ASP.NET C# ASP.NET VB ASP JavaScript ASP VBScript ColdFusion Composant ColdFusion JSP PHP Elment de bibliothque Modle ASP.NET C# Modle ASP.NET VB Modle ASP JavaScript Modle ASP VBScript Modle ColdFusion Modle HTML Modle JSP Modle PHP HTML ActionScript CSharp CSS Java JavaScript VB VBScript Texte EDML TLD VTML WML XML

Dynamique Dynamique Dynamique Dynamique Dynamique Dynamique

UltraDev 4 ColdFusion

JSP PHP

Dynamique Dynamique Extension DW Modle DW Modle DW Modle DW Modle DW Modle DW Modle DW Modle DW Modle DW HTML Texte Texte Texte Texte Texte Texte Texte Texte XML XML XML XML XML

Si vous avez besoin de crer un nouveau type de document, vous pouvez soit ajouter votre entre dans le fichier de dfinition de document fourni par Adobe (MMDocumentTypes.xml), soit ajouter votre propre fichier de dfinition dans le dossier Configuration/DocumentTypes.

EXTENSION DE DREAMWEAVER CS4 16Personnalisation de Dreamweaver

Remarque : Le sous-dossier NewDocuments rsidant dans le dossier Configuration/DocumentTypes contient des pages par dfaut (modles) propres chaque type de document.

Structure des fichiers de dfinition de type de documentL'exemple suivant reprsente un fichier classique de dfinition de type de document : features]]>" /> ...

Remarque : Les identificateurs de chane, tels que myJSPDocType/Description dans l'exemple prcdent, doivent tre uniques dans l'application Dreamweaver. Au lancement, Dreamweaver analyse tous les fichiers XML du dossier Configuration/Strings et charge ces chanes uniques.

Rgles d'utilisation des fichiers de dfinition de type de documentDreamweaver autorise les types de documents associs un modle de serveur partager des extensions de fichiers. Par exemple, ASP-JS et ASP-VB peuvent adopter l'extension .asp. Pour savoir quel modle de serveur prvaut, voir canRecognizeDocument() la page 338. Dreamweaver n'autorise pas les types de documents non associs un modle de serveur partager des extensions de fichiers. Si une extension de fichier est revendique par deux types de documents alors qu'un type est associ un modle de serveur et que l'autre ne l'est pas, ce dernier prvaut. Supposons que vous ayez dfini un type de document appel SAM, non associ un modle 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.

Ouverture d'un document dans DreamweaverLorsqu'un utilisateur ouvre un document, Dreamweaver identifie en plusieurs tapes le type de document d'aprs son extension de fichier. Si Dreamweaver dtecte un type de document unique, il l'utilise et charge le modle de serveur associ (le cas chant) 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 modle de serveur UltraDev4 correspondant. Si l'extension de fichier est commune plusieurs types de documents, Dreamweaver effectue les oprations suivantes :

Si un type de document statique figure dans la liste des types de documents, il prvaut. Si tous les types de documents sont dynamiques, Dreamweaver gnre une liste alphabtique des modles deserveur associs ces types de documents, puis appelle la fonction canRecognizeDocument() pour chacun des modles de serveur (voir canRecognizeDocument() la page 338). Dreamweaver collecte les valeurs de retour et identifie le modle de serveur qui a renvoy l'entier positif le plus grand. Le type de document dont le modle 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 modles de serveur renvoient le mme entier, Dreamweaver passe en revue la liste alphabtique de ces modles de serveur, choisit le premier de la liste, puis l'utilise. Si, par exemple, les types ASP-JS et ASP-VB portent la mme extension.asp et que leur fonction canRecognizeDocument() respective renvoie une valeur gale, Dreamweaver affecte au document le type ASP-JS (puisque ASP-JS apparat en premier dans l'ordre alphabtique). Si Dreamweaver ne peut pas faire correspondre l'extension de fichier un type de document, Dreamweaver ouvre le document au format texte.

EXTENSION DE DREAMWEAVER CS4 24Personnalisation de Dreamweaver

Personnalisation des prsentations de l'espace de travailDreamweaver vous permet de personnaliser la prsentation de l'espace de travail. Vous pouvez ainsi spcifier les panneaux inclus dans la prsentation indique, ainsi que divers autres attributs tels que la position et la taille des panneaux, leur tat (rduit ou dvelopp), la position et la taille de la fentre d'application, ainsi que la position et la taille de la fentre de document. La prsentation de l'espace de travail est spcifie dans les fichiers XML stocks dans le dossier Configuration/Workspace layouts. Les sections suivantes dcrivent la syntaxe des balises XML. Les attributs facultatifs sont dfinis par des accolades ({}) dans la liste des attributs ; les attributs ne comportant pas d'accolades sont donc obligatoires.

Description Balise d'extrmit, qui signale le dbut 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

Description Stipule la position et la taille initiales de la fentre d'application. Attributsrect, maximize

rect spcifie la position et la taille de la fentre d'application. La chane est exprime au format gauche haut droite bas , spcifi sous forme de nombres entiers. maximize est une valeur boolenne : true si la fentre d'application doit tre agrandie au dmarrage, et false dans

le cas contraire. La valeur par dfaut est true. Contenu Aucun. Contenant Cette balise doit tre imbrique dans une balise panelset.

EXTENSION DE DREAMWEAVER CS4 25Personnalisation de Dreamweaver

Exemple

Description Stipule la position et la taille initiales de la fentre de document. Attributsrect, maximize

rect spcifie la position et la taille de la fentre de document. La chane est exprime au format gauche haut droite bas , spcifi sous forme de nombres entiers. Si la valeur maximize est rgle sur true, la valeur rect n'est pas prise en compte. maximize est une valeur boolenne : true si la fentre de document doit tre agrandie au dmarrage, et false dans le cas contraire. La valeur par dfaut est true.

Contenu Aucun. Contenant Cette balise doit tre imbrique dans une balise panelset. Exemple

Description Dcrit un groupe entier de panneaux. Attributsx, y, {width, height}, dock, collapse

x indique la position de gauche du groupe de panneaux. Vous pouvez le rgler sur un nombre entier ou sur une

valeur relative l'cran. Si le nombre entier excde 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 gres sont left ou right et identifient la bordure du groupe de panneaux aligne sur la bordure de l'cran virtuel.

y indique la position suprieure du groupe de panneaux. Vous pouvez le rgler sur un nombre entier ou sur une valeur relative l'cran. Si le nombre entier excde 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 gres sont top ou bottom et identifient la bordure du groupe de panneaux aligne sur la bordure de l'cran virtuel.

EXTENSION DE DREAMWEAVER CS4 26Personnalisation de Dreamweaver

width indique la largeur du groupe de panneaux, exprime en pixels. Cet attribut est facultatif. Si vous ne spcifiez

pas de largeur, la valeur par dfaut du groupe de panneaux est utilise.height indique la hauteur du groupe de panneaux, exprime en pixels. Cet attribut est facultatif. Si vous ne spcifiez pas de hauteur, la valeur par dfaut du groupe de panneaux est utilise. dock est une chane 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 boolenne : true indique que le groupe de panneaux est rduit, et false indique qu'il est dvelopp. Cet attribut n'est pas pris en compte sur Macintosh, car les panneaux flottent.

Contenu Cette balise doit contenir une ou plusieurs balises panelcontainer. Contenant Cette balise doit tre imbrique dans une balise panelset. Exemple

Description Dcrit un groupe entier de panneaux. Attributsexpanded, title,{ height,} activepanel, visible, maximize, maxRestorePanel, maxRestoreIndex, maxRect, tabsinheader

expanded est une valeur boolenne : true si le panneau est dvelopp et false s'il ne l'est pas. title est une chane qui indique le titre du panneau. height est un nombre entier qui indique la hauteur des panneaux, exprime en pixels. Cet attribut est facultatif. Si vous ne spcifiez pas height, la valeur par dfaut de chaque panneau est utilise.

Remarque : La largeur est hrite du parent.

activepanel est une valeur numrique correspondant l'ID du panneau avant. visible est une valeur boolenne : true si le panneau est visible et false s'il ne l'est pas. maximize est une valeur boolenne : true si le panneau doit tre agrandi lorsqu'il s'affiche initialement et false dans le cas contraire. maxRestorePanel est une valeur numrique correspondant l'ID du panneau afficher suite une restauration. maxRect est une chane qui indique la position et la taille du panneau agrandi. La chane est exprime au format

gauche haut droite bas , spcifi sous forme de nombres entiers.tabsinheader est une valeur boolenne : true indique que les onglets doivent tre placs dans l'en-tte et non sous

la barre d'en-tte ; false indique le contraire.

EXTENSION DE DREAMWEAVER CS4 27Personnalisation de Dreamweaver

Contenu Cette balise doit contenir une ou plusieurs balises panel. Contenant Cette balise doit tre imbrique dans une balise panelframe. Exemple

Description Spcifie le panneau qui s'affiche dans le contenant. Attributsid, visibleTab

id est une valeur numrique correspondant l'ID du panneau. Le tableau ci-dessous contient une liste de valeurs.Logiciel Adobe Flash ID 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 Panneau Proprits Actions Alignement Comportements Composants Inspecteur de composants Mlangeur Nuanciers Historique Info Bibliothque Explorateur d'animations Sortie Proprits Projet Transformer

EXTENSION DE DREAMWEAVER CS4 28Personnalisation de Dreamweaver

Logiciel

ID 17 18 19 101 110

Panneau Squence Chanes Dbogueur Bibliothque

Dreamweaver Flex Builder

1 1

Proprits Proprits

visibleTab est une valeur boolenne : true si l'onglet et le panneau doivent tre visibles, false dans le cas

contraire. Contenu Aucun. Contenant Cette balise doit tre imbrique dans une balise panelcontainer. Exemple

Personnalisation de la barre d'outils de codageLa barre d'outils de codage contient normalement 15 boutons. Vous disposez cependant d'autres boutons. Pour personnaliser la barre d'outils de codage, vous pouvez modifier ses boutons et leur ordre d'affichage. Vous devez pour ce faire modifier le fichier Configuration/Toolbars/Toolbars.xml. Vous pouvez galement insrer vos propres boutons par le biais d'Extension Manager. Modification de l'ordre des boutons 1 Ouvrez le fichier Configuration/Toolbars/toolbars.xml.2 Localisez la section Code view toolbar en recherchant le commentaire suivant :

3 Copiez et collez les balises associes aux boutons pour que ces derniers s'affichent dans l'ordre requis dans la barre

d'outils.4 Enregistrez le fichier.

Suppression d'un bouton 1 Ouvrez le fichier Configuration/Toolbars/toolbars.xml.2 Localisez la section Coding toolbar en recherchant le commentaire suivant :

EXTENSION DE DREAMWEAVER CS4 29Personnalisation de Dreamweaver

3 Entourez le bouton supprimer d'un commentaire.

L'exemple suivant illustre un bouton entour de commentaires.

4 Enregistrez le fichier.

Pour afficher un bouton qui n'apparat pas sur la barre d'outils, il suffit de supprimer le commentaire qui entoure le bouton dans le fichier XML.

Modification des raccourcis clavierDreamweaver offre de nombreux raccourcis clavier pour accder rapidement aux principales fonctionnalits. Les raccourcis clavier par dfaut figurent dans le fichier menus.xml et sont conus pour le clavier amricain. En raison du nombre lev de raccourcis de Dreamweaver, certains raccourcis ne faisant pas appel des caractres alphanumriques (caractres autres que a-z ou 0-9) ncessitent la reconfiguration du clavier. A cette fin, Dreamweaver dispose de plusieurs fichiers XML qui dfinissent le mappage des raccourcis clavier en fonction de diffrentes langues. Ces fichiers sont situs dans le dossier Configuration\Menus\Adaptive Sets. Lorsque Dreamweaver dtecte un clavier autre que le clavier Qwerty amricain, il adapte de faon automatique les raccourcis clavier. Lorsque le fichier appropri n'est pas disponible pour le clavier, Dreamweaver supprime les raccourcis clavier qui ne fonctionnent pas pour ce type de clavier. Les fichiers de raccourcis clavier emploient un code deux lettres pour identifier le clavier. Ainsi, le fichier du clavier allemand est appel de.xml. Lorsqu'une langue ncessite diffrentes dispositions en fonction du pays d'utilisation, le fichier de mappages emploie toujours le code de langue deux lettres, mais suivi par un tiret (-) et un code de pays deux lettres. Par exemple, fr-ca.xml dsigne le clavier canadien franais. Les codes de langue deux lettres est conforme la norme ISO 639 (http://en.wikipedia.org/wiki/List_of_ISO_639_codes), tandis que le code de pays repose sur la norme ISO 3166 (http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Lorsque Dreamweaver dtecte un changement de clavier, il recherche automatiquement le fichier de mappage correspondant. Dreamweaver recherche en premier le fichier propre au pays puis, si ce fichier n'existe pas, il recherche le fichier correspondant la langue. Par exemple, si vous connectez un clavier canadien franais votre ordinateur, Dreamweaver recherche tout d'abord le fichier fr-ca.xml. S'il n'existe pas, Dreamweaver recherche fr.xml. Le tableau suivant regroupe les fichiers de mappage livrs avec Dreamweaver.Nom de fichier ca.xml de.xml de-ch.xml Plate-forme Windows Catalan Allemand (Allemagne, Autriche) Allemand (Suisse) Plate-forme Macintosh Catalan (Espagne) Autrichien, Allemand Suisse-Allemand

EXTENSION DE DREAMWEAVER CS4 30Personnalisation de Dreamweaver

Nom de fichier es.xml

Plate-forme Windows Espagnol (international) Espagnol (traditionnel) Franais (France) Franais (Canada) Franais (Suisse) Italien (Italie) Italien (Suisse) S/O Japonais

Plate-forme Macintosh Espagnol - ISO

fr.xml fr-ca.xml fr-ch.xml it.xml it-mac.xml ja.xml nl-be.xml zh-cn.xml

Franais Canadien - CSA Franais Suisse Italien - Pro Italien Japonais

Nerlandais (Belgique) Franais (Belgique) Belge Chinois (RPC) Chinois (Singapour) Chinois simplifi

Si vous utilisez une disposition de clavier qui ne correspond pas celle de Dreamweaver, vous pouvez crer un fichier de mappage personnalis et le placer dans le dossier Configuration\Menus\Adaptive Sets. Cration d'un fichier de mappage du clavier 1 Copiez l'un des fichiers de mappage du clavier dans le dossier Configuration\Menus\Adaptive Sets et nommez-le l'aide du code de langue 2 lettres en fonction de la disposition de votre clavier et employez l'extension .xml. Lorsque vous copiez un fichier, vous devez choisir un fichier de mappage aussi proche que possible de la disposition du clavier. Par exemple, si vous crez un fichier de mappage pour le clavier sudois, il est recommand de copier le fichier de.xml dans la mesure o les dispositions des claviers sudois et allemand sont similaires.2 Placez le fichier de mappage que vous venez de crer dans un dossier diffrent de Configuration\Menus\Adaptive

Sets.3 Ouvrez le fichier de mappage du clavier dans Dreamweaver. 4 Supprimez ou ajoutez des balises de raccourci pour la disposition de clavier voulue.

Pour dterminer les balises de raccourci clavier modifier, comparez le jeu de raccourcis du clavier amricain celui de votre langue. La procdure suivante dcrit la comparaison de raccourcis partir de deux dispositions de clavier distinctes.5 Aprs avoir apport les modifications voulues aux raccourcis clavier, enregistrez le fichier et placez-le dans le

dossier Configuration\Menus\Adaptive Sets. Dterminez les balises de raccourci clavier que vous voulez modifier. 1 Slectionnez la langue correspondant votre clavier sur l'ordinateur, si ce n'est dj fait. Vous devez passer par le systme d'exploitation de l'ordinateur. Par exemple, sous Windows, vous pouvez slectionner la langue l'aide du Panneau de configuration.2 Lancez l'diteur de raccourcis clavier de Dreamweaver en slectionnant Edition > Raccourcis clavier. 3 Cliquez sur la troisime image de bouton dans le coin suprieur droit de la bote de dialogue. Survolez le bouton

avec le pointeur pour afficher l'infobulle Exporter le jeu au format H