Paramètre prédéfini de sortie PDF natif
Lors de la création de contenu, il devient essentiel de s’assurer que le contenu est optimisé pour l’affichage, la modification et l’impression. À l’aide de normes telles que les normes CSS3 W3C pour le style de contenu et les normes de médias paginés CSS pour les propriétés de définition de page telles que la taille, les marges, l’orientation, les sauts de page, les en-têtes, les pieds de page et la numérotation de page, vous pouvez définir l’affichage et la mise en page de votre document PDF en garantissant cohérence et convivialité. La fonction de publication Native PDF utilise ces normes pour générer un PDF.
Avec la publication native de PDF, vous pouvez utiliser des modèles prédéfinis pour assurer la cohérence de la disposition et de la structure du contenu, appliquer des feuilles de style pour modifier l’aspect de votre sortie, optimiser PDF, définir des repères d’imprimante, autoriser la prise en charge des lecteurs d’écran, définir la conformité de PDF, incorporer des polices, etc.
La génération d’un PDF à l’aide de la publication native de PDF présente deux aspects :
-
Utilisation de modèles pour appliquer un style au contenu, définir des mises en page et divers paramètres afin d’affiner votre PDF. Les auteurs peuvent choisir d’utiliser ou de modifier les exemples de modèles fournis ou de créer des modèles personnalisés et définir les options de configuration avancées utilisées par les éditeurs et les développeurs.
-
Créez ou configurez un paramètre prédéfini de sortie PDF pour contrôler les paramètres PDF. Une fois que vous avez créé un paramètre prédéfini de sortie PDF, vous pouvez générer le PDF.
Création d’un paramètre prédéfini de sortie
Pour créer le paramètre prédéfini PDF à partir de la console de mappage, procédez comme suit :
-
Ouvrez un fichier de mappage DITA dans la console Mappage.
Vous pouvez également accéder au fichier de mappage à partir du widget Fichiers récents dans la section Aperçu. Le fichier de mappage sélectionné s’ouvre dans la console Mappage .
-
Dans l’onglet Paramètres prédéfinis de sortie, sélectionnez l’icône + pour créer un paramètre prédéfini de sortie.
-
Sélectionnez dans la liste déroulante Type de la boîte de dialogue Nouveau paramètre prédéfini de sortie.
-
Dans le champ Nom, attribuez un nom à ce paramètre prédéfini.
-
Dans le champ Générer le PDF à l’aide de, sélectionnez Native-PDF.
-
Sélectionnez l’option Ajouter au profil du dossier actuel pour créer un paramètre prédéfini de sortie dans le profil du dossier actuel. L’
indique un paramètre prédéfini au niveau du profil de dossier.En savoir plus sur la Gestion des paramètres prédéfinis de sortie de profil globaux et de dossier.
-
Sélectionnez Ajouter.
Le paramètre prédéfini de PDF est créé.
Configuration du préréglage PDF natif
Une fois le paramètre prédéfini créé, configurez les paramètres prédéfinis de PDF natifs. Les options de configuration prédéfinies pour DITA-OT sont organisées sous les onglets Général, Métadonnées, Disposition, Sécurité, Impression et Avancé.
Général
Utilisez pour spécifier des paramètres de sortie de base, tels que le chemin de sortie, le nom de fichier PDF, etc.
${base_output_path}, qui est configurée par l’administrateur. Pour configurer le chemin de sortie, affichez Configurer l’emplacement de sortie de base pour les services cloud ou Configurer l’emplacement de sortie de base pour les services On-prem en fonction du service que vous utilisez.Vous pouvez également utiliser les variables prêtes à l’emploi suivantes pour définir le chemin de sortie. Vous pouvez utiliser une ou plusieurs variables pour définir cette option.
${map_filename} : utilise le nom des fichiers de plan DITA pour créer le chemin de destination.${map_title} : utilise le titre du plan DITA pour créer le chemin de destination.${preset_name} : utilise le nom du paramètre prédéfini de sortie pour créer le chemin de destination.${language_code} : utilise le code de langue dans lequel se trouve le fichier de mappage pour créer le chemin de destination.${map_parentpath} : utilise le chemin d’accès complet du fichier de mappage pour créer le chemin d’accès de destination.${path_after_langfolder} : utilise le chemin d’accès du fichier de mappage situé après le dossier de langue pour créer le chemin d’accès de destination.Vous pouvez également utiliser les variables prêtes à l’emploi suivantes pour définir le fichier PDF. Vous pouvez utiliser une ou plusieurs variables pour définir cette option.
${map_filename}${map_title}${preset_name}${language_code}.Pour le contenu conditionné, choisissez l’une des options suivantes pour générer une sortie PDF en fonction de ces conditions :
- Aucune application sélectionnez cette option si vous ne souhaitez appliquer aucune condition sur le mappage et le contenu source.
- Fichier DITAVAL Sélectionnez un fichier DITAVAL pour générer du contenu conditionnel. Vous pouvez sélectionner plusieurs fichiers DITAVAL à l’aide de la boîte de dialogue de navigation ou en saisissant manuellement le chemin d’accès au fichier. Pour supprimer un fichier sélectionné, cliquez sur la croix en regard de son nom. Si un fichier non valide est sélectionné, un message d’erreur s’affiche indiquant Un fichier DITAVAL non valide est sélectionné.
Chaque fichier DITAVAL peut contenir un éventail de propriétés, telles que des conditions de filtrage et des styles de marquage. Les indicateurs vous permettent de marquer visuellement le contenu à l’aide d’indicateurs de début et de fin, qui peuvent inclure des images ou une mise en forme de texte telle que le gras ou l’italique. En cas de chevauchement de conditions ou de conflits de style, vous pouvez définir une couleur d’arrière-plan à l’aide des paramètres de conflit de style. Pour plus d’informations, voir Utiliser l’éditeur DITAVAL. - Paramètre prédéfini de condition Sélectionnez un paramètre prédéfini de condition dans la liste déroulante pour appliquer une condition lors de la publication de la sortie. Cette option est visible si vous avez ajouté une condition pour le fichier de plan DITA. Les paramètres conditionnels sont disponibles dans l’onglet Paramètres prédéfinis de condition de la console Plan DITA. Pour en savoir plus sur les paramètres prédéfinis de condition, consultez la section Utilisation des paramètres prédéfinis de condition.
Utilisez les options suivantes pour créer un PDF présentant les différences de contenu entre deux versions à l’aide des barres de modification :
- Ligne de base de la version précédente Sélectionnez la version de ligne de base à comparer à la version actuelle ou à une autre ligne de base. Une barre de modification s’affiche dans le PDF pour indiquer le contenu modifié. Une barre de modification est une ligne verticale qui identifie visuellement le contenu nouveau ou révisé. La barre de modification s’affiche à gauche du contenu qui a été inséré, modifié ou supprimé.
Remarque : Si vous sélectionnez Utiliser niveau de référence et choisissez un niveau de référence à publier, la comparaison est effectuée entre les deux versions de niveau de référence sélectionnées. Par exemple, si vous choisissez la version de référence 1.3 sous Utiliser la référence et la version 1.1 sous Ligne de base de la version précédente, la comparaison sera effectuée entre la version de référence 1.1 et la version de référence 1.3. - Afficher le texte ajouté Sélectionnez cette option pour afficher le texte inséré en vert et souligné. Cette option est sélectionnée par défaut.
- Afficher le texte supprimé Sélectionnez cette option pour afficher le texte supprimé en rouge et barré. Cette option est sélectionnée par défaut.
Remarque vous pouvez également personnaliser la mise en forme de la barre de modification, du contenu inséré ou du contenu supprimé à l’aide de la feuille de style.
xml:lang du mappage racine, sélectionnez l’option Utiliser la langue du mappage au lieu de sélectionner explicitement une langue.Si aucun
xml:lang n’est défini pour la carte, la sortie est définie sur l’anglais (en_US) par défaut. Cela s’avère utile lorsque le mappage parent possède déjà un attribut xml:lang défini. Vous n’avez donc pas besoin d’un paramètre prédéfini de sortie distinct pour chaque langue. Pour comprendre l’impact de ce paramètre sur différents types de contenu, consultez la section Résolution linguistique pour le contenu DITA par rapport aux variables du modèle de sortie.REMARQUE :
les liens connexes définis dans les tables de relation DITA (
<reltable>) ne sont pas inclus par défaut dans la sortie Native PDF. Utilisez -Dargs.rellinks=nofamily argument DITA-OT pour inclure ces liens connexes dans la sortie Native PDF.Pour les mappages imbriqués, l’attribut
toc="no" défini sur une référence de mappage n’exclut pas ses rubriques enfants de la table des matières par défaut. Utilisez -Dpreprocess.move-meta-entries.skip=false argument DITA-OT pour vous assurer que les rubriques enfants sont exclues de la table des matières pour ces mappages.- Les liens définis dans les tables de relation DITA (
<reltable>) ne sont pas inclus par défaut dans la sortie Native PDF. Utilisez ce champ pour transmettre l'argument DITA-OT-Dargs.rellinks=nofamilyet inclure ces liens connexes dans la sortie.
Métadonnées
Les métadonnées sont la description ou la définition de votre contenu. Les métadonnées facilitent la gestion de contenu et la recherche de fichiers sur Internet.
Utilisez l’onglet Métadonnées pour définir les champs de métadonnées tels que le nom de l’auteur, le titre du document, les mots-clés, les informations de copyright et d’autres champs de données pour la sortie PDF. Vous pouvez également ajouter des métadonnées personnalisées pour votre sortie PDF.
Ces métadonnées sont mappées aux métadonnées dans l’onglet Description de la Propriétés du document du PDF de sortie.
Dans les paramètres prédéfinis de sortie, sélectionnez > Native-PDF > Métadonnées pour ajouter et personnaliser des options de métadonnées.
-
Utiliser les métadonnées ajoutées dans topicmeta
Cette option est sélectionnée par défaut. Vous pouvez utiliser les métadonnées que vous avez ajoutées dans l’élément topicmeta du plan DITA pour renseigner les champs de métadonnées de la sortie PDF.
-
Fournir un fichier XMP
Vous pouvez également remplir directement les champs de métadonnées en important le fichier 🔗 (Extensible Metadata Platform). Vous pouvez télécharger un exemple de fichier XMP ici.
Vous pouvez également générer un fichier XMP à l’aide d’Adobe Acrobat.
- Sélectionnez Fichier > Propriétés dans Acrobat.
- Sous Description, sélectionnez Métadonnées supplémentaires.
- Dans le panneau de gauche, sélectionnez Avancé.
- Sélectionnez Enregistrer.
Le fichier XMP est enregistré sur l’appareil.
-
Fournissez des noms et des valeurs de métadonnées
- Ajoutez un nom en le sélectionnant dans la liste déroulante ou ajoutez des métadonnées personnalisées en saisissant directement dans le champ du nom.
- Saisissez la valeur pour les métadonnées et sélectionnez l’icône « + ».
Les métadonnées sont ajoutées à la liste des métadonnées du PDF.
Vous pouvez également utiliser des variables pour définir les valeurs des métadonnées. Vous pouvez utiliser les métadonnées définies pour le fichier DITA map ou bookmap en tant que variables. Les métadonnées se trouvent sous le nœud /jcr:content/metadata du fichier de plan DITA ou de bookmap.
Lorsque vous utilisez une variable, sa valeur est sélectionnée dans les propriétés de métadonnées.
Pour utiliser une variable, vous devez la définir au format ${<variable>}.
Par exemple, une des propriétés de métadonnées définies dans le nœud /jcr:content/metadata estdc:title. Vous pouvez indiquer ${dc:title} et la valeur du titre est utilisée dans la sortie finale.
Vous pouvez utiliser une seule variable ou une combinaison de variables pour définir les métadonnées. Par exemple, ${dc:title} ${dc:docstate}. Vous pouvez également utiliser la combinaison d’une variable et d’une chaîne. Par exemple, View ${dc:title} in ${dc:language}.
Utilisez des variables de langue pour définir la valeur localisée des propriétés de métadonnées. Selon la langue choisie, la valeur localisée est automatiquement sélectionnée dans la sortie PDF. Par exemple, vous pouvez imprimer « Author » comme valeur de métadonnées en anglais et « Autorin » en allemand.
Format : ${lng:<variable name>}. Par exemple, ${lng:author-label} où author-label est une variable de langue.
Survoler
Disposition
Utilisez pour définir les mises en page et spécifier les options d’affichage des pages pour la sortie PDF, telles que l’affichage de la page et définir les niveaux de zoom.
Vous pouvez également sélectionner Parcourir le modèle
Utilisez l’option Affichage de la page pour l’affichage de la page qui indique l’affichage du PDF à l’ouverture. Faites votre choix dans les options de la liste déroulante Affichage de la page pour choisir un affichage préféré.
- Par défaut s’affiche conformément au paramètre par défaut de la visionneuse PDF sur l’ordinateur d’un utilisateur.
- Une seule page vue affiche une page à la fois.
- Défilement d’une seule page affiche une seule page dans une colonne verticale continue.
- Deux pages vues affiche deux pages côte à côte à la fois. .
- Défilement de deux pages affiche deux pages côte à côte avec défilement continu.
Sélectionnez cette option pour redimensionner la page vue qui affiche le PDF à son ouverture.
- Par défaut s’affiche selon le paramètre par défaut de la visionneuse PDF sur l’ordinateur d’un
utilisateur - 100 % fait apparaître la page dans sa taille réelle.
- Ajuster la page Ajuste la largeur et la hauteur de la page dans le volet du document. .
- Ajuster la largeur de page Permet de faire en sorte que la largeur de la page soit égale à celle du volet du document.
- Ajuster la hauteur de la page Fait en sorte que la hauteur de la page remplisse la hauteur du panneau de visualisation.
Sécurité
Protégez votre PDF en ajoutant des restrictions pour l’ouverture et la lecture du fichier. Utilisez les options ci-dessous pour éviter tout accès non autorisé.
Sélectionnez cette option pour restreindre la façon dont les utilisateurs peuvent interagir avec votre PDF. Indiquez un mot de passe dans le champ Mot de passe du propriétaire pour que les paramètres de restriction ci-dessous fonctionnent.
- Impression sélectionnez cette option pour permettre à l’utilisateur d’imprimer le PDF.
- Impression de qualité Brouillon sélectionnez cette option pour permettre à l’utilisateur d’imprimer le PDF dans une résolution inférieure.
- Copie de contenu sélectionnez cette option pour permettre à l’utilisateur de copier du contenu du PDF.
- Annotations sélectionnez cette option pour permettre à l’utilisateur d’ajouter une note ou un commentaire dans le PDF.
- Modifications du contenu sélectionnez cette option pour permettre à l’utilisateur de modifier le contenu dans le PDF.
- Copie de contenu pour l’accessibilité Sélectionnez cette option pour permettre aux lecteurs d’écran de lire et de parcourir le contenu dans PDF.
Assemblage de document sélectionnez cette option pour permettre aux utilisateurs d’insérer des pages dans le PDF.
Remarque : les utilisateurs doivent saisir le mot de passe du propriétaire pour modifier les restrictions sous Fichier > Propriétés dans Adobe Acrobat.
Imprimer
Configurez les paramètres de production d’impression pour attribuer des repères d’impression, définir des zones de page et définir les options de couleur et de profil ICC pour votre sortie PDF. L’onglet Impression est organisé en trois sections, dans l’ordre : Marques d’impression, Zones de page et Couleur et ICC.
Marques d’imprimante
Lorsque vous préparez un document pour la production d’impression, des repères d’impression sont ajoutés aux limites de la page pour faciliter l’alignement, le rognage et la sélection des couleurs lors de l’impression. Lorsque vous sélectionnez un repère d’imprimante, la bordure de la page est étendue pour accueillir le repère et la zone étendue est ajustée après l’impression.
Utilisez les paramètres suivants pour configurer les repères d’impression pour votre sortie PDF :
Zones de page
Utilisez cette section pour définir la taille globale de la page et la zone de fond perdu pour votre sortie PDF.
Utilisez les paramètres suivants pour configurer les zones de page :
Couleur et ICC
Utilisez cette section pour choisir un espace colorimétrique à imprimer et, éventuellement, gérer la précision des couleurs sur les appareils à l’aide d’un profil ICC. Lors de l’utilisation de l’espace colorimétrique CMJN, un profil colorimétrique ICC est requis pour les conformités PDF qui nécessitent une gestion des couleurs.
Utilisez les paramètres suivants pour configurer l’espace colorimétrique et le profil ICC :
- Par défaut : utilise le comportement de rendu par défaut.
- Perception : ajuste les couleurs afin de préserver leur aspect visuel global.
- Colorimétrie relative : ajuste les couleurs en fonction de l’espace colorimétrique cible tout en conservant la précision des couleurs dans la mesure du possible.
Remarque : lorsque vous utilisez cette fonctionnalité avec une configuration Adobe Experience Manager Guides On-Premise, assurez-vous que Java 20 ou une version ultérieure est disponible pour que le moteur Native PDF sous-jacent applique l’intention de rendu spécifiée.
.icc ou .icm) sur votre serveur AEM. Ce champ est désactivé lorsque l’option Utiliser l’URL pour le profil est activée.Avancé
Utilisez les options suivantes pour spécifier des paramètres avancés pour fusionner des PDF, utiliser la compression, sélectionner la norme de conformité, etc.
Remarque : une police ne peut être incorporée que si elle contient un paramètre défini par le fournisseur de la police qui permet son incorporation. Assurez-vous de disposer du paramètre ou de la licence requis avant d’incorporer une police.
Utilisez du texte statique ou des variables de langue pour publier la version localisée du filigrane. Selon la langue choisie, la valeur localisée est automatiquement sélectionnée dans la sortie PDF. Par exemple, vous pouvez imprimer « Publisher » sous forme de filigrane en anglais et « Auteure » en français.
Format :
${lng:<variable name>}. Par exemple, $ {lng:publisher-label} où publisher-label est une variable de langue.Survoler
Remarque : l’activation de cette option seule n’entraîne pas l’affichage de commentaires sur le brouillon dans la sortie. Un administrateur doit également définir la propriété display du style draft-comment sur une valeur visible (telle que
block, inline-block, grid, etc.) dans le modèle de sortie utilisé pour la carte. Pour plus d’informations, consultez Afficher ou masquer les commentaires de brouillon dans la sortie native de PDF.system_config.xml fichier qui vous donne des informations sur l’URL de création, l’URL locale et l’URL de publication. Ces URL sont configurées dans les paramètres d’externalisation d’AEM et sont reflétées dans le fichier system_config.xml.dc:description, dc:language, dc:title et docstate sont les propriétés par défaut, tandis que vous pouvez utiliser author comme propriété personnalisée. Les propriétés de métadonnées sélectionnées sont transmises au fichier PDF généré à l’aide de PDF natif.Ces propriétés sont sélectionnées à partir du fichier
metadataList disponible à l’adresse /libs/fmdita/config/metadataList.Ce fichier peut être recouvert à l’adresse :
/apps/fmdita/config/metadataList.