Modules externes de l’éditeur

Comment utiliser les menus, outils, objets et panneaux que les modules externes installés ajoutent à l’éditeur. L’installation, l’activation et la désactivation des modules se font dans le portail (article « Modules externes »).

Chargement des modules externes

À l’ouverture d’une mise en page, l’éditeur charge les modules installés et activés dans l’onglet Plug-ins du tableau de bord. Un module installé ou activé après l’ouverture de l’éditeur n’apparaît qu’après actualisation de l’onglet.

Les modules payants ne sont chargés que si vous les avez achetés ou êtes en période d’essai. Si l’essai d’un module payant est terminé ou que vous ne l’avez pas acheté, un message s’affiche à l’ouverture d’une mise en page et le menu Modules externes contient une entrée indiquant qu’un achat est nécessaire. Un clic ouvre Galerie › Extensions du portail dans un nouvel onglet. Après l’achat, actualisez l’onglet.

Les modules externes ne sont pas chargés en mode observateur, en mode invité, en mode lecture ni dans les fenêtres ouvertes par un lien public. Dans ces fenêtres, les objets créés avec un module s’affichent tout de même tels qu’ils ont été enregistrés.

Questions associées

• Le plugin installé n’apparaît pas dans l’éditeur
• Les plugins fonctionnent-ils en mode lecture ?
• Le menu des modules indique qu’un achat est nécessaire

Menu des modules externes

Dans la barre supérieure, à droite, entre Informations sur la mise en page et le menu Fichier, apparaît le menu Modules externes en forme de pièce de puzzle. Chaque module y a son sous-menu, qui contient les commandes qu’il ajoute. Si une commande a un raccourci, celui-ci s’affiche à droite de l’entrée.

S’il n’y a aucune entrée à y placer, le menu Modules externes lui-même n’apparaît pas. Certains modules n’ajoutent que des outils ou des raccourcis : un module peut donc fonctionner même sans menu.

Si un module a une nouvelle version vers laquelle vous pouvez mettre à niveau, ce menu affiche un élément correspondant (si la nouvelle version utilise de nouvelles autorisations, il indique qu’un accord est nécessaire). Un clic ouvre l’onglet Plug-ins du portail dans un nouvel onglet, où vous faites la mise à niveau. Jusque-là, la version actuelle continue de fonctionner.

Questions associées

• Je ne vois pas le menu des plugins
• Où lancer une commande d’un module externe ?
• Le menu des plugins indique qu’une nouvelle version est disponible

Outils et raccourcis des modules externes

Les outils ajoutés par un module se placent comme boutons à la fin de la barre d’outils, à gauche. Un outil qui crée des objets s’utilise comme l’outil Rectangle : faites glisser sur la zone de travail (Shift pour un carré) ; un simple clic crée l’objet à cet endroit à la taille par défaut définie par le module. Les autres outils se comportent différemment selon le module.

Un module peut aussi ajouter des raccourcis clavier. S’ils entrent en conflit avec un raccourci déjà utilisé par l’éditeur, ils ne sont pas attribués et la fonction de l’éditeur reste active. Choisissez alors la commande dans le menu Modules externes.

Questions associées

• Où sont les outils du plugin ?
• Le raccourci du plugin ne marche pas

Objets de module externe

Un objet créé avec un outil de module (par exemple une grille de manuscrit ou une grille) a une forme dessinée par le module. Lorsque vous le sélectionnez, l’onglet Attributs devient Objet de module externe : à côté des sections communes comme la position et les effets apparaît une section portant le nom du type d’objet (par exemple la grille de manuscrit). Modifiez ses champs (nombre de cases, couleur, etc., selon le module) et le module redessine la forme. Chaque modification correspond à une étape d’annulation. Les sections de fond et de contour n’apparaissent que si le module les utilise.

L’aspect dessiné d’un objet de module est enregistré avec la mise en page. Il s’affiche donc et s’imprime à l’identique même là où le module est absent : chez une personne qui reçoit la mise en page sans avoir installé le module, en mode lecture, dans le PDF. Sans le module, son contenu ne peut toutefois pas être modifié : on peut seulement le déplacer, le redimensionner ou le supprimer. L’onglet Attributs l’indique.

À l’export InDesign (IDML), les objets de module deviennent des groupes de tracés reprenant leur aspect enregistré, et le rapport en indique le nombre. Leurs propriétés de module ne sont plus modifiables dans InDesign.

Questions associées

• Les autres voient-ils les objets créés par un plugin ?
• J’ai supprimé le plugin et je ne peux plus modifier l’objet
• Les objets de module externe apparaissent-ils dans le PDF ?

Panneaux des modules externes

Lorsqu’un module ouvre un panneau, une petite fenêtre apparaît en haut à droite de l’éditeur. Sa barre de titre indique le nom du module et celui du panneau ; faites-la glisser pour déplacer la fenêtre et fermez-la avec le X à droite. Le contenu du panneau est dessiné par le module et s’exécute dans une fenêtre isolée de l’éditeur.

Questions associées

• Comment déplacer ou fermer la fenêtre d’un plugin ?
• Où est le panneau du module ?

Fenêtre de progression des traitements par lots

Pendant qu’un module modifie largement la mise en page (par exemple un module qui crée de nombreuses pages à partir de données), une fenêtre de progression recouvre tout l’éditeur. Elle affiche le nom du module et l’avancement ; pendant ce temps, vous ne pouvez pas modifier la mise en page.

• Cliquez sur Annuler pour arrêter le traitement et ramener la mise en page à son état d’avant.
• Une fois terminé, tout ce qu’a fait le module forme une seule étape d’annulation : un seul ⌘/Ctrl+Z annule l’ensemble.
• Si une erreur survient pendant le traitement, la mise en page revient aussi à son état d’avant.

Questions associées

• Je ne peux plus rien modifier pendant que le plugin tourne
• Comment annuler ce qu’a fait le module ?

Quand un module externe est désactivé

Si un module ne répond plus pendant un certain temps, l’éditeur le désactive et affiche « Le module externe … ne répondait plus et a été désactivé ». L’éditeur et la mise en page restent utilisables, mais les menus et outils de ce module ne sont plus disponibles jusqu’à la prochaine ouverture de l’éditeur. Actualisez l’onglet pour le recharger. Si le problème persiste, désactivez le module dans l’onglet Plug-ins et prévenez son développeur.

Si une commande ou un dessin du module échoue, une notification l’indique et la mise en page n’est pas modifiée.

Questions associées

• Un message dit que le plugin a été désactivé faute de réponse
• La commande du module externe a échoué

Mode développement

Un développeur de modules approuvé ouvre l’éditeur en ajoutant pluginDev à son adresse pour charger le module qu’il développe sur son ordinateur (localhost) (section « Page développeur des modules externes » de l’article « Modules externes »). Le menu Modules externes comporte alors en plus :

• Recharger les modules externes en développement — recharge le code modifié. Si vous avez modifié le manifeste, actualisez l’onglet.
• une entrée de journal par module — affiche dans une petite fenêtre les messages et erreurs du module. Un module qui n’a pas pu démarrer porte une mention d’échec.

En mode développement, les réglages enregistrés par le module ne sont pas écrits sur le serveur et restent seulement dans cette fenêtre.

Si vous lancez le serveur de développement du SDK avec --open, l’éditeur « bac à sable » s’ouvre sans connexion. Il charge uniquement le module en développement dans une nouvelle mise en page aux réglages par défaut et n’enregistre rien sur le serveur (ni enregistrement, ni sortie, ni téléversement ; la mise en page disparaît à la fermeture de l’onglet). La barre de titre affiche Bac à sable · Non enregistré, et le développeur peut, depuis le terminal, exécuter des commandes dans cet éditeur et récupérer des images de pages. Les couleurs CMJN sont affichées par approximation à l’écran.

Questions associées

• Comment tester dans l’éditeur le plugin que je développe ?
• Où voir le journal d’un module externe ?