Adobe InDesign CS3 Scripting Tutorial

Adobe InDesign CS3 Scripting Tutorial
DIDACTICIEL DE SCRIPTS
bc
© 2007 Adobe Systems Incorporated. Tous droits réservés.
Adobe, le logo Adobe, Creative Suite, InDesign, Illustrator et Photoshop sont des marques ou des marques déposées
d’Adobe Systems Incorporated aux Etats-Unis et/ou dans d’autres pays. Microsoft et Windows sont des marques ou des
marques déposées de Microsoft Corporation aux Etats-Unis et/ou dans d’autres pays. Apple and Mac OS sont des
marques d’Apple Computer, Inc., déposées aux Etats-Unis et dans d’autres pays. Toutes les autres marques citées sont la
propriété de leurs détenteurs respectifs.
Les informations contenues dans ce document 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
décline toute responsabilité vis-à-vis des erreurs ou imprécisions qui pourraient être relevées dans ce manuel. Le logiciel
décrit dans ce document est fourni sous licence et ne peut être utilisé ou copié que conformément à la licence.
Didacticiel de scripts Adobe InDesign CS3
Introduction
Les scripts représentent la fonction la plus puissante d’Adobe® InDesign® CS3. Aucune autre fonction n’est
aussi rapide, facile et économique que le script.
Le présent document s’adresse à tous les utilisateurs d’InDesign. Si vous n’avez jamais créé un script, ce
document vous aidera à commencer. Si vous avez déjà créé des scripts pour d’autres applications, vous
apprendrez à appliquer vos connaissances aux scripts InDesign.
Ce document traite également de l’installation et de l’exécution d’un script InDesign, ainsi que des
limitations des scripts InDesign. Vous trouverez des indications sur les logiciels dont vous avez besoin pour
commencer à écrire vos propres scripts.
Après l’acquisition des notions de base de création de scripts InDesign présentées dans ce didacticiel, vous
serez prêt à passer au Guide de scripts Adobe InDesign CS3 pour approfondir vos connaissances sur la
création de scripts. Le Guide de scripts Adobe InDesign CS3 contient des centaines de scripts
d’apprentissage traitant des sujets tels que la mise en forme, la recherche et la modification de texte,
l’association de scripts à des éléments de menu, le dessin d’objets sur une page et l’exportation de
documents.
Mise en route
A l’aide des scripts, vous pouvez reproduire la plupart des opérations que vous exécutez dans l’interface
utilisateur. Vous pouvez dessiner des cadres, entrer du texte et le mettre en forme, importer des images et
imprimer ou exporter les pages du document. Toute opération apportant une modification au document
ou à son contenu, peut être réalisée à l’aide d’un script. A l’aide de scripts, vous pouvez même exécuter
certaines opérations qui ne sont pas réalisables dans l’interface utilisateur.
Les scripts permettent de créer des menus, d’ajouter des éléments de menu, de créer et d’afficher des
boîtes de dialogue et des panneaux, ainsi que de répondre aux sélections de l’interface utilisateur. Ils
peuvent lire et écrire des fichiers texte, analyser des données XML et communiquer avec d’autres
applications.
Les scripts permettent d’effectuer toutes sortes de tâches, des plus simples (telles que la définition d’un
taquet de tabulation au niveau du pointeur de texte) aux plus complexes, comme la définition d’un
ensemble complet de fonctions (la fonction d’exportation XHTML d’InDesign est fournie par un script).
Vous pouvez commencer avec des scripts simples qui n’exécutent qu’une action, puis passer aux scripts
qui automatisent le processus d’édition entier.
Les tâches que vous ne pouvez pas exécuter à l’aide de scripts, telles que la définition d’un espace de
travail ou d’un ensemble de raccourcis clavier, sont des tâches associées à l’interface utilisateur. En outre,
les scripts ne permettent pas d’ajouter de nouveaux types d’objets à un document InDesign ou d’ajouter
une nouvelle fonctionnalité de base au programme, telle qu’un moteur de composition de texte. Pour ce
type d’extension, vous devez utiliser le kit SKD (Software Developer’s Kit) d’InDesign, qui vous indique
comment écrire des modules externes compilés à l’aide du langage C++.
3
Didacticiel de scripts Adobe InDesign CS3
Mise en route
4
Les scripts sont souvent considérés comme des tâches longues et répétitives, telles que la mise en page
d’un annuaire téléphonique. Notez, toutefois, qu’ils permettent également d’exécuter d’autres tâches,
telles que les suivantes :
●
Automatisation d’une myriade de petites tâches fastidieuses quotidiennes
●
Personnalisation d’InDesign pour l’adaptation aux habitudes de travail et mises en page de
l’utilisateur
●
Réalisation d’effets artistiques, difficiles, voire impossibles à obtenir par d’autres moyens
Installation des scripts
L’installation d’un script InDesign est simple à réaliser : enregistrez le fichier script dans le dossier Scripts
Panel du dossier Scripts dans votre dossier InDesign. (Si le dossier Scripts n’existe pas, créez-le.)
Vous pouvez également placer le script dans le dossier Scripts Panel de votre dossier de préférences
utilisateur à l’emplacement suivant :
Mac OS :
~/Library/Preferences/Adobe InDesign/Version 5.0/Scripts
Windows XP :
~\Documents and Settings\user_name\Application Data\Adobe
\InDesign\Version 5.0\Scripts
où ~ représente le volume système, et user_name votre nom d’utilisateur.
Une fois dans le dossier, le script s’affiche dans le panneau Scripts de l’application InDesign. Pour afficher le
panneau, choisissez la commande Fenêtre > Automatisation > Scripts.
Vous pouvez également placer des alias ou des raccourcis de scripts (ou de dossiers contenant des scripts)
dans le dossier Scripts Panel. Ils s’afficheront dans le panneau Scripts.
Exécution d’un script
Pour exécuter un script, vous devez afficher le panneau Scripts (choisissez la commande Fenêtre >
Automatisation > Scripts), puis cliquer deux fois sur le nom du script dans le panneau Scripts. De
nombreux scripts affichent des éléments d’interface utilisateur (boîtes de dialogue ou panneaux,
par exemple), ainsi que des messages d’alerte, si nécessaire.
Utilisation du panneau Scripts
Le panneau Scripts d’InDesign représente le meilleur moyen d’exécuter la plupart des scripts InDesign. S’il
n’est pas visible, vous pouvez l’afficher en choisissant la commande Fenêtre > Automatisation > Scripts.
Les scripts activés à partir du panneau Scripts sont exécutés plus rapidement que ceux activés à partir du
Finder (Mac OS®) ou de l’Explorateur (Windows®). Pour afficher les opérations du script à mesure qu’elles
s’exécutent, dans le menu du panneau Scripts, choisissez la commande Activer la réactualisation.
Le panneau Scripts peut exécuter des AppleScripts (fichiers avec l’extension .spt, .as ou .applescript)
compilés ou non, des JavaScripts (fichiers avec l’extension .js ou .jsx), des VBScripts (fichiers avec
l’extension .vbs) ou des programmes exécutables à partir du panneau Scripts.
Pour modifier un script affiché dans le panneau Scripts, maintenez la touche Option (Mac OS) ou Alt
(Windows) enfoncée tout en cliquant deux fois sur le nom du script. Le script sera ouvert dans l’éditeur
défini pour son type de fichier.
Didacticiel de scripts Adobe InDesign CS3
Mise en route
5
Pour ouvrir le dossier contenant un script affiché dans le panneau Scripts, maintenez la touche Commande
(Mac OS) ou Ctrl+Shift (Windows) enfoncée tout en cliquant deux fois sur le nom du script. Vous pouvez
également choisir la commande Faire apparaître dans le Finder (Mac OS) ou Faire apparaître dans
l’Explorateur (Windows) dans le menu du panneau Scripts. Le dossier contenant le script s’ouvre dans le
Finder (Mac OS) ou l’Explorateur (Windows).
Par défaut, les scripts s’exécutent en une seule opération, de sorte que vous pouvez en général annuler les
modifications apportées au document par le script en choisissant la commande Annuler dans le
menu Edition. Pour exécuter un script comme plusieurs opérations, de sorte à pouvoir annuler chaque
opération du script séparément, choisissez la commande Script entier affecté par l’annulation dans le
menu du panneau Scripts. Vous pourrez ainsi dépanner un script, en revenant aux étapes précédentes
pour chaque modification. En général, il est préférable de conserver cette commande activée pour
améliorer les performances du script.
Pour ajouter un raccourci clavier à un script, choisissez la commande Edition > Raccourcis clavier. Dans le
menu Ensemble, sélectionnez un ensemble de raccourcis modifiable, puis sélectionnez la commande Scripts
dans le menu Zone du produit. Une liste des scripts apparaît dans le panneau Commandes. Sélectionnez
un script et affectez-lui un raccourci clavier comme vous le feriez pour n’importe quelle autre fonction
d’InDesign.
A propos des langages de script
Le langage utilisé pour écrire des scripts dépend du système de script de la plate-forme sur laquelle vous
travaillez : AppleScript pour Macintosh, VBScript pour Windows ou JavaScript pour les deux plates-formes.
Bien que les langages d’écriture de script diffèrent, leur fonctionnement avec InDesign est très similaire.
Les scripts d’exemple contenus dans ce document sont donnés pour tous ces langages. La conversion d’un
script d’un langage à un autre est un procédé assez simple.
JavaScript
InDesign prend en charge JavaScript pour le script multiplate-forme sous Mac OS et Windows. La prise en
charge de JavaScript par InDesign repose sur l’implémentation de JavaScript pour Adobe appelée
ExtendScript. L’interprète ExtendScript est conforme à la norme ECMA 262 en vigueur pour JavaScript.
Toutes les fonctions de langage JavaScript 1.5 sont prises en charge. Illustrator®, Photoshop®, ainsi que
d’autres produits Adobe Creative Suite® utilisent également l’interprète ExtendScript JavaScript.
Vous pouvez écrire des scripts dans d’autres versions de JavaScript, telles que Microsoft® JScript
(Windows) ou JavaScript OSA de Late Night Software (Mac OS), mais les termes utilisés dans ces langages
ne sont pas les mêmes que ceux utilisés dans ExtendScript. Les exemples ExtendScript ne fonctionnent
pas dans d’autres versions JavaScript.
Remarque : les outils et fonctions ExtendScript sont utilisés dans plusieurs produits Adobe. Cela a mené à
la consolidation de toute la documentation ExtendScript. Pour plus de détails sur les
utilitaires JavaScript, tels que le module d’interface utilisateur ScriptUI et l’utilitaire
Outils ExtendScript (environnement de développement et inspecteur de modèle
d’objet JavaScript), consultez le Guide des outils JavaScript Creative Suite 3.
Didacticiel de scripts Adobe InDesign CS3
Mise en route
6
Mac OS
Pour utiliser le script d’InDesign sur Mac OS, vous pouvez utiliser soit JavaScript, soit AppleScript. Pour
écrire des AppleScripts, vous devez posséder AppleScript version 1.6 ou supérieure, ainsi qu’un éditeur de
scripts AppleScript. AppleScript est fourni avec tous les systèmes Apple® et peut être téléchargé
gratuitement à partir du site Web d’Apple. L’éditeur de scripts d’Apple est fourni avec Mac OS ; des éditeurs
de script tiers, tels que Script Debugger (de Late Night Software, http://www.latenightsw.com), sont
également disponibles.
Windows
Pour utiliser le script d’InDesign sous Windows, vous pouvez utiliser soit JavaScript, soit une version de
Microsoft Visual Basic, telle que VBScript.
Les scripts d’apprentissage Visual Basic sont écrits en langage VBScript. Nous avons choisi le
langage VBScript, car vous n’avez besoin d’aucun logiciel supplémentaire pour exécuter ou modifier des
fichiers VBScript ; vous pouvez les modifier avec n’importe quel éditeur de texte et les exécuter à l’aide du
panneau Scripts d’InDesign.
Les autres versions de Visual Basic incluent Visual Basic 5 Control Creation Edition (CCE), Visual Basic 6,
Visual Basic .NET et Visual Basic 2005 Express Edition. Les versions de Visual Basic antérieures à Visual
Basic .NET fonctionnent bien avec les scripts InDesign. La version Visual Basic .NET et versions plus
récentes ne fonctionnent pas aussi bien, car elles n’utilisent pas le type de données Variant qui est
présent de manière extensive dans les scripts InDesign.
De nombreuses applications, par exemple, Microsoft Word, Microsoft Excel, Microsoft Visio ou AutoCAD
contiennent Visual Basic for Applications (VBA). Bien qu’il ne soit pas intégré au programme InDesign,
vous pouvez utiliser VBA pour créer des scripts InDesign.
Pour utiliser VBScript ou Visual Basic dans les scripts InDesign sous Windows XP, vous devez installer
InDesign depuis le compte d’un utilisateur bénéficiant des droits d’administrateur. Une fois l’installation
terminée, n’importe quel utilisateur peut exécuter des scripts InDesign et ajouter des scripts dans le
panneau Scripts d’InDesign.
Langage de script à utiliser
Si vous avez déjà écrit des scripts, utilisez le langage que vous connaissez. Si vous n’avez jamais écrit de
scripts ou si vous devez utiliser vos scripts sur les versions Mac OS et Windows d’InDesign, utilisez le
langage JavaScript. Si vous devez communiquer avec des applications autres qu’Adobe sur votre système,
utilisez le langage approprié standard de la plate-forme (AppleScript sur Mac OS ou VBScript
dans Windows).
Nous ne pouvons pas vous fournir une documentation détaillée sur AppleScript, JavaScript ou VBScript.
Vous aurez donc peut-être besoin de vous procurer la documentation spécifique à un ou plusieurs de ces
langages de script.
Remarque : vous pouvez également utiliser la plupart des langages de programmation (par exemple,
Python ou C#) qui peuvent se connecter au système d’automatisation standard de la
plate-forme ; cela ne fait toutefois pas partie du contenu du présent document.
Didacticiel de scripts Adobe InDesign CS3
Mise en route
7
Utilisation des scripts de ce document
Pour utiliser les scripts de ce document, ouvrez le fichier de script d’apprentissage (le nom de fichier
apparaît devant chaque script) ou suivez les étapes ci-dessous :
1. Copiez le script à partir de ce document Adobe PDF et collez-le dans votre éditeur de script, tel que
l’utilitaire Outils ExtendScript (pour les exemples JavaScript), l’Editeur Apple Script (pour les exemples
AppleScript) ou un éditeur de texte, tel que Bloc-Notes (pour les exemples VBScript).
2. Enregistrez le script au format de fichier texte brut dans le dossier Scripts Panel (voir la section
« Installation des scripts », page 4) avec l’extension appropriée :
AppleScript :
.applescript
JavaScript :
.jsx
VBScript :
.vbs
3. Choisissez la commande Fenêtre > Automatisation > Scripts pour afficher le panneau Scripts.
4. Pour exécuter le script, cliquez deux fois sur son nom dans le panneau.
Remarque : si vous entrez les exemples JavaScript, veillez à respecter la capitalisation indiquée. JavaScript
est sensible à la casse, et les scripts ne fonctionneront pas s’ils ne respectent pas la
capitalisation indiquée. Les exemples AppleScript et VBScript ne sont pas sensibles à la casse.
Remarque : si vous copiez et collez des scripts de ce document, soyez conscient que les sauts de ligne
provenant de la mise en page du document peuvent entraîner des erreurs dans vos scripts.
Ces erreurs pouvant être difficiles à repérer, il est recommandé d’utiliser les scripts dans
l’archive zip.
Votre premier script InDesign
Vous allez maintenant créer un script InDesign pour générer un document, ajouter un bloc de texte et
entrer du texte dans ce bloc. Ce script vous permet d’effectuer les opérations suivantes :
●
Etablissement de la communication avec InDesign
●
Création d’un document
●
Création d’un bloc de texte sur une page spécifique
●
Ajout de texte à un bloc de texte
AppleScript
Lancez l’application de l’éditeur de scripts (situé dans le dossier Applications, à l’intérieur du
dossier AppleScript). Entrez le script suivant (ou ouvrez le script d’apprentissage HelloWorld.applescript) :
tell application "Adobe InDesign CS3"
set myDocument to make document
tell page 1 of myDocument
set myTextFrame to make text frame
set geometric bounds of myTextFrame to {"6p", "6p", "24p", "24p"}
set contents of myTextFrame to "Hello World!"
end tell
end tell
Didacticiel de scripts Adobe InDesign CS3
Mise en route
8
Enregistrez le script au format texte avec l’extension .applescript dans le dossier Scripts Panel (voir la
section « Installation des scripts », page 4). Pour exécuter le script, cliquez deux fois sur son nom dans le
panneau Scripts d’InDesign ou cliquez sur le bouton Exécuter dans la fenêtre de l’éditeur de scripts.
JavaScript
Lancez l’utilitaire Outils ExtendScript (ou un éditeur de texte). Entrez le script suivant (ou ouvrez le script
d’apprentissage HelloWorld.jsx) :
var myDocument = app.documents.add();
var myTextFrame = myDocument.pages.item(0).textFrames.add();
myTextFrame.geometricBounds = ["6p", "6p", "24p", "24p"];
myTextFrame.contents = "Hello World!";
Enregistrez le script au format texte brut avec l’extension .jsx dans le dossier Scripts Panel (voir la section
« Installation des scripts », page 4). Pour exécuter le script, cliquez deux fois sur son nom dans le
panneau Scripts ou sélectionnez la commande InDesign dans le menu déroulant cible de l’application
dans l’utilitaire Outils ExtendScript, puis cliquez sur le bouton Exécuter.
VBScript
Lancez un éditeur de texte (par exemple, Bloc-Notes), puis entrez le script suivant (ou ouvrez le script
d’apprentissage HelloWorld.vbs) :
Set myInDesign = CreateObject("InDesign.Application.CS3")
Set myDocument = myInDesign.Documents.Add
Set myTextFrame = myDocument.Pages.Item(1).TextFrames.Add
myTextFrame.GeometricBounds = Array("6p", "6p", "24p", "24p")
myTextFrame.Contents = "Hello World!"
Enregistrez le script au format texte avec l’extension .vbs dans le dossier Scripts Panel (voir la section
« Installation des scripts », page 4). Pour exécuter le script, cliquez deux fois sur le nom du script dans le
panneau Scripts d’InDesign.
Analyse du script
Voici un examen du script ci-dessus, avec une analyse étape par étape des opérations réalisées par ce
script (dans chaque langage de script) :
1. Etablissement de la communication avec l’objet d’application InDesign
AppleScript :
tell application "Adobe InDesign CS3"
JavaScript :
fait référence à l’application par le nom app.
VBScript :
Set myInDesign = CreateObject("InDesign.Application.CS3")
2. Création d’un document et d’une référence au document :
AppleScript :
Set myDocument to make document
JavaScript :
Var myDocument = app.documents.add();
VBScript :
Set myDocument = myInDesign.Documents.Add
Scripts et modèle d’objet InDesign 9
Didacticiel de scripts Adobe InDesign CS3
3. Création d’un bloc de texte sur la première page et d’une référence au bloc de texte :
AppleScript :
tell page 1 of myDocument
set myTextFrame to make text frame
JavaScript :
var myTextFrame = myDocument.pages.item(0).textFrames.add();
VBScript :
Set myTextFrame = myDocument.Pages.Item(1).TextFrames.Add
4. Définition des délimitations géométriques (emplacement des bords supérieur, gauche, inférieur et
droit) du bloc de texte. Dans cette étape, le script utilise des remplacements d’unités de mesures
(p pour les picas) pour assurer la bonne taille du bloc de texte, sans tenir compte des unités de mesure
définies par défaut. Les emplacements sont présentés dans une liste ou un tableau de valeurs ; chaque
langage de script crée les tableaux de données d’une manière différente. Pour plus de détails sur les
variables de tableau de données, reportez-vous à la section « Variables de tableau de données », page 12.
AppleScript :
set geometric bounds of myTextFrame to {"6p", "6p", "24p", "24p"}
JavaScript :
myTextFrame.geometricBounds = ["6p", "6p", "24p", "24p"];
VBScript :
myTextFrame.GeometricBounds = Array("6p", "6p", "24p", "24p")
5. Ajout de texte au bloc de texte en définissant la propriété de contenu sur une chaîne :
AppleScript :
set contents of myTextFrame to "Hello World!"
JavaScript :
myTextFrame.contents = "Hello World!";
VBScript :
myTextFrame.Contents = "Hello World!"
Scripts et modèle d’objet InDesign
Cette section traite de la terminologie des langages de script en général, et plus particulièrement de la
création de scripts InDesign.
Terminologie de scripts
Cette section traite des termes et concepts utilisés couramment dans la création de scripts.
Commentaires
Les commentaires permettent d’ajouter un descriptif à un script. Les commentaires sont ignorés pendant
l’exécution d’un script (ils ne génèrent donc aucune erreur). Ils permettent de documenter les opérations
d’un script (pour mémoire ou pour un autre développeur). Dans ce document, nous utilisons des
commentaires pour les scripts d’apprentissage.
Pour inclure un commentaire dans un AppleScript, insérez -- (deux tirets) à la gauche du commentaire ou
encadrez-le des signes (* et *). En VBScript, insérez Rem (pour « remarque ») ou ' (un seul guillemet de
citation) à gauche du commentaire. Entrez le marqueur de commentaire au début d’une ligne pour
transformer toute cette ligne en commentaire. En JavaScript, insérez // à gauche du commentaire ou
placez ce commentaire entre /* et */ . Par exemple :
AppleScript :
--this is a comment
* and so is this *)
JavaScript :
// this is a comment
/* and so is this */
VBScript :
Rem this is a comment
' and so is this
Didacticiel de scripts Adobe InDesign CS3
Scripts et modèle d’objet InDesign
10
Valeurs
Le corps d’un caractère, la position d’un bloc de texte sur une page et la couleur de contour d’un rectangle
sont autant d’exemples de valeurs utilisées pour la création de scripts InDesign. Les valeurs sont des
données utilisées par un script pendant son exécution.
Le type d’une valeur définit quelle sorte de donnée elle contient. Le type de valeur du contenu d’un mot,
par exemple, est une chaîne de texte. De même, le type de valeur de l’interligne d’un paragraphe est un
nombre. En général, les valeurs utilisées dans un script sont des nombres ou du texte. Le tableau ci-dessous
répertorie les types de valeurs les plus couramment utilisées pour la création de scripts InDesign.
Type de valeur
Nature
Exemple
Boolean
True ou False logique
True
Integer
Nombres entiers (sans virgule).
Les entiers peuvent être positifs
ou négatifs. En VBScript, vous
pouvez utiliser des données de
type long pour les entiers. En
AppleScript, vous pouvez
également utiliser
indifféremment des données de
type long ou fixe pour les
nombres entiers et les nombres
réels.
14
Double (VBScript),
fixed or real
(AppleScript),
floating point
(JavaScript)
Nombre très précis pouvant
être décimal.
13.9972
String
Série de caractères de texte. Les
chaînes de texte sont présentées
entre guillemets anglais.
"I am a string"
Array (VBScript,
JavaScript)
or list (AppleScript)
Liste de valeurs (ces valeurs
peuvent être de tout type).
AppleScript :
{"0p0", "0p0", "16p4", "20p6"}
VBScript :
Array("0p0", "0p0", "16p4", "20p6")
JavaScript :
["0p0", "0p0", "16p4", "20p6"]
Didacticiel de scripts Adobe InDesign CS3
Scripts et modèle d’objet InDesign
11
Conversion de valeurs d’un type à un autre
Tous les langages de script pris en charge par InDesign permettent de convertir des valeurs variables d’un
type à un autre. Parmi les conversions les plus communes, se trouve la conversion de nombres en chaînes
de texte (ce qui permet d’entrer des nombres comme texte ou de les afficher dans des boîtes de dialogue)
ou de chaînes de texte en nombres (ce qui permet de définir un corps ou une position de page). Voir les
exemples ci-dessous.
AppleScript :
--To convert from a number to a string:
set myNumber to 2
set myString to (myNumber as string)
--To convert from a string to a number:
set myString to "2"
set myNumber to (myString as integer)
--if your string contains a decimal value, use "as real" rather than "as integer"
JavaScript :
//To convert from a number to a string:
myNumber = 2;
myString = myNumber + "";
//To convert from a string to an integer:
myString = "2";
myNumber = parseInt(myString);
//If your string contains a decimal value, use "parseFloat" rather than
"parseInt":
myNumber = parseFloat(myString);
//You can also convert strings to numbers using the following:
myNumber = +myString;
VBScript :
Rem To convert from a number to a string:
myNumber = 2
myString = cstr(myNumber)
Rem To convert from a string to an integer:
myString = "2"
myNumber = cInt(myString)
Rem If your string contains a decimal value, use "cDbl" rather than "cInt":
myNumber = cDbl(myString)
Variables
Une variable est le conteneur d’une valeur. Les variables portent ce nom car les valeurs qu’elles
contiennent peuvent changer. Une variable peut contenir un nombre, une chaîne de texte ou une
référence à un objet InDesign. Les variables possèdent des noms. Vous ferez donc référence à une variable
par son nom. Pour placer une valeur dans une variable, vous devez l’assigner à cette variable.
Dans le premier script d’exemple, plus haut, les variables myDocument et myTextFrame sont utilisées pour
éviter d’indiquer la spécification entière de l’objet (par exemple, text frame 1 of page 1 of document 1
ou app.documents.item(0).pages.item(0).textFrames.item(0)), à chaque référence à l’objet.
Dans tous les exemples et les scripts d’apprentissage accompagnant InDesign, les variables commencent
par my. Vous pouvez ainsi différencier facilement les variables créées dans un script, des termes du langage
de script.
Didacticiel de scripts Adobe InDesign CS3
Scripts et modèle d’objet InDesign
12
Affectation d’une valeur à une variable
L’affectation de valeurs ou de chaînes de texte à des variables est très simple, comme l’indique le tableau
suivant :
Langage
Exemples d’affectation d’une valeur à une variable
AppleScript
set myNumber to 10
set myString to "Hello, World!"
set myTextFrame to make text frame at page 1 of myDocument
JavaScript
var myNumber = 10;
var myString = "Hello, World!";
var myTextFrame = myDocument.pages.item(0).textFrames.add();
VBScript
myNumber = 10
myString = "Hello, World!"
Set myTextFrame = myDocument.Pages.Item(1).TextFrames.Add
Remarque : en JavaScript, toute variable non précédée de var est considérée par défaut comme globale,
non liée à une fonction spécifique. var n’est pas obligatoire, mais il est recommandé de
l’utiliser dans les scripts comprenant plusieurs fonctions. En AppleScript et VBScript, les
variables sont locales sauf si elles sont définies comme globales. Autrement dit, elles ne sont
plus valides en dehors de la fonction dans laquelle elles ont été créées.
Dans la mesure du possible, utilisez des noms évocateurs pour les variables, tels que firstPage
(premierePage) ou corporateLogo (logoSociete) au lieu de x ou c, par exemple. Votre script sera
beaucoup plus lisible. L’utilisation de noms longs n’affecte en rien la vitesse d’exécution du script.
Les noms de variables doivent être composés d’un seul mot, mais vous pouvez utiliser les majuscules
(pour écrire maPremierePage, par exemple) ou les traits de soulignement (ma_premiere_page) afin de
les rendre plus lisibles. Les noms de variables ne peuvent pas commencer par un chiffre, ou contenir des
signes de ponctuation ou des guillemets de citation.
Variables de tableau de données
AppleScript, JavaScript et VBScript prennent en charge les tableaux de données (arrays). Un tableau de
données est un type de variable répertoriant des valeurs. En AppleScript, un tableau de données est
appelé liste. Plusieurs exemples de définition de tableaux de données sont présentés ci-dessous :
Langage
Exemples de définition de tableaux de données
AppleScript
set myArray to {1, 2, 3, 4}
JavaScript
myArray = [1, 2, 3, 4];
VBScript
myArray = Array(1, 2, 3, 4)
Rem In Visual Basic.NET: myArray = New Double (1, 2, 3, 4)
Didacticiel de scripts Adobe InDesign CS3
Scripts et modèle d’objet InDesign
13
Pour faire référence à un élément d’un tableau de données, vous devez utiliser son numéro dans le
tableau. En VBScript et en JavaScript, le premier élément d’un tableau de données est le numéro 0 ; en
AppleScript, il s’agit du numéro 1. Des exemples de référence aux éléments dans un tableau de données
sont illustrés ci-dessous :
Langage
Exemples de référence aux éléments dans un tableau de données
AppleScript
set myFirstArrayItem to item 1 of myArray
JavaScript
var myFirstArrayItem = myArray[0];
VBScript
myFirstArrayItem = myArray(0)
Remarque : vous pouvez utiliser l’instruction OptionBase de Visual Basic pour attribuer le numéro 1 au
premier élément d’un tableau de données. Pour les exemples dans ce manuel, le premier
élément d’un tableau est le numéro 0 et non pas le numéro 1. Il s’agit de l’option par défaut.
Si vous avez choisi 1 pour OptionBase, vous devrez ajuster toutes les références des tableaux
de données en conséquence dans les scripts d’exemple.
Un tableau de données peut en contenir un autre, comme dans les exemples ci-dessous :
Langage
Exemples
AppleScript
set myArray to {{0, 0}, {72, 72}}
VBScript
myArray = Array(Array(0,0), Array(72, 72))
Rem In Visual Basic.NET: myArray = New Array(New Double(0,0),
NewDouble (0,0))
JavaScript
var myArray = [[0,0], [72,72]];
Détermination du type de valeur d’une variable
Parfois, un script devra prendre des décisions en fonction du type de valeur d’un objet. Si vous travaillez
sur un script opérant sur une sélection de texte, par exemple, vous devrez peut-être faire en sorte que ce
script s’arrête si le type de sélection est un élément de page. Tous les langages de script permettent de
déterminer le type d’une variable.
AppleScript :
-- Given a variable of unknown type, "myMysteryVariable"...
set myType to class of myMysteryVariable
--myType will be an AppleScript type (e.g., rectangle)
JavaScript :
//Given a variable of unknown type, "myMysteryVariable"...
myType = myMysteryVariable.constructor.name;
//myType will be a string corresponding to the JavaScript type (e.g., "Rectangle")
VBScript :
Rem Given a variable of unknown type, "myMysteryVariable"...
myType = TypeName(myMysteryVariable)
Rem myType will be a string corresponding to the variable type (e.g., "Rectangle")
Didacticiel de scripts Adobe InDesign CS3
Scripts et modèle d’objet InDesign
14
Opérateurs
Les opérateurs utilisent des variables ou des valeurs pour exécuter des calculs (addition, soustraction,
multiplication et division) et renvoyer une valeur. Par exemple :
MyWidth/2
Renvoie une valeur égale à la moitié du contenu de la variable myWidth.
Vous pouvez également utiliser des opérateurs pour exécuter des comparaisons (est égal à (=), est
différent de (<>), est supérieur à (>) ou est inférieur à (<)). Par exemple :
MyWidth > myHeight
Renvoie la valeur true (ou 1) si myWidth est supérieur à myHeight ou false (0) si ce n’est pas le cas.
Tous les langages de script fournissent des opérateurs « utilitaires » supplémentaires. En AppleScript
et VBScript, l’opérateur & peut joindre deux chaînes de texte :
"Pride " & "and Prejudice"
Renvoie la chaîne de texte suivante :
"Pride and Prejudice"
Pour joindre deux chaînes de texte en JavaScript, utilisez le signe plus (+), comme suit :
"Pride " + "and Prejudice"
//returns the string: "Pride and Prejudice"
Instructions conditionnelles
« Si l’objet sélectionné est un rectangle, définissez son contour sur une épaisseur de 12 points. » est un
exemple d’instruction conditionnelle. Les instructions conditionnelles permettent au script d’évaluer des
conditions (telles que la couleur de l’objet sélectionné, le nombre de pages de la composition ou la date)
et d’agir en fonction du résultat. Une instruction conditionnelle commence presque toujours par if.
Remarque : les instructions conditionnelles effectuent souvent des comparaisons logiques. En AppleScript
et VBScript, le signe égal (=) permet de comparer des objets. En JavaScript, le signe égal affecte
une valeur à une variable ; utilisez un signe égal double (==) pour la comparaison des objets.
Structures de contrôle
Si vous pouviez parler à InDesign, vous lui diriez, par exemple : « Répète vingt fois la procédure suivante. »
En termes de script, cette instruction est appelée structure de contrôle. Les structures de contrôle gèrent les
processus répétitifs ou boucles. Une boucle répète une action continuellement, avec ou sans changement
entre instances (ou itérations) de la boucle, jusqu’à ce qu’une condition spécifique soit remplie. Les structures
de contrôle commencent en général par repeat (en AppleScript) ou par for (en JavaScript et VBScript).
Didacticiel de scripts Adobe InDesign CS3
Scripts et modèle d’objet InDesign
15
Fonctions et gestionnaires
Les fonctions (en VBScript ou JavaScript) ou les gestionnaires (en AppleScript) sont des modules auxquels
vous pouvez faire référence dans un script. Généralement, vous envoyez une valeur ou une série de
valeurs à une fonction (ou à un gestionnaire) et obtenez une ou plusieurs autres valeurs. Le code des
fonctions et des gestionnaires permet tout simplement d’éviter de taper les mêmes lignes de code de
façon répétée dans un script.
En AppleScript, les gestionnaires commencent par on. En JavaScript et VBScript, les fonctions
commencent par function.
Présentation du modèle d’objet InDesign
Lorsque vous pensez à InDesign et aux documents InDesign, vous organisez certainement le programme
et ses composants dans votre esprit. Vous savez que les paragraphes sont contenus dans des blocs de
texte qui apparaissent sur une page, qu’une page fait partie d’une planche, et que plusieurs planches
composent un document. Les documents contiennent des couleurs, des styles, des calques et des
planches types. A mesure que vous créez les mises en page, vous pensez intuitivement à leur ordre.
InDesign traite le contenu de la même manière. Un document contient des pages, qui à leur tour
contiennent des éléments de page (blocs de texte, rectangles, ellipses, et ainsi de suite). Les blocs de texte
contiennent des caractères, des paragraphes et des blocs ancrés ; les blocs graphiques contiennent des
images, des fichiers EPS ou des fichiers PDF ; les groupes contiennent d’autres éléments de page. Tous ces
éléments sont les objets qui composent une publication InDesign, et qui sont utilisés pour écrire les
scripts InDesign.
Les objets de votre publication sont classés selon une hiérarchie : les blocs sont hébergés par des pages,
les pages par le document et le document par InDesign. Les termes modèle d’objet ou hiérarchie font
référence à cette structure. Il est important de comprendre la définition du modèle d’objet pour bien
identifier l’objet que vous voulez utiliser, et votre meilleur guide pour créer des scripts dans InDesign est
votre connaissance de l’application elle-même.
Les objets possèdent des propriétés (attributs). Par exemple, les propriétés d’un objet texte incluent la
police utilisée pour la mise en forme du texte, le corps et l’interligne appliqués au texte.
Les propriétés possèdent des valeurs. Par exemple, le corps de texte peut être représenté par un nombre
(en points) ou par la chaîne « Auto » pour l’interligne automatique. La propriété de couleur de fond du
texte peut être définie sur une couleur, un dégradé, une encre mélangée ou une nuance.
Les propriétés peuvent être en lecture/écriture ou en lecture seule. Vous pouvez définir les propriétés en
lecture/écriture sur d’autres valeurs, mais non les propriétés en lecture seule.
Les objets possèdent également des méthodes (les verbes de création de scripts ou les opérations qu’un
objet peut exécuter). Par exemple, l’objet de document contient des méthodes d’impression,
d’exportation et d’enregistrement.
Les méthodes possèdent des paramètres ou des valeurs définissant l’effet de la méthode. Par exemple, la
méthode de placement d’un document contient un paramètre définissant le fichier à placer. Les
paramètres sont requis ou facultatifs, selon la méthode.
L’illustration suivante est une vue d’ensemble du modèle d’objet InDesign. Elle ne contient pas la liste
complète des objets disponibles dans les scripts InDesign. Elle représente, à la place, une structure de
concepts permettant de comprendre la relation entre les types d’objets.
Didacticiel de scripts Adobe InDesign CS3
Scripts et modèle d’objet InDesign
16
application
documents
a document
libraries
document preferences
books
document defaults
application preferences
document events
application defaults
document properties
application events
document methods
application menus
document elements
application properties
pages or spreads
application methods
page
stories
page items
text objects
Les objets apparaissant dans le diagramme sont expliqués dans le tableau suivant :
Terme
Signification
Application
InDesign.
Application
defaults
Les paramètres par défaut de l’application, par exemple, les couleurs, les styles de
paragraphe et les styles d’objet. Les valeurs par défaut de l’application affectent
tous les nouveaux documents.
Application
events
Les événements qui se produisent à mesure qu’un utilisateur travaille dans
l’application ou qu’un script s’exécute. Les événements sont générés par
l’ouverture, la fermeture ou l’enregistrement d’un document ou par la sélection
d’une commande de menu. Les événements peuvent déclencher des scripts.
Application
menus
Les menus, sous-menus et menus contextuels qui s’affichent dans l’interface
utilisateur d’Design. Vous pouvez attacher des scripts aux menus pour exécuter des
commandes.
Application
methods
Les opérations que l’application peut effectuer. Par exemple, rechercher et remplacer
du texte, copier la sélection, créer des documents ou ouvrir des bibliothèques.
Application
preferences
Par exemple, des préférences de texte, d’exportation PDF ou des préférences de
document. De nombreuses préférences d’objet sont également disponibles au
niveau du document. Tout comme dans l’interface utilisateur, les préférences
d’application s’appliquent aux nouveaux documents. Les préférences de document
modifient les paramètres d’un document spécifique.
Application
properties
Les propriétés de l’application. Par exemple, le chemin complet de l’application,
son emplacement et le nom d’utilisateur.
Books
Une collection de livres ouverts.
Didacticiel de scripts Adobe InDesign CS3
Scripts et modèle d’objet InDesign
17
Terme
Signification
Document
Un document InDesign.
Document
defaults
Des paramètres par défaut de document, par exemple, des couleurs, des styles de
paragraphe et des paramètres par défaut de mise en forme de texte.
Document
elements
Par exemple, les articles, les graphiques importés et les pages d’un document.
L’illustration précédant ce tableau indique des pages et des articles, car ces objets
sont d’importants conteneurs d’autres objets. Toutefois, les éléments de document
incluent également des rectangles, des ovales, des groupes, des éléments XML,
ainsi que tout autre type d’objet que vous pouvez importer ou créer.
Document events
Les événements qui se produisent au niveau du document, par exemple,
l’importation de texte (voir Application events plus haut dans le tableau).
Document
methods
Les opérations que le document peut effectuer. Par exemple, fermer un document,
imprimer un document ou exporter un document.
Document
preferences
Les préférences d’un document, telles que les préférences de repères, d’affichage
ou de document.
Document
properties
Par exemple, le nom de fichier du document, le nombre de pages ou
l’emplacement du point zéro.
Documents
Une collection de documents ouverts.
Libraries
Une collection de bibliothèques ouvertes.
Page
Une seule page dans un document InDesign.
Page items
Tout objet que vous pouvez créer ou placer sur une page. Il existe de nombreux
types d’éléments de page, tels que des blocs de texte, des rectangles, des lignes
graphiques ou des groupes.
Pages or spreads
Les pages ou les planches dans un document InDesign.
Stories
Le texte dans un document InDesign.
Text objects
Les caractères, mots, lignes, paragraphes et colonnes de texte sont des exemples
d’objets texte dans un article InDesign.
Présentation du modèle d’objet InDesign
Vous pouvez percevoir le modèle d’objet InDesign depuis votre application d’édition de scripts. Toutes les
informations de référence sur les objets et leurs propriétés et méthodes sont stockées dans le modèle, et
peuvent être affichées.
AppleScript
Suivez les étapes ci-dessous pour afficher le dictionnaire AppleScript d’InDesign :
1. Lancez InDesign.
2. Lancez l’éditeur de scripts Apple.
3. Dans l’éditeur de scripts, choisissez Fichier > Ouvrir un dictionnaire. L’éditeur de scripts affiche une liste
des applications prenant en charge les scripts.
Didacticiel de scripts Adobe InDesign CS3
Scripts et modèle d’objet InDesign
18
4. Sélectionnez votre copie d’InDesign, puis cliquez sur le bouton OK. L’éditeur de scripts affiche une liste
des suites (collections d’objets associés) d’InDesign.
5. Sélectionnez une suite pour afficher les objets et méthodes (commandes) qu’elle contient. Sélectionnez un objet pour voir les propriétés associées à cet objet.
JavaScript
Suivez les étapes ci-dessous pour afficher le modèle d’objet InDesign dans l’utilitaire Outils ExtendScript :
1. Lancez l’utilitaire Outils ExtendScript.
2. Choisissez le dictionnaire principal (main) InDesign CS3 dans le menu Aide. L’utilitaire Outils ExtendScript charge le dictionnaire InDesign et l’affichent dans une fenêtre séparée.
3. Dans la liste des classes, sélectionnez l’objet que vous voulez afficher, puis cliquez sur la propriété ou la
méthode que vous voulez voir de plus près dans la liste des propriétés et méthodes. L’utilitaire
Outils ExtendScript affiche d’autres informations sur la propriété ou la méthode sélectionnée :
Didacticiel de scripts Adobe InDesign CS3
Scripts et modèle d’objet InDesign
19
Remarque : pour plus de détails sur l’afficheur de modèle d’objet des outils ExtendScript, consultez le
Guide des outils JavaScript Creative Suite 3.
VBScript
Pour afficher le modèle d’objet InDesign, vous devez disposer d’un éditeur/débogueur VBScript ou d’une
version de Visual Basic, ou d’une application incorporant Visual Basic for Applications.
➤ Visual Basic 6
Suivez les étapes ci-dessous pour afficher le modèle d’objet à l’aide de Visual Basic 6 :
1. Créez un projet Visual Basic, puis choisissez la commande Projet > Références. Visual Basic affiche la
boîte de dialogue Références.
2. Dans la liste de références disponibles, sélectionnez l’option Adobe InDesign CS3 Type Library, puis
cliquez sur le bouton OK. Si la bibliothèque n’apparaît pas dans la liste de références disponibles,
cliquez sur le bouton Parcourir, puis recherchez et sélectionnez le fichier Resources for Visual Basic.tlb,
localisé généralement dans le dossier ~:\Documents and Settings\user_name\Application
Data\Adobe\InDesign\Version 5.0\Scripting Support\ (user_name étant votre nom d’utilisateur). Le cas échéant, recherchez le fichier. Après avoir localisé le fichier, cliquez sur le bouton Ouvrir
pour ajouter la référence à votre projet.
3. Sélectionnez Affichage > Explorateur d’objets. Visual Basic affiche la boîte de dialogue Explorateur
d’objets.
Didacticiel de scripts Adobe InDesign CS3
Scripts et modèle d’objet InDesign
20
4. Choisissez l’option InDesign dans la liste de bibliothèques ouvertes du menu Projet/Bibliothèque.
Visual Basic affiche les objets composant le modèle d’objet InDesign.
5. Cliquez sur une classe d’objet. Visual Basic affiche les propriétés et méthodes de l’objet. Pour obtenir
des informations sur une propriété ou une méthode, sélectionnez-la. Visual Basic affiche sa définition
au bas de la fenêtre Explorateur d’objets.
➤ Visual Basic.NET
Suivez les étapes ci-dessous pour afficher le modèle d’objet à l’aide de Visual Basic.NET :
1. Créez un projet Visual Basic, puis choisissez la commande Projet > Ajouter une référence. Visual Basic
affiche la boîte de dialogue d’ajout de référence.
2. Sélectionnez l’onglet COM.
3. Dans la liste de références disponibles, sélectionnez l’option Adobe InDesign CS3 Type Library, puis
cliquez sur le bouton Sélectionner. Visual Basic.NET ajoute la référence à la liste de composants sélectionnés. Si la bibliothèque n’apparaît pas dans la liste de références disponibles, cliquez sur le
bouton Parcourir, puis recherchez et sélectionnez le fichier Resources for Visual Basic.tlb, localisé généralement dans le dossier ~:\Documents and Settings\user_name\Application
Data\Adobe\InDesign\Version 5.0\Scripting Support\ (user_name étant votre nom d’utilisateur). Après avoir localisé le fichier, cliquez sur le bouton Ouvrir pour ajouter la référence à votre
projet.
Didacticiel de scripts Adobe InDesign CS3
Scripts et modèle d’objet InDesign
21
4. Cliquez sur OK.
5. Sélectionnez Affichage > Explorateur d’objets. Visual Basic affiche l’onglet Explorateur d’objets.
6. Choisissez l’option interop.indesign dans la liste de bibliothèques ouvertes de la fenêtre Objets.
Visual Basic.NET affiche les objets composant le modèle d’objet InDesign.
7. Cliquez sur une classe d’objet. Visual Basic.NET affiche les propriétés et méthodes de l’objet. Pour obtenir des informations sur une propriété ou une méthode, sélectionnez-la. Visual Basic.NET affiche sa
définition au bas de la fenêtre Explorateur d’objets.
➤ Visual Basic for Applications
Suivez les étapes ci-dessous pour afficher le modèle d’objet à l’aide de Visual Basic for Applications depuis
Microsoft Excel :
1. Lancez Excel.
2. Choisissez Outils > Macro, puis Visual Basic Editor. Excel affiche la fenêtre de l’éditeur Visual Basic.
3. Choisissez Outils > Références. L’éditeur Visual Basic affiche la boîte de dialogue d’ajout de références.
Didacticiel de scripts Adobe InDesign CS3
Scripts et modèle d’objet InDesign
22
4. Dans la liste de références disponibles, sélectionnez l’option Adobe InDesign CS3 Type Library, puis
cliquez sur le bouton Sélectionner. Visual Basic ajoute la référence à la liste de composants sélectionnés. Si la bibliothèque n’apparaît pas dans la liste de références disponibles, cliquez sur le
bouton Parcourir, puis recherchez et sélectionnez le fichier Resources for Visual Basic.tlb, localisé généralement dans le dossier ~:\Documents and Settings\user_name\Application
Data\Adobe\InDesign\Version 5.0\Scripting Support\ (user_name étant votre nom d’utilisateur). Après avoir localisé le fichier, cliquez sur le bouton OK pour ajouter la référence à votre projet.
5. Sélectionnez Affichage > Explorateur d’objets. L’éditeur Visual Basic affiche la fenêtre
Explorateur d’objets.
6. Choisissez InDesign dans le menu déroulant Bibliothèques. L’éditeur Visual Basic affiche une liste des
objets dans la bibliothèque d’objets InDesign.
7. Cliquez sur un nom d’objet. Visual Basic affiche les propriétés et méthodes de l’objet. Pour obtenir des
informations sur une propriété ou une méthode, sélectionnez-la. Visual Basic affiche sa définition au
bas de la fenêtre Explorateur d’objets.
Mesures et positionnement
Dans InDesign, tous les éléments et objets sont placés sur une page en fonction des mesures que vous
spécifiez. Il est très utile de connaître le fonctionnement du système de coordonnées d’InDesign et les
unités de mesure qu’il utilise.
Coordonnées
Comme tout autre programme de mise en page et de dessin, InDesign utilise une géométrie
bidimensionnelle pour enregistrer la position des objets sur une page ou une planche. La composante
horizontale d’une paire de coordonnées est appelée x et sa composante verticale y. Vous pouvez voir ces
coordonnées dans le panneau Transformation ou Contrôle lorsqu’un objet est sélectionné à l’aide de
l’outil Sélection. Comme dans l’interface utilisateur d’InDesign, les coordonnées sont mesurées par
rapport à l’emplacement actuel du point zéro.
Il existe une différence entre les coordonnées utilisées dans InDesign et le système de coordonnées
géométrique traditionnel. Sur l’axe vertical (ou y) d’InDesign, les coordonnées en dessous de zéro sont des
nombres positifs, et celles situées au-dessus, des nombres négatifs.
Ajout de caractéristiques à « Hello World » 23
Didacticiel de scripts Adobe InDesign CS3
Remarque : les coordonnées renvoyées par InDesign pour l’emplacement d’un point de chemin, sont
dans l’ordre x, y. Lorsque vous définissez l’emplacement d’un point de chemin, InDesign
attend les coordonnées dans le même ordre. InDesign renvoie certaines coordonnées dans
un ordre différent, et celles-ci doivent lui être renvoyées dans le même ordre. Les
délimitations géométriques et les délimitations visibles sont des tableaux de données
contenant quatre coordonnées. Ces coordonnées définissent dans l’ordre les bords supérieur,
gauche, inférieur et droit du cadre de sélection de l’objet (soit y1, x1, y2, x2).
Utilisation des unités de mesure
Pour envoyer des valeurs de mesure à InDesign, vous pouvez utiliser soit des nombres (14,65, par exemple),
soit des chaînes de mesure (1p7,1, par exemple). Si vous envoyez des nombres, InDesign utilise les unités
de mesure actives de la composition ; si vous envoyez des chaînes de mesure (voir le tableau ci-dessous),
InDesign utilise les unités de mesure spécifiées dans chaque chaîne.
InDesign renvoie les coordonnées et autres valeurs de mesure en utilisant les unités de mesure actives de
la composition. Dans certains cas, ces unités ne sont pas représentées de la même façon que dans le
panneau Transformation d’InDesign. Si le système de mesure actif est en picas, par exemple, InDesign
renvoie des valeurs fractionnaires sous forme de nombres décimaux, au lieu d’utiliser les conventions
« picas et points » du panneau Transformation. « 1p6 », par exemple, est renvoyé comme « 1,5 ». InDesign
procède de cette manière, car le système de scripts ne peut pas exécuter d’opération arithmétique avec
des chaînes de mesure ; si vous additionnez « 0p3,5 » et « 13p4 », par exemple, vous allez obtenir une
erreur de script ; en revanche, si vous additionnez 0,2916 et 13,333 (les mêmes mesures après leur
conversion), le résultat sera correct.
Si votre script dépend de l’addition, la soustraction, la multiplication ou la division de valeurs de mesure
spécifiques, il est préférable de convertir les unités de mesure correspondantes au début du script. A la fin
du script, vous pourrez convertir à nouveau les unités de mesure afin de leur rendre leur aspect initial.
Vous pouvez également utiliser des remplacements d’unités de mesures, comme dans beaucoup de nos
scripts d’exemple. Un remplacement d’unité de mesure est une chaîne contenant un caractère spécial,
comme dans le tableau suivant :
Remplacement
Signification
Exemple
c
Cicéros (le c peut être suivi de didots, si nécessaire)
1,4 c
cm
Centimètres
0,635 cm
po
Pouces
0,25 po
mm
Millimètres
6,35 mm
p
Picas (le p peut être suivi de points, si nécessaire)
1p6
pt
Points
18 pt
Ajout de caractéristiques à « Hello World »
Nous allons maintenant créer un script qui modifiera la composition « Hello World » créée avec notre
premier script. Vous effectuez les opérations suivantes :
●
Obtention du document actif
●
Utilisation d’une fonction (ou d’un gestionnaire dans AppleScript)
●
Obtention des dimensions et des marges des pages du document actif
Didacticiel de scripts Adobe InDesign CS3
●
Redimensionnement d’un bloc de texte
●
Changer la mise en forme du texte dans son bloc
Ajout de caractéristiques à « Hello World » 24
AppleScript
Ouvrez le script d’apprentissage ImprovedHelloWorld.applescript ou effectuez les étapes suivantes pour
créer le script :
1. Vérifiez que le document « Hello World » est bien ouvert. Si vous avez fermé le document sans l’enregistrer, exécutez le script HelloWorld.applescript de nouveau pour recréer le document.
2. Choisissez la commande Fichier > Nouveau dans l’éditeur de script pour créer un script.
3. Entrez le script ci-dessous.
--Improved "Hello World"
tell application "Adobe InDesign CS3"
--Get a reference to a font.
try
--Enter the name of a font on your system, if necessary.
set myFont to font "Helvetica"
end try
--Get the active document and assign
--the result to the variable "myDocument."
set myDocument to document 1
tell myDocument
--Use the handler "myGetBounds" to get the bounds of the
--"live area" inside the margins of page 1.
set myBounds to my myGetBounds(myDocument, page 1)
tell text frame 1 of page 1
--Resize the text frame to match the page margins.
set geometric bounds to myBounds
tell paragraph 1
--Change the font, size, and paragraph alignment.
try
set applied font to myFont
end try
set point size to 72
set justification to center align
end tell
end tell
end tell
end tell
--myGetBounds is a handler that returns the bounds
Didacticiel de scripts Adobe InDesign CS3
Ajout de caractéristiques à « Hello World » 25
--of the "live area" of a page.
on myGetBounds(myDocument, myPage)
tell application "Adobe InDesign CS2"
set myPageHeight to page height of document preferences of myDocument
set myPageWidth to page width of document preferences of myDocument
set myLeft to left of margin preferences of myPage
set myTop to top of margin preferences of myPage
set myRight to right of margin preferences of myPage
set myBottom to bottom of margin preferences of myPage
end tell
set myRight to myPageWidth - myLeft
set myBottom to myPageHeight - myBottom
return {myTop, myLeft, myBottom, myRight}
end myGetBounds
4. Enregistrez le script.
5. Exécutez le nouveau script.
JavaScript
Ouvrez le script d’apprentissage ImprovedHelloWorld.jsx ou effectuez les étapes suivantes pour créer
le script :
1. Vérifiez que le document « Hello World » est bien ouvert. Si vous avez fermé le document sans l’enregistrer, exécutez le script HelloWorld.jsx de nouveau pour recréer le document.
2. Entrez le JavaScript ci-dessous dans un nouveau fichier texte :
//Improved Hello World!
//Enter the name of a font on your system, if necessary.
myFont = app.fonts.item("Arial");
var myDocument = app.documents.item(0);
with(myDocument){
var myPage = pages.item(0);
var myBounds = myGetBounds(myPage,myDocument);
with(myDocument.pages.item(0)){
//Get a reference to the text frame.
var myTextFrame = textFrames.item(0);
//Change the size of the text frame.
myTextFrame.geometricBounds = myBounds;
var myParagraph = myTextFrame.paragraphs.item(0);
myParagraph.appliedFont = myFont;
myParagraph.justification = Justification.centerAlign;
myParagraph.pointSize = 48;
}
}
//myGetBounds calculates and return the bounds of the "live area" of the page.
function myGetBounds(myDocument, myPage){
var myWidth = myDocument.documentPreferences.pageWidth;
var myHeight = myDocument.documentPreferences.pageHeight;
var myX1 = myPage.marginPreferences.left;
var myY1 = myPage.marginPreferences.top;
var myX2 = myWidth - myPage.marginPreferences.right;
var myY2 = myHeight - myPage.marginPreferences.bottom;
return [myY1, myX1, myY2, myX2];
}
Didacticiel de scripts Adobe InDesign CS3
Ajout de caractéristiques à « Hello World » 26
3. Enregistrez le texte dans un fichier de texte brut avec l’extension .jsx dans le dossier Scripts Panel
(voir la section « Installation des scripts », page 4).
4. Pour exécuter le nouveau script, cliquez deux fois sur son nom dans le panneau Scripts d’InDesign.
VBScript
Ouvrez le script d’apprentissage ImprovedHelloWorld.vbs ou effectuez les étapes suivantes pour créer
le script :
1. Lancez un éditeur de texte (Bloc-notes, par exemple).
2. Vérifiez que le document « Hello World » est bien ouvert. Si vous avez fermé le document sans l’enregistrer, exécutez le script HelloWorld.vbs de nouveau pour recréer le document.
3. Entrez le script ci-dessous.
Set myInDesign = CreateObject("InDesign.Application.CS3")
Rem Enter the name of a font on your system, if necessary.
Set myFont = myInDesign.Fonts.Item("Arial")
Set myDocument = myInDesign.ActiveDocument
Set myPage = myDocument.Pages.Item(1)
Rem Get page width and page height using the function "myGetBounds".
myBounds = myGetBounds(myDocument, myPage)
Set myTextFrame = myPage.TextFrames.Item(1)
Rem Resize the text frame to match the publication margins.
myTextFrame.GeometricBounds = myBounds
Set myParagraph = myTextFrame.Paragraphs.Item(1)
Rem Change the font, size, and alignment.
If TypeName(myFont) <> "Nothing" Then
myParagraph.AppliedFont = myFont
End If
myParagraph.PointSize = 48
myParagraph.Justification = idJustification.idCenterAlign
Function myGetBounds(myDocument, myPage)
myPageHeight = myDocument.DocumentPreferences.PageHeight
myPageWidth = myDocument.DocumentPreferences.PageWidth
myTop = myPage.MarginPreferences.Top
myLeft = myPage.MarginPreferences.Left
myRight = myPage.MarginPreferences.Right
myBottom = myPage.MarginPreferences.Bottom
myRight = myPageWidth - myRight
myBottom = myPageHeight - myBottom
myGetBounds = Array(myTop, myLeft, myBottom, myRight)
End Function
4. Enregistrez le texte dans un fichier de texte brut avec l’extension .vbs dans le dossier Scripts (voir la
section « Installation des scripts », page 4).
5. Pour exécuter le nouveau script, cliquez deux fois sur son nom dans le panneau Scripts d’InDesign.
Didacticiel de scripts Adobe InDesign CS3
Construction d’un document
27
Construction d’un document
Le script « Hello World! » n’est pas particulièrement pratique pour votre travail quotidien. Vous pouvez
utiliser un script InDesign à tout moment dans votre processus de production. Toutefois, nous
commencerons par créer des scripts débutant au même point que vous, en créant des documents,
définissant des marges de page et créant et appliquant des pages types. L’illustration suivante répertorie
les objets que vous allez utiliser.
.
document
viewPreferences
horizontalMeasurementUnits
verticalMeasurementUnits
rulerOrigin
masterSpreads.item(0)
pages.item(0)
marginPreferences
top
left
bottom
right
columnCount
columnGutter
Dans cette section, nous proposons de créer un long script composé de courts blocs de code. Chaque bloc
indique une zone ou opération spécifique de création de script InDesign. Lorsque vous atteignez chaque
bloc, vous pouvez exécuter le script pour observer le résultat. Si vous utilisez le langage AppleScript, vous
devrez insérer le texte end tell à la fin du script avant de l’exécuter, puis supprimer ce texte avant de
continuer.
Remarque : l’illustration ci-dessus utilise la version JavaScript des termes de scripts. Pour le
langage AppleScript, vous ajoutez des espaces entre les mots (view preferences, au lieu de
viewPreferences) ; pour le langage VBScript, vous utilisez un numéro d’élément
commençant à 1, au lieu de 0 (masterSpreads.item(1), au lieu de
masterSpreads.item(0)).
Les objets dans le modèle d’objet correspondent en général aux noms des commandes dans l’interface
utilisateur, comme indiqué dans l’illustration suivante (laquelle utilise aussi la forme JavaScript des termes
de création de scripts) :
Didacticiel de scripts Adobe InDesign CS3
Construction d’un document
28
app.gridPreferences
or
document.gridPreferences
baselineColor
baselineStart
baselineGridRelativeOption
baselineDivision
baselineViewThreshold
gridColor
verticalGridlineDivision
verticalGridSubdivision
horizontalGridlineDivision
horizontalGridSubdivision
gridsInBack
baselineGridShown
documentGridShown
documentGridSnapTo
Configuration des unités de mesure et des marges des planches types
Le script suivant indique la procédure de création d’un document et définit les marges de la première
planche type. Dans cette section, nous vous proposons de suivre la procédure de création d’un script
complexe composé de simples pièces maîtresses de code de script. Lancez votre éditeur de script, puis
insérez les lignes suivantes en un langage de script de votre choix. Chaque fois que vous insérez un bloc de
code, enregistrez le script dans votre dossier Scripts Panel (voir la section « Installation des scripts »,
page 4).
Didacticiel de scripts Adobe InDesign CS3
Construction d’un document
AppleScript
Entrez le code suivant dans l’éditeur de script ou ouvrez le script d’apprentissage
DocumentConstruction.applescript :
tell application "Adobe InDesign CS3"
--Create a new document.
set myDocument to make document
--Set the measurement units and ruler origin.
set horizontal measurement units of view preferences to points
set vertical measurement units of view preferences to points
set ruler origin of view preferences to page origin
--Get a reference to the first master spread.
set myMasterSpread to master spread 1 of myDocument
--Get a reference to the margin preferences of
--the first page in the master spread.
set myMarginPreferences to margin preferences of page 1 of myMasterSpread
--Now set up the page margins and columns.
set left of myMarginPreferences to 84
set top of myMarginPreferences to 70
set right of myMarginPreferences to 70
set bottom of myMarginPreferences to 78
set column count of myMarginPreferences to 3
set column gutter of myMarginPreferences to 14
--Page margins and columns for the right-hand page.
set myMarginPreferences to margin preferences of page 2 of myMasterSpread
set left of myMarginPreferences to 84
set top of myMarginPreferences to 70
set right of myMarginPreferences to 70
set bottom of myMarginPreferences to 78
set column count of myMarginPreferences to 3
set column gutter of myMarginPreferences to 14
29
Didacticiel de scripts Adobe InDesign CS3
Construction d’un document
30
JavaScript
Entrez le code suivant dans l’utilitaire Outils ExtendScript ou ouvrez le script
d’apprentissage DocumentConstruction.jsx :
//Create a new document.
var myDocument = app.documents.add();
//Set the measurement units and ruler origin.
myDocument.viewPreferences.horizontalMeasurementUnits =
MeasurementUnits.points;
myDocument.viewPreferences.verticalMeasurementUnits = MeasurementUnits.points;
myDocument.viewPreferences.rulerOrigin = RulerOrigin.pageOrigin;
//Get a reference to the first master spread.
var myMasterSpread = myDocument.masterSpreads.item(0);
//Get a reference to the margin preferences of the first page in the master
spread.
var myMarginPreferences = myMasterSpread.pages.item(0).marginPreferences;
//Now set up the page margins and columns.
myMarginPreferences.left = 84;
myMarginPreferences.top = 70;
myMarginPreferences.right = 70;
myMarginPreferences.bottom = 78;
myMarginPreferences.columnCount = 3;
myMarginPreferences.columnGutter = 14;
//Page margins and columns for the right-hand page.
var myMarginPreferences = myMasterSpread.pages.item(1).marginPreferences;
myMarginPreferences.left = 84;
myMarginPreferences.top = 70;
myMarginPreferences.right = 70;
myMarginPreferences.bottom = 78;
myMarginPreferences.columnCount = 3;
myMarginPreferences.columnGutter = 14;
Didacticiel de scripts Adobe InDesign CS3
Construction d’un document
31
VBScript
Entrez le code suivant dans votre script ou éditeur de texte ou ouvrez le script
d’apprentissage DocumentConstruction.vbs :
Set myInDesign = CreateObject("InDesign.Application.CS3")
Rem Create a new document.
Set myDocument = myInDesign.Documents.Add()
Rem Set the measurement units and ruler origin.
myDocument.ViewPreferences.HorizontalMeasurementUnits =
idMeasurementUnits.idPoints
myDocument.ViewPreferences.VerticalMeasurementUnits =
idMeasurementUnits.idPoints
myDocument.ViewPreferences.RulerOrigin = idRulerOrigin.idPageOrigin
Rem Get a reference to the first master spread.
Set myMasterSpread = myDocument.MasterSpreads.Item(1)
Rem Get a reference to the margin preferences of the first page in the master
spread.
Set myMarginPreferences = myMasterSpread.Pages.Item(1).MarginPreferences
Rem Now set up the page margins and columns.
myMarginPreferences.Left = 84
myMarginPreferences.Top = 70
myMarginPreferences.Right = 70
myMarginPreferences.Bottom = 78
myMarginPreferences.ColumnCount = 3
myMarginPreferences.ColumnGutter = 14
Rem Page margins and columns for the right-hand page.
Set myMarginPreferences = myMasterSpread.Pages.Item(2).MarginPreferences
myMarginPreferences.Left = 84
myMarginPreferences.Top = 70
myMarginPreferences.Right = 70
myMarginPreferences.Bottom = 78
myMarginPreferences.ColumnCount = 3
myMarginPreferences.ColumnGutter = 14
Ajout d’une grille de ligne de base
Maintenant que la planche type est configurée, nous pouvons ajouter une grille de ligne de base. Ajoutez
les lignes de script suivantes (en langage approprié) à la fin du script que vous avez créé plus haut. Voici
une autre illustration (avec les termes de scripts en langage JavaScript) :
:
document
gridPreferences
baselineDivision
baselineStart
baselineGridShown
AppleScript
set
set
set
set
myGridPreferences to grid preferences
baseline division of myGridPreferences to 14
baseline start of myGridPreferences to 70
baseline grid shown of myGridPreferences to true
Didacticiel de scripts Adobe InDesign CS3
Construction d’un document
32
JavaScript
var myGridPreferences = myDocument.gridPreferences;
myGridPreferences.baselineDivision = 14;
myGridPreferences.baselineStart = 70;
myGridPreferences.baselineGridShown = true;
VBScript
Set myGridPreferences = myDocument.GridPreferences
myGridPreferences.BaselineDivision = 14
myGridPreferences.BaselineStart = 70
myGridPreferences.BaselineGridShown = True
Ajout d’éléments de gabarit
Ajoutez maintenant deux blocs de texte sur les pages de gabarit. Ces blocs sont destinés à contenir le
caractère spécial de numérotation de page automatique et seront positionnés au bas de la page.
Dans l’exemple « Hello World », nous avons créé un bloc de texte et spécifié sa position et sa taille à l’aide
de la propriété de délimitation géométrique (un tableau de données contenant les coordonnées des
bords supérieur, gauche, inférieur et droit du bloc). Ces coordonnées correspondent aux coins du bloc,
comme ils apparaîtraient dans le panneau Contrôle. Les délimitations géométriques sont : haut = 728,
gauche = 70, bas = 742 et droite = 528, comme indiqué dans les deux illustrations suivantes :
Didacticiel de scripts Adobe InDesign CS3
Construction d’un document
AppleScript
set myLeftPage to page 1 of myMasterSpread
set myRightPage to page 2 of myMasterSpread
tell myLeftPage
set myLeftFooter to make text frame
set geometric bounds of myLeftFooter to {728, 70, 742, 528}
set first baseline offset of text frame preferences of myLeftFooter to
leading offset
set contents of myLeftFooter to auto page number
set point size of character 1 of parent story of myLeftFooter to 11
set leading of character 1 of myLeftFooter to 14
end tell
tell myRightPage
set myRightFooter to make text frame
set geometric bounds of myRightFooter to {728, 84, 742, 542}
set first baseline offset of text frame preferences of myRightFooter to
leading offset
set contents of myRightFooter to auto page number
set point size of character 1 of parent story of myRightFooter to 11
set leading of character 1 of myRightFooter to 14
set justification of character 1 of myRightFooter to right align
end tell
JavaScript
var myMasterSpread = myDocument.masterSpreads.item(0);
var myLeftPage = myMasterSpread.pages.item(0);
var myRightPage = myMasterSpread.pages.item(1);
var myLeftFooter = myLeftPage.textFrames.add();
myLeftFooter.geometricBounds = [728, 70, 742, 528];
myLeftFooter.textFramePreferences.firstBaselineOffset =
FirstBaseline.leadingOffset;
myLeftFooter.contents = SpecialCharacters.autoPageNumber;
myLeftFooter.parentStory.characters.item(0).pointSize = 11;
myLeftFooter.parentStory.characters.item(0).leading = 14;
var myRightFooter = myRightPage.textFrames.add();
myRightFooter.geometricBounds = [728, 84, 742, 542];
myRightFooter.textFramePreferences.firstBaselineOffset =
FirstBaseline.leadingOffset;
myRightFooter.contents = SpecialCharacters.autoPageNumber;
myRightFooter.parentStory.characters.item(0).pointSize = 11;
myRightFooter.parentStory.characters.item(0).leading = 14;
myRightFooter.parentStory.characters.item(0).justification =
Justification.rightAlign;
33
Didacticiel de scripts Adobe InDesign CS3
Construction d’un document
34
VBScript
Set myMasterSpread = myDocument.MasterSpreads.Item(1)
Set myLeftPage = myMasterSpread.Pages.Item(1)
Set myRightPage = myMasterSpread.Pages.Item(2)
Set myLeftFooter = myLeftPage.TextFrames.Add
myLeftFooter.GeometricBounds = Array(728, 70, 742, 528)
myLeftFooter.TextFramePreferences.FirstBaselineOffset =
idFirstBaseline.idLeadingOffset
myLeftFooter.Contents = idSpecialCharacters.idAutoPageNumber
myLeftFooter.ParentStory.Characters.Item(1).PointSize = 11
myLeftFooter.ParentStory.Characters.Item(1).Leading = 14
Set myRightFooter = myRightPage.TextFrames.Add()
myRightFooter.GeometricBounds = Array(728, 84, 742, 542)
myRightFooter.TextFramePreferences.FirstBaselineOffset =
idFirstBaseline.idLeadingOffset
myRightFooter.Contents = idSpecialCharacters.idAutoPageNumber
myRightFooter.ParentStory.Characters.Item(1).PointSize = 11
myRightFooter.ParentStory.Characters.Item(1).Leading = 14
myRightFooter.ParentStory.Characters.Item(1).Justification =
idJustification.idRightAlign
Ajout de blocs de texte types
Nous allons ajouter maintenant des blocs de texte types. L’illustration de bloc suivante indique les objets
et propriétés qui seront utilisés (la forme JavaScript des termes de script est utilisée) :
document
masterSpreads.item(0)
pages.item(0)
textFrames.item(0)
textFramePreferences
firstBaselineOffset
textColumnCount
textColumnGutter
geometricBounds
label
nextTextFrame
Didacticiel de scripts Adobe InDesign CS3
Construction d’un document
AppleScript
tell myLeftPage
set myLeftTextFrame to make text frame
set geometric bounds of myLeftTextFrame to {70, 70, 714, 528}
set first baseline offset of text frame preferences of myLeftTextFrame to
leading offset
set text column count of text frame preferences of myLeftTextFrame to 3
set text column gutter of text frame preferences of myLeftTextFrame to 14
--Add a label to make the frame easier to find later on.
set label of myLeftTextFrame to "BodyTextFrame"
end tell
tell myRightPage
set myRightTextFrame to make text frame
set geometric bounds of myRightTextFrame to {70, 84, 714, 542}
set first baseline offset of text frame preferences of myRightTextFrame to
leading offset
set text column count of text frame preferences of myRightTextFrame to 3
set text column gutter of text frame preferences of myRightTextFrame to 14
--Add a label to make the frame easier to find later on.
set label of myRightTextFrame to "BodyTextFrame"
end tell
--Link the two frames using the next text frame property.
set next text frame of myLeftTextFrame to myRightTextFrame
35
Didacticiel de scripts Adobe InDesign CS3
Construction d’un document
JavaScript
var myLeftPage = myMasterSpread.pages.item(0);
var myRightPage = myMasterSpread.pages.item(1);
var myLeftTextFrame = myLeftPage.textFrames.add();
myLeftTextFrame.geometricBounds = [70, 70, 714, 528];
myLeftTextFrame.textFramePreferences.firstBaselineOffset =
FirstBaseline.leadingOffset;
myLeftTextFrame.textFramePreferences.textColumnCount = 3;
myLeftTextFrame.textFramePreferences.textColumnGutter = 14;
//Add a label to make the frame easier to find later on.
myLeftTextFrame.label = "BodyTextFrame";
var myRightTextFrame = myRightPage.textFrames.add();
myRightTextFrame.geometricBounds = [70, 84, 714, 542];
myRightTextFrame.textFramePreferences.firstBaselineOffset =
FirstBaseline.leadingOffset;
myRightTextFrame.textFramePreferences.textColumnCount = 3;
myRightTextFrame.textFramePreferences.textColumnGutter = 14;
//Add a label to make the frame easier to find later on.
myRightTextFrame.label = "BodyTextFrame";
//Link the two frames using the nextTextFrame property.
myLeftTextFrame.nextTextFrame = myRightTextFrame;
VBScript
Set myLeftTextFrame = myLeftPage.TextFrames.Add
myLeftTextFrame.GeometricBounds = Array(70, 70, 714, 528)
myLeftTextFrame.TextFramePreferences.FirstBaselineOffset =
idFirstBaseline.idLeadingOffset
myLeftTextFrame.TextFramePreferences.TextColumnCount = 3
myLeftTextFrame.TextFramePreferences.TextColumnGutter = 14
Rem Add a label to make the frame easier to find later on.
myLeftTextFrame.Label = "BodyTextFrame"
Set myRightTextFrame = myRightPage.TextFrames.Add
myRightTextFrame.GeometricBounds = Array(70, 84, 714, 542)
myRightTextFrame.TextFramePreferences.FirstBaselineOffset =
idFirstBaseline.idLeadingOffset
myRightTextFrame.TextFramePreferences.TextColumnCount = 3
myRightTextFrame.TextFramePreferences.TextColumnGutter = 14
Rem Add a label to make the frame easier to find later on.
myRightTextFrame.Label = "BodyTextFrame"
Rem Link the two frames using the nextTextFrame property.
myLeftTextFrame.NextTextFrame = myRightTextFrame
Remplacement des éléments de gabarit et ajout de texte
Nous allons maintenant remplacer l’un des blocs de texte du gabarit créé précédemment et ajouter du
texte. Comme auparavant, ajoutez le script suivant à la fin du script que vous avez déjà créé :
36
Didacticiel de scripts Adobe InDesign CS3
Construction d’un document
37
AppleScript
tell text frame 1 of page 2 of master spread 1 of myDocument
set myTextFrame to override destination page page 1 of myDocument
end tell
--Add text by setting the contents of an insertion point to a string.
--In AppleScript, "return" is a return character.
set contents of insertion point 1 of myTextFrame to "Headline!" & return
JavaScript
var myTextFrame =
myDocument.masterSpreads.item(0).pages.item(1).textFrames.item(0).override(my
Document.pages.item(0));
//Add text by setting the contents of an insertion point to a string.
//In JavaScript, "\r" is a return character.
myTextFrame.insertionPoints.item(0).contents = "Headline!\r";
VBScript
Set myTextFrame =
myDocument.MasterSpreads.Item(1).Pages.Item(2).TextFrames.Item(1).Override(my
Document.Pages.Item(1))
Rem Add text by setting the contents of an insertion point to a string.
Rem In VBScript, vbCr is a return character.
myTextFrame.InsertionPoints.Item(1).Contents = "Headline!" & vbCr
Ajout et application d’un style de paragraphe
Nous proposons d’ajouter un style de paragraphe au titre pour le mettre en forme. Pour cela, nous devons
créer le style de paragraphe. L’illustration suivante indique les objets et propriétés qui seront utilisés
(encore une fois, la forme JavaScript des termes de script est utilisée dans le texte) :
document
paragraphStyles
paragraphStyle
appliedFont
fontStyle
pointSize
spaceBefore
spaceAfter
fillColor
Didacticiel de scripts Adobe InDesign CS3
Construction d’un document
38
AppleScript
--First, check to see if the paragraph style already exists.
try
set myParagraphStyle to paragraph style "Heading 1" of myDocument
on error
--The paragraph style did not exist, so create it.
tell myDocument
set myParagraphStyle to make paragraph style with properties
{name:"Heading 1"}
end tell
end try
--We'll need to create a color. Check to see if the color already exists.
try
set myColor to color "Red"
on error
--The color did not exist, so create it.
set myColor to make color with properties {name:"Red", model:process, color
value:{0, 100, 100, 0}}
end try
--Now set the formatting of the paragraph style.
set applied font of myParagraphStyle to "Arial"
set font style of myParagraphStyle to "Bold"
set point size of myParagraphStyle to 24
set space after of myParagraphStyle to 24
set space before of myParagraphStyle to 24
set fill color of myParagraphStyle to color "Red" of myDocument
--Apply the style to the paragraph.
tell paragraph 1 of myTextFrame to apply paragraph style using myParagraphStyle
with clearing overrides
--You could also use:
--set applied paragraph style of paragraph 1 of myTextFrame to myParagraphStyle
JavaScript
var myParagraphStyle = myDocument.paragraphStyles.item("Heading 1");
try {
var myName = myParagraphStyle.name;
}
catch (myError){
//The paragraph style did not exist, so create it.
myParagraphStyle = myDocument.paragraphStyles.add({name:"Heading 1"});
}
//We'll need to create a color. Check to see if the color already exists.
var myColor = myDocument.colors.item("Red");
try {
myName = myColor.name;
}
catch (myError){
//The color did not exist, so create it.
myColor = myDocument.colors.add({name:"Red", model:ColorModel.process,
colorValue:[0,100,100,0]});
Didacticiel de scripts Adobe InDesign CS3
Construction d’un document
39
}
//Now set the formatting of the paragraph style.
myParagraphStyle.appliedFont = "Arial";
myParagraphStyle.fontStyle = "Bold";
myParagraphStyle.pointSize = 24;
myParagraphStyle.spaceAfter = 24;
myParagraphStyle.spaceBefore = 24;
myParagraphStyle.fillColor = myDocument.colors.item("Red");
//Apply the style to the paragraph.
myDocument.pages.item(0).textFrames.item(0).paragraphs.item(0).applyParagraph
Style(
myParagraphStyle, true);
//You could also use:
//myDocument.pages.item(0).textFrames.item(0).paragraphs.item(0).appliedParag
raphStyle = myParagraphStyle;
VBScript
Rem First, check to see if the paragraph style already exists.
Rem to do this, we disable error checking:
On Error Resume Next
Set myParagraphStyle = myDocument.ParagraphStyles.Item("Heading 1")
Rem if an error occurred on the previous line, then the paragraph
Rem style did not exist.
If Error.Number <> 0 Then
Set myParagraphStyle = myDocument.ParagraphStyles.Add
myParagraphStyle.Name = "Heading 1"
Error.Clear
End If
Rem We'll need to create a color. Check to see if the color already exists.
Set myColor = myDocument.Colors.Item("Red")
If Error.Number <> 0 Then
Set myColor = myDocument.Colors.Add
myColor.Name = "Red"
myColor.Model = idColorModel.idProcess
myColor.colorValue = Array(0, 100, 100, 0)
Error.Clear
End If
Rem Resume normal error handling.
On Error GoTo 0
Rem Now set the formatting of the paragraph style.
myParagraphStyle.AppliedFont = "Arial"
myParagraphStyle.FontStyle = "Bold"
myParagraphStyle.PointSize = 24
myParagraphStyle.SpaceAfter = 24
myParagraphStyle.SpaceBefore = 24
myParagraphStyle.FillColor = myDocument.Colors.Item("Red")
Rem Apply the style to the paragraph.
myDocument.Pages.Item(1).TextFrames.Item(1).Paragraphs.Item(1).ApplyParagraph
Style myParagraphStyle, True
Rem You could also use:
Rem
myDocument.pages.item(1).textFrames.item(1).paragraphs.item(1).appliedParagra
phStyle = myParagraphStyle
Didacticiel de scripts Adobe InDesign CS3
Construction d’un document
Importation d’un fichier texte
Nous sommes prêts maintenant à importer un fichier texte. Le texte est ajouté à la suite du titre, dans le
premier bloc de texte, sur la première page. Le script ouvre une boîte de dialogue dans laquelle vous
pouvez sélectionner le fichier texte à importer. Comme auparavant, ajoutez le script suivant à la fin du
script que vous avez déjà créé :
AppleScript
--Display a standard open file dialog box to select a text file.
set myTextFile to choose file ("Choose a text file")
--If a text file was selected, and if you didn't press Cancel,
--place the text file at the first insertion point after the headline.
if myTextFile is not "" then
tell insertion point -1 of myTextFrame to place myTextFile
end if
JavaScript
//Display a standard open file dialog box to select a text file.
var myTextFile = File.openDialog("Choose a text file");
//If a text file was selected, and if you didn't press Cancel,
//place the text file at the first insertion point after the headline.
if((myTextFile != "")&&(myTextFile != null)){
myTextFrame.insertionPoints.item(-1).place(myTextFile);
}
VBScript
Rem Display a standard open file dialog box to select a text file.
Rem VBScript does not have the ability to do this, so we'll use
Rem a JavaScript to get a file name. We'll run the JavaScript using
Rem InDesign's DoScript feature.
Rem Disable normal error handling.
On Error Resume Next
Rem Create a JavaScript as a string.
myJavaScriptString = "var myTextFile = File.openDialog(""Choose a text
file"");myTextFile.fsName;"
Rem Run the JavaScript using DoScript.
myFileName = myInDesign.DoScript(myJavaScriptString,
idScriptLanguage.idJavascript)
If Error.Number = 0 Then
Rem Place the text file at the end of the text frame.
myTextFrame.InsertionPoints.Item(-1).Place myFileName
Error.Clear
End If
Rem Restore normal error handling.
On Error GoTo 0
40
Didacticiel de scripts Adobe InDesign CS3
Construction d’un document
41
Importation d’une image
Vous importez une image tout comme s’il s’agissait d’un fichier texte. Le script ouvre une boîte de dialogue
dans laquelle vous pouvez sélectionner l’image à importer. Lors de l’importation de l’image, InDesign
renvoie une référence à l’image elle-même, plutôt qu’au bloc qui la contient. Pour obtenir une référence au
bloc, utilisez la propriété parent de l’image. Une fois cette référence obtenue, vous pouvez appliquer un
style d’objet au bloc. Comme auparavant, ajoutez le script suivant à la fin du script que vous avez déjà créé :
AppleScript
--Display a standard open file dialog box to select a graphic file.
set myGraphicFile to choose file "Choose graphic file."
--If a graphic file was selected, and if you didn't press Cancel,
--place the graphic file on the page.
if myGraphicFile is not "" then
set myGraphic to place myGraphicFile on page 1 of myDocument
--Since you can place multiple graphics at once, the place method
--returns an array. To get the graphic you placed, get the first
--item in the array.
set myGraphic to item 1 of myGraphic
--Create an object style to apply to the graphic frame.
try
set myObjectStyle to object style "GraphicFrame" of myDocument on error
--The object style did not exist, so create it.
tell myDocument
set myObjectStyle to make object style with properties
{name:"GraphicFrame"}
end tell
end try
set enable stroke of myObjectStyle to true
set stroke weight of myObjectStyle to 3
set stroke type of myObjectStyle to stroke style "Solid" of myDocument
set stroke color of myObjectStyle to color "Red" of myDocument
--The frame containing the graphic is the parent of the graphic.
set myFrame to parent of myGraphic
tell myFrame to apply object style using myObjectStyle
--Resize the frame to a specific size.
set geometric bounds of myFrame to {0, 0, 144, 144}
--Fit the graphic to the frame proportionally.
fit myFrame given proportionally
--Next, fit frame to the resized graphic.
fit myFrame given frame to content
set myBounds to geometric bounds of myFrame
set myGraphicWidth to (item 4 of myBounds) - (item 2 of myBounds)
--Move the graphic frame.
set myPageWidth to page width of document preferences of myDocument
set myMarginPreferences to margin preferences of page 1 of myDocument
set myTopMargin to top of myMarginPreferences
move myFrame to {myPageWidth - myGraphicWidth, myTopMargin}
--Apply a text wrap to the graphic frame.
set text wrap type of text wrap preferences of myFrame to bounding box
text wrap
set text wrap offset of text wrap preferences of myFrame to {24, 12, 24,
12}
end if
end tell
Didacticiel de scripts Adobe InDesign CS3
Construction d’un document
JavaScript
//Display a standard open file dialog box to select a graphic file.
var myGraphicFile = File.openDialog("Choose a graphic file");
//If a graphic file was selected, and if you didn't press Cancel,
//place the graphic file on the page.
if((myGraphicFile != "")&&(myGraphicFile != null)){
var myGraphic = myDocument.pages.item(0).place(myGraphicFile);
//Since you can place multiple graphics at once, the place method
//returns an array. To get the graphic you placed, get the first
//item in the array (JavaScript arrays start with item 0).
myGraphic = myGraphic[0];
//Create an object style to apply to the graphic frame.
var myObjectStyle = myDocument.objectStyles.item("GraphicFrame");
try {
var myName = myObjectStyle.name;
}
catch (myError){
//The object style did not exist, so create it.
myObjectStyle = myDocument.objectStyles.add({name:"GraphicFrame"});
}
myObjectStyle.enableStroke = true;
myObjectStyle.strokeWeight = 3;
myObjectStyle.strokeType = myDocument.strokeStyles.item("Solid");
myObjectStyle.strokeColor = myDocument.colors.item("Red");
//The frame containing the graphic is the parent of the graphic.
var myFrame = myGraphic.parent;
myFrame.applyObjectStyle(myObjectStyle, true);
//Resize the frame to a specific size.
myFrame.geometricBounds = [0,0,144,144];
//Fit the graphic to the frame proportionally.
myFrame.fit(FitOptions.proportionally);
//Next, fit frame to the resized graphic.
myFrame.fit(FitOptions.frameToContent);
var myBounds = myFrame.geometricBounds;
var myGraphicWidth = myBounds[3]-myBounds[1];
//Move the graphic frame.
var myPageWidth = myDocument.documentPreferences.pageWidth;
var myTopMargin = myDocument.pages.item(0).marginPreferences.top;
myFrame.move([myPageWidth-myGraphicWidth, myTopMargin]);
//Apply a text wrap to the graphic frame.
myFrame.textWrapPreferences.textWrapType =
TextWrapTypes.boundingBoxTextWrap;
myFrame.textWrapPreferences.textWrapOffset = [24, 12, 24, 12];
}
42
Didacticiel de scripts Adobe InDesign CS3
Construction d’un document
VBScript
Rem create an object style
On Error Resume Next
Set myObjectStyle = myDocument.ObjectStyles.Item("GraphicFrame")
If Error.Number <> 0 Then
Set myObjectStyle = myDocument.ObjectStyles.Add
myObjectStyle.Name = "GraphicFrame"
Error.Clear
End If
On Error GoTo 0
myObjectStyle.EnableStroke = True
myObjectStyle.StrokeWeight = 3
myObjectStyle.StrokeType = myDocument.StrokeStyles.Item("Solid")
myObjectStyle.StrokeColor = myDocument.Colors.Item("Red")
Rem Again, we'll use a JavaScript to get a file name.
Rem Disable normal error handling.
On Error Resume Next
Rem Create a JavaScript as a string.
myJavaScriptString = "var myTextFile = File.openDialog(""Choose a graphic
file"");myTextFile.fsName;"
Rem Run the JavaScript using DoScript.
myGraphicFileName = myInDesign.DoScript(myJavaScriptString,
idScriptLanguage.idJavascript)
If Error.Number = 0 Then
On Error GoTo 0
Set myGraphic = myDocument.Pages.Item(1).Place(myGraphicFileName)
Rem Since you can place multiple graphics at once, the place method
Rem returns an object collection. To get the graphic you placed, get the
first
Rem item in the collection.
Set myGraphic = myGraphic.Item(1)
Rem Create an object style to apply to the graphic frame.
Rem The frame containing the graphic is the parent of the graphic.
Set myFrame = myGraphic.Parent
myFrame.ApplyObjectStyle myObjectStyle, True
Rem Resize the frame to a specific size.
myFrame.GeometricBounds = Array(0, 0, 144, 144)
Rem Fit the graphic to the frame proportionally.
myFrame.Fit idFitOptions.idProportionally
Rem Next, fit frame to the resized graphic.
myFrame.Fit idFitOptions.idFrameToContent
myBounds = myFrame.GeometricBounds
myGraphicWidth = myBounds(3) - myBounds(1)
Rem Move the graphic frame.
myPageWidth = myDocument.DocumentPreferences.PageWidth
myTopMargin = myDocument.Pages.Item(1).MarginPreferences.Top
myFrame.Move Array(myPageWidth - myGraphicWidth, myTopMargin)
Rem Apply a text wrap to the graphic frame.
myFrame.TextWrapPreferences.TextWrapType =
idTextWrapTypes.idBoundingBoxTextWrap
myFrame.TextWrapPreferences.TextWrapOffset = Array(24, 12, 24, 12)
End If
43
Didacticiel de scripts Adobe InDesign CS3
Au-delà des notions de base 44
Au-delà des notions de base
Désormais, vous savez comment créer un document, configurer des éléments de gabarit, entrer du texte,
importer du texte, créer et appliquer des styles de paragraphe, créer et appliquer des styles d’objet,
importer des images, adapter des images aux blocs et appliquer un habillage de texte. Le document que
vous avez créé est un document simple, mais qui vous a permis de maîtriser les notions de base de la
création de scripts InDesign. Pour chaque exemple, nous avons créé des objets, défini des propriétés
d’objet et utilisé des méthodes d’objet.
Consultez le Guide de scripts Adobe InDesign CS3 pour passer à l’étape d’apprentissage de création de
scripts InDesign suivante. Ce guide vous propose des didacticiels plus avancés traitant de la construction
de documents, la mise en forme du texte, la recherche et le remplacement de texte, la création d’interfaces
utilisateur, l’ajout de commandes de menu, ainsi que l’utilisation du langage XML et des règles XML.
Pour plus de détails sur les scripts InDesign, visitez le forum des utilisateurs pour les scripts InDesign (en
anglais), à l’adresse suivante : http://www.adobeforums.com. Dans le forum, les créateurs de scripts
peuvent poser des questions, envoyer des réponses et partager leurs dernières compositions. Le forum
contient plusieurs centaines d’exemples de scripts.
Consultez également la page d’accueil des scripts InDesign, à l’adresse suivante :
http://www.adobe.com/products/indesign/xml_scripting.html pour obtenir d’autres informations sur les
scripts InDesign.
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement