GroupDocs Conversion Java : Convertir Word en PDF avec des polices personnalisées

Dans ce tutoriel complet, vous découvrirez comment groupdocs conversion java vous permet de convertir docx en pdf tout en conservant les styles de police personnalisés. Que vous construisiez un pipeline de documents juridiques ou que vous publiiez des e‑books, les étapes ci‑dessous garantissent que le PDF résultant ressemble exactement au fichier Word original.

Quick Answers

  • 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 police.
  • 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 un large éventail de formats de documents (y compris DOCX, PPTX, XLSX et PDF) sans nécessiter l’installation de Microsoft Office. Elle offre aux développeurs un contrôle granulaire sur le rendu, la mise en page et la gestion des polices.

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

Intégrer les 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. Cela est particulièrement important pour les scénarios convert word pdf java tels que les archives juridiques, les rapports d’entreprise et les supports éducatifs.

Prerequisites

  • Java Development Kit (JDK) – version 8 ou plus récente.
  • 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>

License Acquisition

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.

Basic Initialization and Setup

Après avoir ajouté la dépendance, créez une instance Converter qui pointe vers votre fichier DOCX source.

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, un guide pas à pas qui montre comment set default font 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.

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);

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(...): Mappe les polices manquantes vers 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.

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

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

Vous pouvez étendre PdfConvertOptions ultérieurement pour ajuster la taille de page, les marges ou les paramètres de compression.

Étape 3 : Effectuer la conversion

Enfin, exécutez la conversion avec les options de chargement et de conversion définies précédemment.

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

L’API lit le DOCX, applique vos règles de police et écrit un PDF qui intègre les polices sélectionnées.

Applications pratiques

  1. Gestion de documents juridiques – Conserver la typographie exacte pour des 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. Supports éducatifs – 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 heap ; 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.

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 dépassement de mémoireAugmentez la taille du heap JVM (-Xmx2g ou plus) ou traitez les fichiers par lots plus petits.
PDF sans polices incorporéesAssurez‑vous que setDefaultFont pointe vers un fichier TrueType (.ttf) ou OpenType (.otf) et que la licence autorise l’incorporation des polices.

Questions fréquentes

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 et envisagez d’augmenter la taille du heap JVM.

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 de nombreux autres formats.

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

Conclusion

Vous disposez maintenant d’une solution complète, prête pour la production, pour convert docx to pdf avec une gestion des polices personnalisées en utilisant 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 support de visualisation.

Prochaines étapes

  • Expérimentez avec des PdfConvertOptions supplémentaires tels que la compression d’image ou la conformité PDF/A.
  • Explorez la conversion par lots pour automatiser des pipelines de documents à grande échelle.
  • Examinez l’ensemble complet de l’API dans la documentation officielle pour débloquer des fonctionnalités plus avancées.

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

Ressources