Intégrer des polices PDF avec GroupDocs Conversion Java pour Word

Dans ce tutoriel complet, vous découvrirez comment GroupDocs Conversion Java vous permet d’intégrer des polices PDF lors de la conversion d’un fichier DOCX en PDF. Que vous construisiez une chaîne de traitement de documents juridiques, publiiez des e‑books ou génériez des rapports d’entreprise, les étapes ci‑dessous garantissent que le PDF résultant ressemble exactement au fichier Word original sur chaque appareil.

Réponses rapides

  • Quelle bibliothèque gère la conversion ? GroupDocs Conversion for Java.
  • Puis‑je remplacer les polices manquantes ? Oui – utilisez les paramètres de substitution de polices.
  • Ai‑je besoin d’une licence pour la production ? Une licence commerciale est requise ; un essai gratuit est disponible.
  • Quelle version de Java est prise en charge ? JDK 8 ou supérieur.
  • La conversion par lots est‑elle possible ? Absolument – encapsulez le convertisseur dans une boucle ou utilisez les fonctionnalités de lot de l’API.

Qu’est‑ce que GroupDocs Conversion Java ?

GroupDocs Conversion Java est une API haute performance qui transforme plus de 70+ formats de documents — y compris DOCX, PPTX, XLSX et PDF — sans nécessiter Microsoft Office. Elle offre aux développeurs un contrôle fin sur le rendu, la mise en page et les capacités d’intégration de polices PDF, traitant un DOCX de 500 pages en moins de 30 secondes sur un serveur typique.

Pourquoi utiliser des polices personnalisées lors de la conversion ?

L’intégration des bonnes polices garantit que le PDF apparaît identique sur chaque appareil, élimine les problèmes de « fallback de police » et respecte les directives de marque. Cette approche réduit le retravail jusqu’à 40 % pour les équipes qui, autrement, doivent ajuster manuellement les PDF après la conversion.

Prérequis

  • Java Development Kit (JDK) – version 8 ou supérieure.
  • Maven pour la gestion des dépendances.
  • Un IDE (IntelliJ IDEA, Eclipse ou VS Code).

Configuration de GroupDocs.Conversion pour Java

Pour commencer, ajoutez le dépôt GroupDocs et la dépendance de conversion à votre projet Maven.

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/conversion/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-conversion</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

Acquisition de licence

Vous pouvez commencer avec un essai gratuit ou obtenir une licence temporaire pour des tests prolongés. Pour un usage commercial, envisagez d’acheter une licence complète. Visitez GroupDocs Licensing pour explorer vos options.

Initialisation et configuration de base

Après avoir ajouté la dépendance, créez une instance Converter qui pointe vers votre fichier DOCX source.
Converter est la classe principale qui gère les opérations de conversion de documents.

import com.groupdocs.conversion.Converter;

// Initialize with a document path
Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SampleDocx.docx");

Guide d’implémentation

Ci‑dessous se trouve un guide pas à pas montrant comment définir la police par défaut pdf et définir des substitutions de polices personnalisées.

Étape 1 : Définir le chemin de conversion et les options de chargement

Tout d’abord, spécifiez où le PDF sera enregistré et configurez les options de chargement qui contrôlent la gestion des polices.
setAutoFontSubstitution désactive la devinette automatique des polices pendant la conversion.
setDefaultFont spécifie la police de secours utilisée lorsque l’originale est manquante.
setFontSubstitutes associe les polices indisponibles à des polices alternatives que vous fournissez.

import com.groupdocs.conversion.options.load.WordProcessingLoadOptions;
import com.groupdocs.conversion.contracts.FontSubstitute;

// Output PDF path
String convertedFile = "YOUR_OUTPUT_DIRECTORY/ConvertedWordToPdf.pdf";

// Configure load options for Word documents
double autoFontSubstitution(false);  // Disable automatic font substitution
defaultFont("resources/fonts/Helvetica.ttf");  // Set a default fallback font

// Prepare font substitutes list
List<FontSubstitute> fontSubstitutes = new ArrayList<>();
fontSubstitutes.add(FontSubstitute.create("Tahoma", "Arial")); // Substitute Tahoma with Arial
fontSubstitutes.add(FontSubstitute.create("Times New Roman", "Arial")); // Substitute Times New Roman with Arial

// Apply the substitutes to load options
setFontSubstitutes(fontSubstitutes);

Réponse directe

Définissez setAutoFontSubstitution(false) pour désactiver les devinettes automatiques, puis fournissez une police de secours fiable avec setDefaultFont("Helvetica.ttf"). Enfin, associez les polices manquantes à des alternatives connues en utilisant setFontSubstitutes(...). Cela garantit que chaque caractère du DOCX source possède un glyphe correspondant dans le PDF de sortie.

Explication

  • setAutoFontSubstitution(false) : désactive les suppositions automatiques de la bibliothèque, vous donnant un contrôle total.
  • setDefaultFont("Helvetica.ttf") : fournit une police de secours universelle lorsqu’une police demandée n’est pas trouvée.
  • setFontSubstitutes(...) : associe les polices manquantes à des alternatives que vous savez disponibles sur le système cible.

Étape 2 : Configurer les options de conversion PDF

Créez maintenant l’objet d’options spécifique au PDF.
PdfConvertOptions définit les paramètres de sortie PDF tels que l’intégration des polices et la compression.
setEmbedFonts active l’intégration des polices sélectionnées dans le PDF généré.

import com.groupdocs.conversion.options.convert.PdfConvertOptions;

// Initialize PDF conversion options
double options = new PdfConvertOptions();

Réponse directe

Instanciez PdfConvertOptions, activez éventuellement l’intégration des polices avec setEmbedFonts(true), et ajustez les paramètres de compression pour équilibrer la taille du fichier et la qualité. Ces options vous permettent d’affiner le PDF final afin de répondre à la fois à la fidélité visuelle et aux contraintes de stockage.
Vous pouvez étendre PdfConvertOptions ultérieurement pour ajuster la taille de la page, les marges ou les paramètres de compression.

Étape 3 : Effectuer la conversion

Enfin, lancez la conversion avec les options de chargement et de conversion définies précédemment.
convert(source, target, loadOptions, pdfOptions) exécute la conversion avec les paramètres fournis.

// Convert Word document to PDF with specified font settings
converter.convert(convertedFile, () -> loadOptions, options);

Réponse directe

Appelez converter.convert(sourcePath, targetPath, loadOptions, pdfOptions). L’API lit le DOCX, applique vos règles de police, intègre les polices choisies et écrit un PDF qui préserve la typographie originale exactement comme prévu.
L’API lit le DOCX, applique vos règles de police et écrit un PDF qui intègre les polices choisies.

Applications pratiques

  1. Gestion de documents juridiques – Conserver une typographie exacte pour les PDF prêts pour le tribunal.
  2. Industrie de l’édition – Maintenir la cohérence des polices de marque à travers les e‑books et les catalogues.
  3. Rapports d’entreprise – Garantir que les PDF destinés aux parties prenantes respectent les guides de style de l’entreprise.
  4. Matériel éducatif – Convertir les notes de cours tout en conservant les polices académiques personnalisées.

Considérations de performance

  • Gestion de la mémoire – Les gros fichiers DOCX peuvent consommer beaucoup de mémoire du tas ; surveillez la mémoire JVM et envisagez des ajustements -Xmx.
  • Traitement par lots – Encapsulez la logique de conversion dans une boucle ou utilisez l’API de lot de GroupDocs pour gérer efficacement plusieurs fichiers.
  • Allocation des ressources – Allouez suffisamment de cœurs CPU lors de la conversion de nombreux documents en parallèle.
  • Débit – Sur une VM à 4 cœurs, la bibliothèque peut traiter jusqu’à 12 documents de 300 pages par minute tout en intégrant les polices.

Problèmes courants et solutions

ProblèmeSolution
Polices non substituéesVérifiez que les fichiers de police existent aux chemins que vous avez fournis et que les noms FontSubstitute correspondent exactement aux noms de famille de police dans le DOCX source.
Erreurs de manque de mémoireAugmentez la taille du tas JVM (-Xmx2g ou plus) ou traitez les fichiers par lots plus petits.
PDF sans polices intégréesAssurez-vous que setDefaultFont pointe vers un fichier TrueType (.ttf) ou OpenType (.otf) et que la licence autorise l’intégration des polices.
Mise en page incorrecte après conversionUtilisez PdfConvertOptions.setPageSize(...) pour correspondre aux dimensions de page du Word original.
Conversion lente pour des fichiers très volumineuxActivez le mode streaming avec PdfConvertOptions.setStream(true) pour réduire la pression mémoire.

Questions fréquemment posées

Q : Puis‑je utiliser GroupDocs.Conversion sans acheter de licence ?
R : Oui, vous pouvez commencer avec un essai gratuit ou obtenir une licence temporaire pour l’évaluation.

Q : Que faire si les polices ne sont pas correctement substituées ?
R : Assurez‑vous que les fichiers de police sont accessibles et correctement référencés dans setFontSubstitutes. Vérifiez à nouveau les noms exacts des familles de police.

Q : Comment améliorer les performances de conversion pour les gros documents ?
R : Traitez les documents par lots, surveillez les ressources système, augmentez la taille du tas JVM et activez le mode streaming.

Q : Est‑il possible de convertir d’autres types de documents que Word ?
R : Absolument. GroupDocs Conversion prend en charge les images, les feuilles de calcul, les présentations et bien d’autres formats.

Q : Où puis‑je trouver une documentation supplémentaire pour GroupDocs.Conversion ?
R : Consultez les guides officiels sur Documentation GroupDocs Java Conversion pour des références API détaillées.

Conclusion

Vous disposez maintenant d’une solution complète et prête pour la production d’intégration de polices PDF lors de la conversion de DOCX en PDF avec GroupDocs Conversion Java. En configurant la substitution de polices et les polices par défaut, vous garantissez que chaque PDF reflète l’apparence du document Word original, quel que soit le visualiseur ou la plateforme.

Prochaines étapes

  • Expérimentez avec des PdfConvertOptions supplémentaires comme la conformité PDF/A ou la compression d’images.
  • Explorez la conversion par lots pour automatiser les pipelines de documents à grande échelle.
  • Passez en revue l’ensemble de l’API dans la documentation officielle pour débloquer des fonctionnalités avancées telles que le filigrane ou les signatures numériques.

Dernière mise à jour : 2026-07-14
Testé avec : GroupDocs.Conversion 25.2
Auteur : GroupDocs

Ressources

Tutoriels associés