Sortie du PDF de publication
Avec AEM Guides, vous pouvez générer des PDF de rubriques individuelles ou d’un fichier de mappage entier. Vous pouvez publier votre contenu dans un format PDF à l’aide de l’une des trois méthodes suivantes :
- DITA-OT
Utilisez cette méthode pour générer une sortie de PDF pour une carte à partir du tableau de bord de carte. Vous pouvez définir les propriétés de publication avant de générer le PDF en créant un paramètre prédéfini de sortie pour la carte ouverte dans le tableau de bord de la carte. Pour créer ou modifier un paramètre prédéfini de sortie, la méthode Présentation des paramètres prédéfinis de sortie dans la section Guide de l’utilisateur d’AEM Guides as a Cloud Service.
Pour plus d’informations sur la génération d’un PDF à l’aide de la méthode DITA-OT, voir Générer un PDF à l’aide de DITA-OT.
- FrameMaker Publishing Server (FMPS)
Utilisez cette méthode pour générer une sortie de PDF à partir non seulement du contenu DITA, mais également des documents de FrameMaker (.book et .fm) disponibles dans votre référentiel AEM. Le PDF peut être créé en configurant un paramètre prédéfini de sortie et publié à l’aide de FrameMaker Publishing Server (FMPS). Vous pouvez concevoir et configurer l’aspect de votre sortie pour les formats PDF et autres, puis les stocker dans un fichier de paramètres (.sts). Ce fichier de paramètres est ensuite utilisé par FMPS pour générer une sortie pour un mappage DITA ou un fichier .book. Pour créer ou modifier un paramètre prédéfini de sortie, voir Présentation des paramètres prédéfinis de sortie dans la section Guide de l’utilisateur d’AEM Guides as a Cloud Service.
Pour plus d’informations sur la configuration de FMPS, voir Générer une sortie à partir de documents de FrameMaker.
- Publication PDF native
Utilisez cette méthode pour générer une sortie de PDF riche en fonctionnalités basée sur les normes W3C CSS3 et CSS paged Media. Avec la publication avec des PDF natifs, vous pouvez utiliser des modèles pour définir la mise en page et le style de votre contenu et appliquer divers paramètres pour affiner votre PDF. En outre, vous pouvez modifier et créer vos propres modèles à l’aide de l’éditeur de modèles.
Pour plus d’informations sur la publication avec des PDF natifs, voir Utilisation de la publication de PDF natifs.
Utilisation de la publication de PDF natif native-pdf-publishing
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. Grâce à des normes telles que le W3C CSS3 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 pages, vous pouvez définir l’affichage et la mise en page de votre document de PDF pour garantir la cohérence et la convivialité. La fonction de publication de PDF natif 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 le PDF, définir des repères d’impression, permettre la prise en charge des lecteurs d’écran, définir la conformité du PDF, incorporer des polices, etc.
La génération d’un PDF à l’aide de la publication d’un PDF natif comporte deux aspects :
-
Utilisez les 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/de modifier les exemples de modèles fournis ou de créer des modèles personnalisés et de définir des 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 du PDF pour contrôler les paramètres du PDF. Une fois que vous avez créé un paramètre prédéfini de sortie de PDF, vous pouvez générer le PDF.
Pour plus d’informations, voir Génération d’une sortie de PDF.
Création d’un paramètre prédéfini de sortie PDF create-output-preset
La première étape de la génération d’une sortie de PDF consiste à créer un paramètre prédéfini de sortie de PDF, qui est un ensemble de propriétés de publication affectées à un mappage. Vous pouvez créer un paramètre prédéfini de sortie pour n’importe quel mappage ouvert dans le panneau Affichage des cartes ou configurer un paramètre prédéfini existant afin de générer rapidement un PDF pour le même mappage.
À partir du paramètre prédéfini de sortie du PDF, vous pouvez sélectionner un modèle, appliquer des conditions, définir des restrictions pour contrôler l’interaction d’un utilisateur avec votre PDF, configurer des paramètres avancés tels que la compression, la conformité, etc.
Pour créer ou configurer un paramètre prédéfini de sortie de PDF :
-
Dans l’onglet Sortie , cliquez sur Paramètres prédéfinis dans la barre latérale gauche.
Le panneau Paramètre prédéfini s’ouvre.
-
Dans la sortie Paramètres prédéfinis effectuez l’une des opérations suivantes :
- Double-cliquez sur un paramètre prédéfini de sortie de PDF prédéfini pour l’afficher.
- Cliquez sur l’icône + pour Paramètres prédéfinis pour ajouter un nouveau paramètre prédéfini de sortie de Type : PDF
-
Pour configurer les paramètres d’un paramètre prédéfini de PDF existant :
- Cliquez sur le bouton Options
Vous pouvez utiliser les paramètres suivants dans la variable Général, Métadonnées, Disposition, Sécurité, et Avancé onglets pour configurer un paramètre prédéfini de sortie PDF :
- Cliquez sur le bouton Options
Général
Utilisez pour spécifier les paramètres de sortie de base, tels que le chemin de sortie, le nom de fichier du PDF, etc.
Vous pouvez également utiliser les variables d’usine suivantes pour définir le chemin d’accès à la sortie. Vous pouvez utiliser une seule ou une combinaison de variables pour définir cette option.
${map_filename}
: utilise le nom des fichiers de mappage DITA pour créer le chemin de destination.${map_title}
: utilise le titre du mappage 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 où se trouve le fichier de mappage pour créer le chemin d’accès 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 map situé après le dossier language pour créer le chemin d’accès de destination.Vous pouvez également utiliser les variables d’usine suivantes pour définir le fichier du PDF. Vous pouvez utiliser une seule ou une combinaison de variables pour définir cette option.
${map_filename}
${map_title}
${preset_name}
${language_code}
.Pour le contenu conditionnel, choisissez l’une des options ci-dessous afin de générer une sortie PDF basée sur ces conditions :
- Aucun appliqué Sélectionnez cette option si vous ne souhaitez appliquer aucune condition sur la carte et le contenu source.
- Fichier Ditaval Sélectionnez un fichier DITAVAL pour générer du contenu conditionnel. Pour sélectionner, cliquez sur paramètre prédéfini de condition et recherchez le fichier.
- 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 mappage DITA. Les paramètres conditionnels sont disponibles dans l’onglet Paramètres prédéfinis de condition de la console de mappage DITA. Pour en savoir plus sur le paramètre prédéfini de condition, voir Utilisation des paramètres de condition prédéfinis.
Utilisez les options suivantes pour créer un PDF affichant les différences de contenu entre deux versions à l’aide de 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 Utilisation de la ligne de base et choisissez une ligne de base à publier. La comparaison sera effectuée entre les deux versions de ligne de base sélectionnées. Par exemple, si vous choisissez la version de base 1.3 sous Utilisation de la ligne de base et version 1.1 sous Ligne de base de la version précédente, la comparaison sera effectuée entre la version de base 1.1 et la version de base 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é d’une barre oblique. Cette option est sélectionnée par défaut.
Remarque Vous pouvez également personnaliser le style de la barre de modification, du contenu inséré ou du contenu supprimé à l’aide de la feuille de style.
Métadonnées
Les métadonnées sont la description ou la définition de votre contenu. Les métadonnées aident à 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 du PDF. Vous pouvez également ajouter des métadonnées personnalisées pour la sortie de votre PDF.
Ces métadonnées sont mappées aux métadonnées dans la variable Description dans la Propriétés du document de votre PDF de sortie.
Dans les paramètres prédéfinis de sortie, sélectionnez PDF > Native-PDF > Métadonnées pour ajouter et personnaliser des options de métadonnées.
-
Utilisation de 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 mappage DITA pour renseigner les champs de métadonnées de la sortie du PDF.
-
Fournir un fichier XMP
Vous pouvez également remplir directement les champs de métadonnées en important des XMP (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.
- Cliquez sur Fichier > Propriétés dans Acrobat.
- Sous Description, cliquez sur Métadonnées supplémentaires.
- Dans le panneau de gauche, sélectionnez Avancé.
- Cliquez sur Enregistrer.
XMP fichier est enregistré sur l’appareil.
-
Fournir des noms et des valeurs de métadonnées
- Ajoutez un nom en le sélectionnant dans la liste déroulante ou ajoutez une métadonnée personnalisée en saisissant directement dans le champ du nom.
- Saisissez la valeur des métadonnées et cliquez sur 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 de métadonnées. Vous pouvez utiliser les métadonnées définies pour le mappage DITA ou le fichier bookmap comme variables. Les métadonnées se trouvent sous la variable /jcr:content/metadata
noeud du mappage DITA ou du fichier 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 dans la variable ${<variable>}
format.
Par exemple, l’une des propriétés de métadonnées définies dans /jcr:content/metadata
node isdc:title
. Vous pouvez indiquer ${dc:title}
et la valeur de titre est utilisée dans la sortie finale.
Vous pouvez utiliser une seule ou une combinaison de variables pour définir les métadonnées. Par exemple, ${dc:title} ${dc:docstate}
. Vous pouvez également combiner une variable à 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 du PDF. Par exemple, vous pouvez imprimer "Auteur" comme valeur de métadonnées en anglais et "Autorin" en allemand.
Format : ${lng:<variable name>}
. Par exemple : ${lng:author-label}
where author-label
est une variable de langue.
Survol
Disposition
Utilisez pour définir des mises en page et des options de page vue pour la sortie du PDF, telles que l’affichage de la page et les niveaux de zoom.
Vous pouvez également sélectionner Parcourir le modèle
Utilisez l’affichage de page pour une page vue qui indique comment le PDF s’affiche à l’ouverture. Sélectionnez dans la liste déroulante Affichage de page pour choisir la vue souhaitée.
- Par défaut S’affiche selon le paramètre par défaut de la visionneuse du PDF sur la machine 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 côte à côte deux pages espacées. .
- Défilement de deux pages Affiche l’espacement de deux pages côte à côte avec défilement continu.
Sélectionnez cette option pour redimensionner la page vue qui indique comment le PDF s’affiche à l’ouverture.
- Par défaut S’affiche selon le paramètre par défaut de la visionneuse du PDF sur la machine d’un utilisateur.
- 100 % Permet à la page d’apparaître dans sa taille réelle.
- Page entière Rend la largeur et la hauteur de la page compatibles avec le panneau du document. .
- Ajuster la largeur de page Remplit la largeur de la page dans le volet de document.
- Ajuster la hauteur de page Fait en sorte que la hauteur de la page soit remplie par celle du panneau de document.
Sécurité
Protect votre PDF en ajoutant des restrictions pour ouvrir et lire le fichier. Utilisez les options ci-dessous pour éviter tout accès non autorisé.
Sélectionnez cette option pour restreindre la manière dont les utilisateurs peuvent interagir avec votre PDF. Indiquez un mot de passe dans la variable Mot de passe du propriétaire pour que les paramètres de restriction ci-dessous fonctionnent.
- Impression Sélectionnez cette option pour permettre à un utilisateur d’imprimer le PDF.
- Impression de qualité Brouillon Sélectionnez cette option pour permettre à un utilisateur d’imprimer le PDF avec une résolution inférieure.
- Copie de contenu Sélectionnez cette option pour permettre à un utilisateur de copier le contenu depuis le PDF.
- Annotations Sélectionnez cette option pour permettre à un utilisateur d’ajouter une note ou un commentaire dans le PDF.
- Modifications du contenu Sélectionnez cette option pour permettre à un utilisateur de modifier le contenu dans le PDF.
- Copie de contenu pour accessibilité Sélectionnez cette option pour permettre aux lecteurs d’écran de lire et de parcourir le contenu dans PDF.
Assemblage de documents 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 dans Fichier > Propriétés dans Adobe Acrobat.
Avancé
Utilisez les options suivantes pour définir 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 du fournisseur de police qui lui permet d’être incorporée. 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 du PDF. Par exemple, vous pouvez imprimer "Éditeur" en filigrane en anglais et "Auteur" en français.
Format :
${lng:<variable name>}
. Par exemple : $ {lng:publisher-label}
where publisher-label
est une variable de langue.Survol
dc:description
, dc:language
, dc:title
, et docstate
sont les propriétés par défaut, tandis que vous pouvez author
comme propriété personnalisée. Les propriétés de métadonnées sélectionnées sont transmises au fichier de PDF généré à l’aide de l’PDF natif.Ces propriétés sont sélectionnées dans la variable
metadataList
fichier disponible à l’adresse :/libs/fmdita/config/metadataList
.Ce fichier peut être superposé à l’emplacement suivant :
/apps/fmdita/config/metadataList
.Génération d’une sortie de PDF generate-pdf-output
Une fois que vous avez configuré le paramètre prédéfini de sortie, vous pouvez générer une sortie à partir du panneau Paramètres prédéfinis, à l’aide de la fonction Générer un paramètre prédéfini fonction .
-
Sous , Auteur , sélectionnez l’onglet Référentiel Afficher.
Le panneau Référentiel s’ouvre alors. -
Dans le panneau Repository, ouvrez le fichier de mappage DITA dans Vue Carte.
-
Dans le Sortie , cliquez sur Paramètres prédéfinis pour afficher le panneau Paramètre prédéfini.
Pour créer ou configurer un paramètre prédéfini de sortie, voir Création d’un paramètre prédéfini de sortie PDF. -
Pour enregistrer vos paramètres, cliquez sur le bouton Enregistrer tout
-
Cliquez sur le bouton Générer un paramètre prédéfini
Vous pouvez afficher une barre de progression en regard du paramètre prédéfini de sortie sélectionné dans le panneau Paramètres prédéfinis de sortie. -
Une fois la génération de la sortie terminée, cliquez sur Afficher la sortie
A Succès est visible dans le coin inférieur droit de l’écran.
Si une sortie échoue, le message d’erreur ci-dessous s’affiche.
Pour afficher le journal des erreurs, cliquez sur Ignorer, passez la souris sur l’onglet de paramètre prédéfini sélectionné, puis cliquez sur
Téléchargement de fichiers temporaires après génération de la sortie du PDF natif
Si vous sélectionnez l’option Téléchargement de fichiers temporaires dans les paramètres avancés, vous pouvez également télécharger les fichiers de HTML intermédiaires créés lors de la génération de la sortie du PDF natif. Une fois que vous avez généré la sortie, vous pouvez télécharger les fichiers temporaires à l’aide de la fonction Téléchargement de fichiers temporaires
Utilisation de variables de langue
AEM Guides fournit également la prise en charge des variables de langue. Sélectionner Variables de langue
Prise en charge des documents Markdown
Les guides du Experience Manager prennent également en charge vos documents Markdown. Les fichiers Markdown sont faciles à créer et offrent également diverses options de formatage. Découvrez comment créer des documents Markdown à partir de l’éditeur web ;.
Vous pouvez ajouter les rubriques Markdown à votre mappage DITA et générer la sortie du PDF à l’aide des paramètres prédéfinis de sortie du PDF natif. Découvrez comment configurer ou création d’un paramètre prédéfini de sortie PDF.