Lisez-moi des exemples de scripts d InDesign CS 2 Ce document contient les éléments suivants : * Exemples de scripts : description rapide des exemples de scripts fournis avec InDesign. * Versionnage de script : procédure d exécution des scripts des versions précédentes d InDesign. * Notes de version : dernières informations sur la création de script. Pour plus de détails sur la création de script InDesign, visitez le site Web http://www.adobe.fr/products/indesign/scripting.html ou le forum utilisateurs de script InDesign, à l adresse suivante : http://www.adobeforums.com/cgi-bin/webx?14@@.2cd138bf Exemples de scripts InDesign CS 2 comprend les exemples de scripts suivants : * AddGuides * AddPoints * AdjustLayout * AlignToPage * BreakFrame * CornerEffects * CreateCharacterStyle * CropMarks * ExportAllStories * ImageCatalog * MakeGrid * Neon * PathEffects * PlaceMultipagePDF * RandomFill * SelectObjects * SortParagraphs * SplitStory * StepAndRepeat * TabUtilities * TextCleanup Remarque : assurez-vous d enregistrer votre travail avant d exécuter pour la première fois un exemple de scripts. Testez les différents exemples de scripts et observez leur effet avant de les appliquer à vos documents InDesign importants. Description des scripts AddGuides Ajoute des repères autour d un ou de plusieurs objets sélectionnés. * Obtention de coordonnées de page à partir d objets * Ajout de repères sur une planche * Création d un calque (et recherche d un calque existant) AddPoints Page 1
Ajoute des points sur les tracés d un ou de plusieurs objets. * Calcul Bézier et manipulation des points sur un tracé * Utilisation de la propriété «entire path» AdjustLayout Déplace les objets sur une distance spécifiée sur les pages droite/gauche. * Méthode de déplacement des objets * Utilisation des groupes de pages * Identification des pages recto et verso AlignToPage Aligne les objets sur la position indiquée sur une page. * Méthode de déplacement des objets * Utilisation des formats et marges de page BreakFrame Supprime un bloc de texte sélectionné, y compris son contenu, d un article. * Méthode de duplication * Utilisation du contenu d un bloc de texte Remarque : le script BreakFrame ne fonctionne pas correctement lorsque le bloc de texte contient un tableau qui s étend sur plusieurs blocs de texte. CornerEffects Redessine le tracé d un ou de plusieurs éléments à l aide d une variété d éléments d angle. Les éléments d angle peuvent être appliqués aux points sélectionnés sur le tracé. * Manipulation de la sélection * Opérations mathématiques pour le calcul de tracés simples * Utilisation de la propriété «entire path» CreateCharacterStyle Page 2
Définit un style de caractère complet d après le texte sélectionné. * Création d un style de caractère * Obtention des attributs de mise en forme de texte à partir d un objet de texte * Insertion de propriétés de style de caractère CropMarks Ajoute des marques de coupe et/ou de repérage autour d un ou de plusieurs objets sélectionnés. * Obtention de coordonnées de page à partir d objets * Recherche du cadre de sélection d une série d éléments sélectionnés * Dessin de lignes graphiques et d ovales * Application de nuances (et couleur de repérage) * Création d un calque (et recherche d un calque déjà existant) ExportAllStories Exporte tous les articles d un document vers une série de fichiers texte. * Exportation de texte * Objets et méthodes de fichier/dossier JavaScript (JavaScript uniquement) * Création de noms de fichiers d après les attributs d id ImageCatalog Place toutes les images d un dossier spécifié dans une mise en page «planche contact». * Utilisation de fichiers et dossiers * Importation et ajustement des images * Création d un bloc de texte et saisie de texte MakeGrid Crée une grille en sous-divisant ou en dupliquant un ou plusieurs objets sélectionnés. * Duplication et déplacement d objets Neon Page 3
Applique un effet de fusion à un ou plusieurs objets sélectionnés. * Duplication d un objet * Application d une couleur de contour * Association d objets * Application d attributs de mise en forme graphique (couleur, épaisseur du contour, teinte) PathEffects Modifie la position des points du tracé sur un ou plusieurs objets sélectionnés pour créer un effet artistique. * Duplication d un objet * Calcul Bézier et manipulation des points sur un tracé * Trigonométrie simple PlaceMultipagePDF Importe toutes les pages d un fichier PDF. * Application des attributs de format PDF * Importation des images * Ajout de pages * Sélection d un fichier RandomFill Remplit un ou plusieurs objets sélectionnés avec des objets de façon aléatoire. * Création d un élément de page * Génération de numéros aléatoires * Calcul Bézier et manipulation des points sur un tracé * Trigonométrie simple (dessin d un polygone régulier à partir d un point central donné) * Utilisation de la méthode de script «do» (AppleScript seulement) * Application d attributs de mise en forme graphique (couleur, épaisseur du contour, teinte, rotation) * Association d objets SelectObjects Sélectionne des objets sur la planche active selon leur type d objet. Page 4
Lisez-Moi Exemples de scripts Adobe.txt * Lecture d un élément de page simple * Sélection SortParagraphs Trie les paragraphes de la sélection par ordre alphabétique. * Méthode de déplacement des objets texte * Tri par permutation simple StepAndRepeat Duplique les objets et modifie leur position/taille/couleur. * Routine Exécuter et répéter générale * Application de fonds/contours aux objets * Application d une rotation et inclinaison aux objets SplitStory Sépare les blocs de texte dans l article sélectionné en blocs de texte distincts non liés. * Duplication d objets * Suppression d objets * Itération dans chaque bloc de texte d un article Remarque : le script SplitStory ne fonctionne pas correctement lorsque le bloc de texte contient un tableau qui s étend sur plusieurs blocs de texte. TabUtilities Applique des taquets de tabulation et des retraits au texte sélectionné. * Utilisation de taquets de tabulation et de retraits * Obtention de la position des pages à partir d objets texte * Obtention de la colonne de texte contenant le curseur TextCleanup Effectue une série d opérations de recherche/remplacement standard de texte. Page 5
* Utilisation de fichiers et dossiers * Utilisation de la méthode de recherche (rechercher/remplacer) * Utilisation de la méthode de script «do» (VBScript seulement) * Lecture de données de texte séparées par une tabulation d un fichier texte Versionnage de script Avant d exécuter une ancienne version de script dans une version plus récente d InDesign, prenez en considération les points suivants : 1. Ciblage - Les scripts doivent cibler la version de l application d exécution (par exemple, la version actuelle). Le mécanisme de ciblage est spécifique à chaque langue. 2. Compilation - Les noms dans le script doivent être mis en correspondance avec les ID sous-jacents pour être gérés par application. Le mécanisme de compilation est spécifique à chaque langue. 3. Interprétation - Mise en correspondance des ID avec le gestionnaire de requêtes approprié dans l application. La version actuelle d InDesign peut interpréter correctement un script écrit pour une version précédente du modèle d objets de document (DOM). Pour cela, il suffit d exécuter le script à partir d un dossier situé dans le dossier Scripts, appelé «Version 3.0 Scripts», ou de définir explicitement les préférences de script de l application sur l ancien modèle d objets à l intérieur du script (comme indiqué ci-dessous). Ciblage * Visual Basic Pour les applications et les scripts Visual Basic, vous devez utiliser la méthode «CreateObject» pour le ciblage. Rem Cibler InDesign CS2 : Set myapp = CreateObject("InDesign.Application.CS2") Rem Cibler la dernière version d InDesign que vous avez lancée : Set myapp = CreateObject("InDesign.Application") * AppleScript Pour les scripts Apple, vous devez utiliser l instruction «tell» pour le ciblage. Vous n avez pas besoin d une instruction «tell» si vous exécutez le script à partir du volet Scripts, car cette instruction est implicite dans l application de lancement du script. --Cibler CS2 tell application "Adobe InDesign CS2" * JavaScript Le ciblage des scripts Java est implicite à partir du volet Scripts. Si le lancement s effectue en externe, utilisez l instruction «target». //Cibler CS2 #target "InDesign-4.0" //cibler la dernière version d InDesign #target "InDesign" Compilation * Visual Basic Page 6
Vous pouvez attribuer une version aux applications Visual Basic en faisant référence à la bibliothèque de types CS. Pour générer une version CS de la bibliothèque de types, utilisez l événement PublishTerminology, indiqué dans l objet Application. La bibliothèque de types est publiée vers un dossier (nommé d après la version du modèle d objets de document (DOM)) situé dans le dossier «Scripting Support» (Support de script) du dossier de préférences de l application. Par exemple : C:\Documents and Settings\username\Application Data\Adobe\InDesign\Version 4.0\Scripting Support\3.0 Set myapp = CreateObject("InDesign.Application.CS2") myapp.publishterminology( 3.0 ) //publier la bibliothèque de types d InDesign CS (DOM version 3.0) Les scripts VB ne sont pas pré-compilés. L application se charge de générer et de référencer la bibliothèque de types appropriée automatiquement en se basant sur la version du modèle d objets de document (DOM) défini pour l interprétation. * AppleScript Les scripts Apple sont généralement compilés à l aide du dictionnaire de l application ciblée. Vous pouvez remplacer ce comportement à l aide de l instruction «using terms from», qui utilise le dictionnaire d une autre application à des fins de compilation. tell application "Adobe InDesign CS2" --Cibler CS2 à l aide de termes de l application InDesign CS --Compiler avec CS --Le script de la version InDesign CS apparaît ici. end using terms from end tell Pour générer une version CS du dictionnaire AppleScript, utilisez l événement de publication de terminologie, indiqué dans l objet application. Le dictionnaire est publié vers un dossier (nommé d après la version du modèle d objets de document (DOM)) situé dans le dossier «Scripting Support» (Support de script) du dossier de préférences de l application. Par exemple : /Users/username/Bibliothèque/Préférences/Adobe InDesign/Version 4.0/Scripting Support/3.0 [Remarque : effectuez la compilation à l aide de la pseudo-application «Adobe InDesign CS Dictionary» obtenue.] tell application "Adobe InDesign CS2" --Publier le dictionnaire InDesign CS (DOM version 3.0) publish terminology version 3.0 end tell * JavaScript Les scripts Java ne sont pas pré-compilés. Pour la compilation, l application utilise la version du modèle d objets de document (DOM) définie pour l interprétation. Interprétation L objet Application contient un objet Script Preferences (préférences de script), qui permet au script d extraire/définir la version du modèle d objets de document (DOM) de script à utiliser pour les requêtes d interprétation. Notez que la version restera comme définie jusqu à ce que vous la modifiiez explicitement de nouveau, y compris dans les scripts. La version passe par défaut à la version actuelle de l application et elle est conservée. * Visual Basic Page 7
Set myapp = CreateObject("InDesign.Application.CS2") Rem Définir sur 3.0 DOM myapp.scriptpreferences.version = 3.0 * AppleScript --Définir sur 3.0 DOM Définit la version des préférences du script sur 3.0 * JavaScript //Définir sur 3.0 DOM app.scriptpreferences.version = 3.0; Fonctions non comprises dans le versionnage * Chemins de fichier d environnements mixtes Dans InDesign CS, vous pouviez combiner les chemins spécifiques à une plate-forme avec les chemins URI ExtendScript. macpath = "MacHD:foldername"; uripath = "/subfolder/file"; myfile = File (macpath + uripath); Cette fonction n est plus prise en charge (y compris par les scripts s exécutant dans la version 3.0 du modèle d objets de script. * Création d attributs XML Dans InDesign CS, vous pouviez créer un objet d attribut XML sans inclure des paramètres. Dans InDesign CS2, vous devez inclure des paramètres pour créer un attribut XML. Les scripts d InDesign CS, qui essaient de créer des attributs XML sans spécifier de paramètres, génèrent une erreur lorsqu ils s exécutent dans InDesign CS2. Notes de version * Signal sonore Dans JavaScript, vous pouvez configurer InDesign pour utiliser le signal d «alerte» sonore de votre système, à l aide de l instruction suivante : app.beep(); * Propriété de type de compression de l objet de préférences d exportation PDF L énumération d objets de compression (idpdfcompressiontype.idcompressobjects dans VBScript ; PDFCompressionType.compressObjects dans JavaScript) apparaît dans le dictionnaire, mais elle ne peut pas être appliquée. (Remarque : ne confondez pas cette propriété avec la propriété de compression du texte et des dessins au trait.) 2005 Adobe Systems Incorporated. Tous droits réservés. AVIS : toutes les informations contenues dans le présent document appartiennent à Adobe Systems Incorporated. Aucune partie de cette publication (qu elle soit sur support papier ou électronique) ne peut être reproduite, enregistrée ou transmise sous quelque forme que ce soit, par quelque moyen que ce soit, électronique, mécanique ou autre, sans l autorisation écrite préalable d Adobe Systems Incorporated. Le logiciel décrit dans ce document est fourni sous licence et ne Page 8
peut être utilisé ou copié que conformément à la licence. Cette publication et les informations qu elle contient sont fournies EN L ETAT. Elles peuvent être modifiées sans préavis et ne constituent pas un engagement de la part d Adobe Systems Incorporated. Adobe Systems Incorporated ne peut être tenu pour responsable des erreurs ou des inexactitudes apparaissant dans les informations fournies par ce guide, n émet aucune garantie (expresse, implique ou légale) quant à la présente publication, et décline expressément toute garantie de qualité marchande, d adaptation à un usage particulier et de non-violation des droits de tiers. Toute référence à des noms de société dans les modèles cités en exemple est indiquée à des fins de démonstration. Adobe, le logo Adobe, Acrobat, Adobe PDF, Adobe Creative Suite, Illustrator, InDesign, InCopy, GoLive et Photoshop sont des marques ou des marques déposées d Adobe Systems Incorporated aux Etats-Unis et/ou dans d autres pays. Apple, Mac, Macintosh et Mac OS sont des marques ou des marques déposées d Apple Computer, Inc. aux Etats-Unis et dans d autres pays. Microsoft et Windows sont des marques ou des marques déposées de Microsoft Corporation aux Etats-Unis et dans d autres pays. UNIX est une marque aux Etats-Unis et dans d autres pays, accordé sous licence exclusivement par X/Open Company, Ltd. Toutes les autres marques sont la propriété de leurs détenteurs respectifs. Si cette documentation est distribuée avec un logiciel comprenant un accord avec l utilisateur final, cette documentation, ainsi que le logiciel qu elle décrit, sont fournis sous licence et ne peuvent être utilisés ou copiés qu en accord avec les termes de cette licence. Sauf autorisation spécifiée dans la licence, aucune partie de ce guide ne peut être reproduite, enregistrée ou transmise sous quelque forme que ce soit, par quelque moyen que ce soit, électronique, mécanique ou autre, sans l autorisation écrite préalable d Adobe Systems Incorporated. Veuillez noter que le contenu de ce guide est protégé par des droits d auteur, même s il n est pas distribué avec un logiciel comprenant un accord avec l utilisateur final. Les informations contenues dans cette documentation sont données à titre purement indicatif. Elles peuvent être modifiées sans préavis et ne constituent pas un engagement de la part d Adobe Systems Incorporated. Adobe Systems Incorporated ne peut être tenu pour responsable des erreurs ou des inexactitudes apparaissant dans les informations fournies par cette documentation. Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA. Page 9