From 30e4fb632f62e18e835caaf645074afd2b720310 Mon Sep 17 00:00:00 2001 From: Muhammad Adil Date: Wed, 22 Jul 2026 02:20:18 +0000 Subject: [PATCH] Add 1 html java tutorials MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Categories: conversion-html-to-other-formats Source: AI Search API Tutorials: - How to Convert HTML File to PDF in Java – Complete Guide Auto-generated by Professionalize.Tutorials Agent --- .../_index.md | 2 + .../_index.md | 249 +++++++++++++++++ .../_index.md | 2 + .../_index.md | 250 +++++++++++++++++ .../_index.md | 2 + .../_index.md | 249 +++++++++++++++++ .../_index.md | 2 + .../_index.md | 248 +++++++++++++++++ .../_index.md | 2 + .../_index.md | 251 +++++++++++++++++ .../og-image.png | Bin 0 -> 47227 bytes .../_index.md | 3 + .../_index.md | 251 +++++++++++++++++ .../_index.md | 5 +- .../_index.md | 252 ++++++++++++++++++ .../_index.md | 2 + .../_index.md | 248 +++++++++++++++++ .../_index.md | 16 +- .../_index.md | 243 +++++++++++++++++ .../_index.md | 2 + .../_index.md | 247 +++++++++++++++++ .../_index.md | 1 + .../_index.md | 249 +++++++++++++++++ .../_index.md | 3 + .../_index.md | 249 +++++++++++++++++ .../_index.md | 1 + .../_index.md | 250 +++++++++++++++++ .../_index.md | 9 +- .../_index.md | 247 +++++++++++++++++ .../_index.md | 2 + .../_index.md | 243 +++++++++++++++++ .../_index.md | 2 + .../_index.md | 250 +++++++++++++++++ .../_index.md | 2 + .../_index.md | 246 +++++++++++++++++ .../_index.md | 3 + .../_index.md | 248 +++++++++++++++++ .../_index.md | 2 + .../_index.md | 248 +++++++++++++++++ .../_index.md | 2 + .../_index.md | 250 +++++++++++++++++ .../_index.md | 1 + .../_index.md | 249 +++++++++++++++++ .../_index.md | 2 + .../_index.md | 248 +++++++++++++++++ .../_index.md | 3 + .../_index.md | 247 +++++++++++++++++ 47 files changed, 5759 insertions(+), 24 deletions(-) create mode 100644 html/arabic/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/chinese/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/czech/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/dutch/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/english/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/english/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/og-image.png create mode 100644 html/french/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/german/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/greek/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/hindi/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/hongkong/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/hungarian/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/indonesian/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/italian/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/japanese/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/korean/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/polish/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/portuguese/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/russian/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/spanish/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/swedish/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/thai/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/turkish/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md create mode 100644 html/vietnamese/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md diff --git a/html/arabic/java/conversion-html-to-other-formats/_index.md b/html/arabic/java/conversion-html-to-other-formats/_index.md index 7c53c64117..6a91c93dac 100644 --- a/html/arabic/java/conversion-html-to-other-formats/_index.md +++ b/html/arabic/java/conversion-html-to-other-formats/_index.md @@ -96,6 +96,8 @@ XPS هو صيغة الطباعة الخاصة بمايكروسوفت. باستخ حوّل SVG إلى PDF في Java باستخدام Aspose.HTML. حل سلس لتحويل المستندات بجودة عالية. ### [تحويل SVG إلى XPS](./convert-svg-to-xps/) تعلم كيفية تحويل SVG إلى XPS باستخدام Aspose.HTML for Java. دليل بسيط خطوة بخطوة لتحويلات سلسة. +### [كيفية تحويل ملف HTML إلى PDF في Java – دليل شامل](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) +تعلم كيفية تحويل ملف HTML إلى PDF في Java باستخدام Aspose.HTML خطوة بخطوة. ### [تحويل HTML إلى PDF في Java – دليل خطوة بخطوة مع إعدادات حجم الصفحة](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) تعلم تحويل HTML إلى PDF في Java مع إعدادات حجم الصفحة خطوة بخطوة باستخدام Aspose.HTML. diff --git a/html/arabic/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/arabic/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..e0616397c6 --- /dev/null +++ b/html/arabic/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,249 @@ +--- +category: general +date: 2026-07-21 +description: كيفية تحويل ملف HTML إلى PDF باستخدام Aspose.HTML في Java. تعلم خطوة + بخطوة إنشاء PDF من HTML في Java ومعالجة الملفات المحلية. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: ar +lastmod: 2026-07-21 +og_description: كيفية تحويل ملف HTML إلى PDF باستخدام Aspose.HTML في Java. اتبع هذا + الدليل لإنشاء PDF من HTML في Java، مع معالجة الملفات المحلية بسهولة. +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: كيفية تحويل ملف HTML إلى PDF في Java – طريقة سريعة وموثوقة +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: كيفية تحويل ملف HTML إلى PDF في Java – دليل كامل +url: /ar/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# كيفية تحويل ملف HTML إلى PDF في Java – دليل كامل + +هل تساءلت يومًا **كيف تحول ملف HTML إلى PDF** دون الحاجة إلى أدوات سطر الأوامر أو حلول معقدة؟ لست وحدك. في العديد من المشاريع التي تركز على الويب – مثل التقارير الآلية، إنشاء الفواتير، أو أرشفة المواقع الثابتة – تحويل صفحة HTML إلى PDF واضح هو حاجة يومية. + +الخبر السار؟ مع Aspose.HTML for Java يمكنك القيام بذلك ببضع أسطر من الشيفرة فقط. يشرح هذا الدليل كيفية إنشاء PDF من HTML في Java، ويغطي كل شيء من إعداد المشروع إلى معالجة الحالات الخاصة مثل الموارد المفقودة. + +## المتطلبات المسبقة وما ستقوم ببنائه + +قبل أن نبدأ، تأكد من وجود ما يلي: + +- JDK 17 أو أحدث (أحدث نسخة LTS هي الأفضل) +- Maven 3.8+ (أو Gradle إذا كنت تفضله) +- رخصة Aspose.HTML for Java (يمكنك استخدام النسخة التجريبية المجانية للاختبار) +- ملف `input.html` بسيط موجود في دليل محلي + +بنهاية هذا الدليل ستحصل على برنامج Java قابل للتنفيذ **يحول ملف HTML محلي إلى PDF**، جاهز للإدماج في أي خدمة خلفية. + +--- + +## الخطوة 1: إعداد مشروع Maven (إنشاء PDF من HTML في Java) + +أولاً، أنشئ مشروع Maven جديد. إذا كان لديك بالفعل ملف `pom.xml`، فقط أضف تبعية Aspose.HTML: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **نصيحة احترافية:** احرص على أن يكون ملف `pom.xml` منظمًا؛ سيقوم Maven بسحب التبعيات المتداخلة تلقائيًا، لذا لن تحتاج إلى البحث عن ملفات JAR إضافية. + +## الخطوة 2: كتابة كود التحويل (كيفية تحويل ملف HTML إلى PDF) + +أنشئ فئة باسم `HtmlToPdfConverter`. يكمن جوهر التحويل في استدعاء ثابت واحد، لكننا سنغلفه لتوضيح الفكرة ومعالجة الأخطاء. + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### لماذا يعمل هذا + +- **`Converter.convert`** يختصر عملية التحليل، ومعالجة CSS، وإدراج الصور. لا تحتاج إلى إدارة محرك عرض بنفسك. +- الطريقة تُطلق **`ConverterException`**، مما يتيح لك طريقة نظيفة للتعامل مع الملفات المفقودة، أو HTML غير صالح، أو مشاكل الترخيص. +- من خلال عزل المنطق في `convert`، يمكنك إعادة استخدامه عبر الخدمات الصغيرة، أو وظائف الدُفعات، أو حتى أداة سطر أوامر بسيطة. + +## الخطوة 3: تشغيل التطبيق (إنشاء PDF من HTML في Java) + +قم بترجمة البرنامج وتنفيذه: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +إذا تم إعداد كل شيء بشكل صحيح، سترى: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +افتح `output.pdf` – يجب أن ترى تمثيلًا دقيقًا لـ `input.html`، بما في ذلك أنماط CSS، والصور، وحتى المحتوى الذي يولده JavaScript (طالما كان ثابتًا وقت التحويل). + +## الخطوة 4: معالجة الموارد المحلية (تحويل ملف HTML المحلي إلى PDF) + +غالبًا ما يشير ملف HTML إلى صور أو خطوط أو ملفات CSS عبر مسارات نسبية. يقوم Aspose.HTML بحل هذه المسارات تلقائيًا **إذا** تم ضبط URI القاعدة بشكل صحيح. بما أننا نمرر مسار ملف، فإن المكتبة تتعامل مع دليل `input.html` كقاعدة. + +إذا كنت بحاجة إلى تحويل سلسلة HTML بدلاً من ملف، حدد URI القاعدة يدويًا: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **احذر:** نسيان URI القاعدة سيتسبب في فقدان الصور أو تعطل الأنماط، وهو خطأ شائع عند **convert html to pdf java** للمرة الأولى. + +## الخطوة 5: الخيارات المتقدمة (ضبط تحويل HTML إلى PDF في Java) + +يتيح لك Aspose.HTML تعديل حجم الصفحة، والهوامش، وحتى بيانات تعريف PDF: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +هذه الإعدادات مفيدة عندما تحتاج إلى **convert html file to pdf** للطباعة أو الامتثال (مثل صفحات ISO‑216 A4). + +--- + +![How to convert html file to pdf illustration](image.png){.center alt="كيفية تحويل ملف html إلى pdf توضيح"} + +*المخطط أعلاه يوضح التدفق: كود Java → Aspose.HTML → مخرجات PDF.* + +## أسئلة شائعة وحالات حافة + +- **ماذا لو كان HTML يحتوي على خطوط ويب خارجية؟** + سيقوم Aspose.HTML بتحميلها طالما أن الجهاز متصل بالإنترنت. بالنسبة للبناء دون اتصال، قم بتجميع الخطوط محليًا واشر إليها بمسار نسبي. + +- **هل يمكنني تحويل عدة ملفات HTML دفعة واحدة؟** + بالتأكيد. ضع استدعاء `convert` داخل حلقة، ربما تقرأ أسماء الملفات من دليل. تذكر معالجة الاستثناءات لكل ملف حتى لا يتوقف الدفعة بالكامل بسبب ملف واحد سيء. + +- **هل تدعم المكتبة Java 11+؟** + نعم، الإصدار الحالي 23.12 يستهدف Java 8 وما فوق، لذا أنت بأمان على بيئات التشغيل الحديثة. + +- **مشكلات الترخيص؟** + إذا استمر تشغيل النسخة التجريبية لأكثر من 30 يومًا، سيحتوي PDF الناتج على علامة مائية. قم بتطبيق ملف الترخيص مبكرًا في `main`: + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## الخلاصة + +أصبح لديك الآن حل قوي وجاهز للإنتاج حول **كيفية تحويل ملف HTML إلى PDF** باستخدام Aspose.HTML في Java. من إعداد مشروع Maven إلى معالجة الموارد المحلية وضبط خيارات الصفحة، يغطي الدليل كل ما تحتاجه **لإنشاء PDF من HTML في Java** و**تحويل ملف HTML المحلي إلى PDF** دون الاعتماد على أدوات سطر أوامر من طرف ثالث. + +ما الخطوة التالية؟ جرّب إضافة رؤوس/تذييلات، تشفير PDF، أو دمج هذا المحول في نقطة نهاية REST باستخدام Spring Boot حتى يتمكن العملاء من رفع HTML والحصول على PDF فورًا. الاحتمالات لا حصر لها، والنمط الأساسي يبقى نفسه. + +هل لديك أسئلة أو تريد مشاركة تعديل ذكي؟ اترك تعليقًا أدناه – برمجة سعيدة! + +## ما الذي يجب أن تتعلمه بعد ذلك؟ + +الدروس التالية تغطي مواضيع ذات صلة وثيقة تبني على التقنيات التي تم توضيحها في هذا الدليل. كل مورد يتضمن أمثلة شيفرة كاملة مع شروحات خطوة بخطوة لمساعدتك على إتقان ميزات API إضافية واستكشاف نهج تنفيذ بديلة في مشاريعك. + +- [Convert HTML to PDF Java – Configuring Environment in Aspose.HTML](/html/english/java/configuring-environment/) +- [Create PDF from HTML – Set User Style Sheet in Aspose.HTML for Java](/html/english/java/configuring-environment/set-user-style-sheet/) +- [Set PDF Page Size - Convert HTML to PDF in Java](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/chinese/java/conversion-html-to-other-formats/_index.md b/html/chinese/java/conversion-html-to-other-formats/_index.md index 17440bc9f7..45c6054791 100644 --- a/html/chinese/java/conversion-html-to-other-formats/_index.md +++ b/html/chinese/java/conversion-html-to-other-formats/_index.md @@ -83,6 +83,8 @@ Aspose.HTML for Java 简化了 HTML 转 PDF 的工作流。请参阅专门的教 ## Conversion - HTML to Other Formats Tutorials ### [将 HTML 转换为 PDF](./convert-html-to-pdf/) 了解如何使用 Aspose.HTML 在 Java 中将 HTML 转换为 PDF。轻松从 HTML 内容创建高质量 PDF。 +### [在 Java 中将 HTML 文件转换为 PDF 的完整指南](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) +本指南详细演示如何使用 Aspose.HTML for Java 将 HTML 文件转换为高质量 PDF，包括代码示例和关键设置。 ### [将 HTML 转换为 MHTML](./convert-html-to-mhtml/) 使用 Aspose.HTML for Java 轻松将 HTML 转换为 MHTML。按照我们的分步指南高效完成 HTML 到 MHTML 的转换。 ### [将 HTML 转换为 XPS](./convert-html-to-xps/) diff --git a/html/chinese/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/chinese/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..74eced08ef --- /dev/null +++ b/html/chinese/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,250 @@ +--- +category: general +date: 2026-07-21 +description: 如何使用 Aspose.HTML 在 Java 中将 HTML 文件转换为 PDF。一步一步学习在 Java 中从 HTML 创建 PDF + 并处理本地文件。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: zh +lastmod: 2026-07-21 +og_description: 如何使用 Aspose.HTML 在 Java 中将 HTML 文件转换为 PDF。请按照本指南在 Java 中从 HTML 创建 + PDF，轻松处理本地文件。 +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: 如何在 Java 中将 HTML 文件转换为 PDF – 快速可靠的方法 +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: 如何在 Java 中将 HTML 文件转换为 PDF – 完整指南 +url: /zh/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何在 Java 中将 HTML 文件转换为 PDF – 完整指南 + +是否曾经想过 **如何将 HTML 文件转换为 PDF**，而不必与命令行工具或繁琐的变通方法斗争？你并不是唯一有此困惑的人。在许多以 Web 为中心的项目中——比如自动化报表、发票生成或静态站点归档——将 HTML 页面转换为清晰的 PDF 是日常需求。 + +好消息是？使用 Aspose.HTML for Java，你只需几行代码即可完成。本教程将手把手教你在 Java 中从 HTML 创建 PDF，涵盖从项目搭建到处理资源缺失等边缘情况的全部内容。 + +## 前置条件 & 你将构建的内容 + +在开始之前，请确保你拥有： + +- JDK 17 或更高版本（最新的 LTS 版本效果最佳） +- Maven 3.8+（如果你更喜欢 Gradle 也可以） +- Aspose.HTML for Java 许可证（免费试用版足以进行测试） +- 一个放在本地目录中的简单 `input.html` 文件 + +阅读完本指南后，你将拥有一个可运行的 Java 程序，**将本地 HTML 文件转换为 PDF**，并可直接嵌入任何后端服务。 + +--- + +## 第一步：设置 Maven 项目（在 Java 中从 HTML 创建 PDF） + +首先，创建一个全新的 Maven 项目。如果你已经有 `pom.xml`，只需添加 Aspose.HTML 依赖： + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **小贴士：** 保持 `pom.xml` 整洁；Maven 会自动拉取传递依赖，无需手动寻找额外的 JAR 包。 + +## 第二步：编写转换代码（如何将 HTML 文件转换为 PDF） + +新建一个名为 `HtmlToPdfConverter` 的类。转换的核心只需一次静态调用，但我们会为了清晰和错误处理而进行封装。 + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### 为什么这样可行 + +- **`Converter.convert`** 抽象了解析、CSS 处理以及图像嵌入等工作，你无需自行管理渲染引擎。 +- 该方法会抛出 **`ConverterException`**，为缺失文件、HTML 格式错误或授权问题提供了干净的处理方式。 +- 将逻辑封装在 `convert` 中后，你可以在微服务、批处理任务，甚至简单的 CLI 工具中复用它。 + +## 第三步：运行应用（在 Java 中从 HTML 创建 PDF） + +编译并执行程序： + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +如果一切配置正确，你会看到： + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +打开 `output.pdf` —— 你应该能看到 `input.html` 的忠实渲染，包括 CSS 样式、图片，甚至 JavaScript 生成的内容（只要在转换时是静态的）。 + +## 第四步：处理本地资源（将本地 HTML 文件转换为 PDF） + +通常你的 HTML 会通过相对路径引用图片、字体或 CSS 文件。只要正确设置了基准 URI，Aspose.HTML 会自动解析这些资源。因为我们传入的是文件路径，库会把 `input.html` 所在目录当作基准。 + +如果你想转换的是 HTML 字符串而不是文件，需要手动指定基准 URI： + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **注意：** 忘记设置基准 URI 会导致图片缺失或样式破碎，这是首次 **convert html to pdf java** 时的常见陷阱。 + +## 第五步：高级选项（微调 Convert HTML to PDF Java） + +Aspose.HTML 允许你调整页面尺寸、边距，甚至 PDF 元数据： + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +当你需要 **convert html file to pdf** 用于打印或合规（例如 ISO‑216 A4 纸张）时，这些设置非常实用。 + +--- + +![如何将 HTML 文件转换为 PDF 的示意图](image.png){.center alt="如何将 HTML 文件转换为 PDF 的示意图"} + +*上图展示了流程：Java 代码 → Aspose.HTML → PDF 输出。* + +## 常见问题与边缘案例 + +- **如果 HTML 中包含外部网络字体怎么办？** + 只要机器能联网，Aspose.HTML 会自动下载这些字体。离线构建时，请将字体打包到本地并使用相对路径引用。 + +- **可以批量转换多个 HTML 文件吗？** + 完全可以。将 `convert` 调用放入循环中，读取目录下的文件名即可。记得对每个文件单独捕获异常，防止单个错误导致整个批次中止。 + +- **库是否支持 Java 11+？** + 支持，当前 23.12 版本面向 Java 8 及以上版本，因此在现代运行时环境中使用毫无问题。 + +- **授权问题？** + 如果试用期超过 30 天，输出的 PDF 会带有水印。请在 `main` 方法开头尽早加载授权文件： + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## 结论 + +现在，你已经掌握了使用 Aspose.HTML 在 Java 中 **将 HTML 文件转换为 PDF** 的完整、可投入生产的方案。从 Maven 项目搭建到本地资源处理，再到页面选项微调，本文涵盖了实现 **在 Java 中从 HTML 创建 PDF** 与 **将本地 HTML 文件转换为 PDF** 所需的全部步骤，且无需依赖第三方命令行工具。 + +接下来可以尝试添加页眉/页脚、对 PDF 加密，或将此转换器集成到 Spring Boot REST 接口，让客户端上传 HTML 并即时返回 PDF。可能性无限，而核心模式保持不变。 + +有问题或想分享巧妙的改进？欢迎在下方留言——祝编码愉快！ + + +## 接下来你应该学习什么？ + +以下教程与本指南紧密相关，帮助你进一步掌握 API 功能并探索项目中的其他实现方式，每篇都提供完整可运行的代码示例和逐步解释。 + +- [Convert HTML to PDF Java – Configuring Environment in Aspose.HTML](/html/english/java/configuring-environment/) +- [Create PDF from HTML – Set User Style Sheet in Aspose.HTML for Java](/html/english/java/configuring-environment/set-user-style-sheet/) +- [Set PDF Page Size - Convert HTML to PDF in Java](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/czech/java/conversion-html-to-other-formats/_index.md b/html/czech/java/conversion-html-to-other-formats/_index.md index e722ab4720..cde785e839 100644 --- a/html/czech/java/conversion-html-to-other-formats/_index.md +++ b/html/czech/java/conversion-html-to-other-formats/_index.md @@ -84,6 +84,8 @@ Na závěr, zvládnutí **html to pdf java** a širší sady konverzí odemyká ## Konverze - Tutoriály pro HTML do jiných formátů ### [Převod HTML do PDF](./convert-html-to-pdf/) Naučte se převést HTML do PDF v Javě pomocí Aspose.HTML. Vytvářejte vysoce kvalitní PDF z vašeho HTML obsahu bez námahy. +### [Jak převést soubor HTML do PDF v Javě – Kompletní průvodce](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) +Kompletní návod, jak v Javě pomocí Aspose.HTML převést HTML soubor do PDF s podrobným nastavením a ukázkovým kódem. ### [Převod HTML do MHTML](./convert-html-to-mhtml/) Jednoduše převádějte HTML do MHTML pomocí Aspose.HTML for Java. Postupujte podle našeho krok‑za‑krokem průvodce pro efektivní konverzi HTML‑to‑MHTML. ### [Převod HTML do XPS](./convert-html-to-xps/) diff --git a/html/czech/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/czech/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..e68946cf75 --- /dev/null +++ b/html/czech/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,249 @@ +--- +category: general +date: 2026-07-21 +description: Jak převést soubor HTML na PDF pomocí Aspose.HTML v Javě. Naučte se krok + za krokem vytvářet PDF z HTML v Javě a pracovat s lokálními soubory. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: cs +lastmod: 2026-07-21 +og_description: Jak převést soubor HTML na PDF pomocí Aspose.HTML v Javě. Postupujte + podle tohoto návodu a vytvořte PDF z HTML v Javě, snadno pracujte s místními soubory. +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: Jak převést HTML soubor na PDF v Javě – rychlá, spolehlivá metoda +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: Jak převést HTML soubor na PDF v Javě – kompletní průvodce +url: /cs/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak převést HTML soubor do PDF v Javě – Kompletní průvodce + +Už jste se někdy zamýšleli **jak převést HTML soubor do PDF** bez boje s nástroji příkazové řádky nebo nešikovnými řešeními? Nejste v tom sami. V mnoha webových projektech – například automatizované reportování, generování faktur nebo archivace statických stránek – je převod HTML stránky do ostrého PDF každodenní potřebou. + +Dobrá zpráva? S Aspose.HTML pro Java to můžete udělat během několika řádků kódu. Tento tutoriál vás provede vytvořením PDF z HTML v Javě, od nastavení projektu až po řešení okrajových případů, jako jsou chybějící zdroje. + +## Předpoklady a co vytvoříte + +Než se pustíme dál, ujistěte se, že máte: + +- JDK 17 nebo novější (nejnovější LTS verze funguje nejlépe) +- Maven 3.8+ (nebo Gradle, pokud dáváte přednost) +- Licenci Aspose.HTML pro Java (pro testování stačí bezplatná zkušební verze) +- Jednoduchý soubor `input.html` umístěný v lokálním adresáři + +Na konci tohoto průvodce budete mít spustitelný Java program, který **převádí lokální HTML soubor do PDF**, připravený k nasazení v jakékoli backendové službě. + +--- + +## Krok 1: Nastavení Maven projektu (Vytvoření PDF z HTML v Javě) + +Nejprve vytvořte nový Maven projekt. Pokud už máte `pom.xml`, stačí přidat závislost Aspose.HTML: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **Tip:** Udržujte `pom.xml` přehledný; Maven automaticky stáhne transitivní závislosti, takže nemusíte hledat další JAR soubory. + +## Krok 2: Napište kód pro převod (Jak převést HTML soubor do PDF) + +Vytvořte třídu s názvem `HtmlToPdfConverter`. Jádro převodu spočívá v jediném statickém volání, ale zabalíme ho pro přehlednost a ošetření chyb. + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### Proč to funguje + +- **`Converter.convert`** abstrahuje parsování, zpracování CSS a vkládání obrázků. Nemusíte si sami spravovat renderovací engine. +- Metoda vyhazuje **`ConverterException`**, což vám poskytuje čistý způsob, jak reagovat na chybějící soubory, špatně formátované HTML nebo licenční problémy. +- Izolací logiky v metodě `convert` ji můžete znovu použít napříč mikroservisy, dávkovými úlohami nebo i jednoduchým CLI nástrojem. + +## Krok 3: Spusťte aplikaci (Vytvoření PDF z HTML v Javě) + +Zkompilujte a spusťte program: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +Pokud je vše nastaveno správně, uvidíte: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +Otevřete `output.pdf` – měli byste vidět věrné vykreslení `input.html`, včetně CSS stylů, obrázků a dokonce i obsahu generovaného JavaScriptem (pokud je statický v okamžiku převodu). + +## Krok 4: Práce s lokálními zdroji (Převod lokálního HTML souboru do PDF) + +Často váš HTML odkazuje na obrázky, fonty nebo CSS soubory pomocí relativních cest. Aspose.HTML je automaticky vyřeší **pokud** je správně nastavený základní URI. Protože předáváme cestu k souboru, knihovna považuje adresář `input.html` za základ. + +Pokud potřebujete převést HTML řetězec místo souboru, zadejte základní URI ručně: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **Pozor:** Zapomenutí základního URI způsobí chybějící obrázky nebo rozbité styly, což je častý úskalí při **convert html to pdf java** poprvé. + +## Krok 5: Pokročilé možnosti (Doladění Convert HTML to PDF Java) + +Aspose.HTML vám umožňuje upravit velikost stránky, okraje a dokonce i metadata PDF: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +Tyto nastavení jsou užitečná, když potřebujete **convert html file to pdf** pro tisk nebo soulad s normami (např. ISO‑216 A4 stránky). + +--- + +![How to convert html file to pdf illustration](image.png){.center alt="How to convert html file to pdf illustration"} + +*Diagram výše znázorňuje tok: Java kód → Aspose.HTML → PDF výstup.* + +## Často kladené otázky a okrajové případy + +- **Co když HTML obsahuje externí webové fonty?** + Aspose.HTML je stáhne, pokud má stroj přístup k internetu. Pro offline sestavení balíčujte fonty lokálně a odkazujte na ně relativní cestou. + +- **Mohu převádět více HTML souborů najednou?** + Rozhodně. Zabalte volání `convert` do smyčky, třeba načítáním názvů souborů z adresáře. Nezapomeňte ošetřit výjimky u každého souboru, aby jeden špatný vstup neukončil celou dávku. + +- **Podporuje knihovna Java 11+?** + Ano, aktuální verze 23.12 cílí na Java 8 a vyšší, takže jste v bezpečí na moderních runtimech. + +- **Licenční problémy?** + Pokud používáte zkušební verzi déle než 30 dnů, výstupní PDF bude obsahovat vodoznak. Licenční soubor aplikujte co nejdříve v metodě `main`: + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## Závěr + +Nyní máte robustní, připravené řešení pro **jak převést HTML soubor do PDF** pomocí Aspose.HTML v Javě. Od nastavení Maven projektu po práci s lokálními zdroji a ladění nastavení stránky, tento průvodce pokrývá vše, co potřebujete k **vytvoření PDF z HTML v Javě** a **převodu lokálního HTML souboru do PDF** bez třetích stran a příkazové řádky. + +Co dál? Zkuste přidat záhlaví/patičky, šifrovat PDF nebo integrovat tento převodník do Spring Boot REST endpointu, aby klienti mohli nahrát HTML a okamžitě získat PDF. Možnosti jsou nekonečné a základní vzor zůstává stejný. + +Máte otázky nebo chcete sdílet chytrý tip? Zanechte komentář níže – šťastné programování! + +## Co byste se měli naučit dál? + +Následující tutoriály pokrývají úzce související témata, která staví na technikách předvedených v tomto průvodci. Každý zdroj obsahuje kompletní funkční ukázky kódu s podrobnými vysvětleními, která vám pomohou zvládnout další funkce API a prozkoumat alternativní implementační přístupy ve vlastních projektech. + +- [Convert HTML to PDF Java – Configuring Environment in Aspose.HTML](/html/english/java/configuring-environment/) +- [Create PDF from HTML – Set User Style Sheet in Aspose.HTML for Java](/html/english/java/configuring-environment/set-user-style-sheet/) +- [Set PDF Page Size - Convert HTML to PDF in Java](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/dutch/java/conversion-html-to-other-formats/_index.md b/html/dutch/java/conversion-html-to-other-formats/_index.md index 88aaf02475..f808a8f967 100644 --- a/html/dutch/java/conversion-html-to-other-formats/_index.md +++ b/html/dutch/java/conversion-html-to-other-formats/_index.md @@ -98,6 +98,8 @@ Leer hoe u SVG naar afbeeldingen kunt converteren in Java met Aspose.HTML. Uitge Converteer SVG naar PDF in Java met Aspose.HTML. Een naadloze oplossing voor documentconversie van hoge kwaliteit. ### [SVG naar XPS converteren](./convert-svg-to-xps/) Leer hoe u SVG naar XPS kunt converteren met Aspose.HTML for Java. Eenvoudige, stap‑voor‑stap gids voor naadloze conversies. +### [Hoe HTML‑bestand naar PDF converteren in Java – Complete gids](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) +Leer stap‑voor‑stap hoe u een HTML‑bestand naar PDF converteert met Aspose.HTML for Java, inclusief configuratie‑tips en voorbeeldcode. ## Veelgestelde Vragen diff --git a/html/dutch/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/dutch/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..8972e9eb6f --- /dev/null +++ b/html/dutch/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-07-21 +description: Hoe een HTML‑bestand naar PDF te converteren met Aspose.HTML in Java. + Leer stap voor stap hoe je een PDF maakt van HTML in Java en lokale bestanden verwerkt. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: nl +lastmod: 2026-07-21 +og_description: Hoe je een HTML‑bestand naar PDF converteert met Aspose.HTML in Java. + Volg deze gids om een PDF te maken van HTML in Java, waarbij je lokale bestanden + moeiteloos verwerkt. +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: Hoe HTML‑bestand naar PDF converteren in Java – Snelle, betrouwbare methode +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: Hoe HTML-bestand naar PDF converteren in Java – Complete gids +url: /nl/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hoe een HTML‑bestand naar PDF te converteren in Java – Complete gids + +Heb je je ooit afgevraagd **hoe je een HTML‑bestand naar PDF kunt converteren** zonder te worstelen met command‑line tools of rommelige oplossingen? Je bent niet de enige. In veel web‑gerichte projecten – denk aan geautomatiseerde rapportage, factuurgeneratie of het archiveren van statische sites – is het omzetten van een HTML‑pagina naar een scherpe PDF een dagelijkse behoefte. + +Het goede nieuws? Met Aspose.HTML for Java kun je het doen in slechts een paar regels code. Deze tutorial leidt je door het maken van PDF vanuit HTML in Java, en behandelt alles van projectopzet tot het afhandelen van randgevallen zoals ontbrekende bronnen. + +## Vereisten & Wat je gaat bouwen + +- JDK 17 of nieuwer (de nieuwste LTS‑versie werkt het beste) +- Maven 3.8+ (of Gradle als je dat liever hebt) +- Een Aspose.HTML for Java‑licentie (een gratis proefversie werkt voor testen) +- Een eenvoudig `input.html`‑bestand in een lokale map + +Aan het einde van deze gids heb je een uitvoerbaar Java‑programma dat **een lokaal HTML‑bestand naar PDF converteert**, klaar om in elke backend‑service te worden geïntegreerd. + +--- + +## Stap 1: Het Maven‑project opzetten (PDF maken vanuit HTML in Java) + +Maak eerst een nieuw Maven‑project aan. Als je al een `pom.xml` hebt, voeg dan gewoon de Aspose.HTML‑dependency toe: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **Pro tip:** Houd je `pom.xml` netjes; Maven haalt de transitieve afhankelijkheden automatisch op, zodat je niet extra JAR‑bestanden hoeft te zoeken. + +## Stap 2: Schrijf de conversiecode (Hoe een HTML‑bestand naar PDF te converteren) + +Maak een klasse genaamd `HtmlToPdfConverter`. De kern van de conversie bevindt zich in één statische aanroep, maar we zullen deze omhullen voor duidelijkheid en foutafhandeling. + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### Waarom dit werkt + +- **`Converter.convert`** abstraheert parsing, CSS‑verwerking en het insluiten van afbeeldingen. Je hoeft zelf geen renderengine te beheren. +- De methode gooit **`ConverterException`**, waardoor je op een nette manier kunt reageren op ontbrekende bestanden, slecht gevormde HTML of licentie‑problemen. +- Door de logica in `convert` te isoleren, kun je deze hergebruiken in micro‑services, batch‑taken of zelfs een eenvoudige CLI‑tool. + +## Stap 3: Voer de applicatie uit (PDF maken vanuit HTML in Java) + +Compileer en voer het programma uit: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +Als alles correct is ingesteld, zie je: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +Open `output.pdf` – je zou een getrouwe weergave van `input.html` moeten zien, inclusief CSS‑stijlen, afbeeldingen en zelfs door JavaScript gegenereerde inhoud (zolang deze statisch is op het moment van conversie). + +## Stap 4: Lokale bronnen afhandelen (Lokaal HTML‑bestand naar PDF converteren) + +Vaak verwijst je HTML naar afbeeldingen, lettertypen of CSS‑bestanden via relatieve paden. Aspose.HTML lost deze automatisch op **als** de basis‑URI correct is ingesteld. Omdat we een bestandspad gebruiken, behandelt de bibliotheek de map van `input.html` als de basis. + +Als je een HTML‑string in plaats van een bestand moet converteren, specificeer dan handmatig een basis‑URI: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **Let op:** Het vergeten van de basis‑URI leidt tot ontbrekende afbeeldingen of kapotte stijlen, een veelvoorkomende valkuil bij het **convert html to pdf java** voor de eerste keer. + +## Stap 5: Geavanceerde opties (Fijn afstellen Convert HTML to PDF Java) + +Aspose.HTML stelt je in staat om paginagrootte, marges en zelfs PDF‑metadata aan te passen: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +Deze instellingen zijn handig wanneer je **convert html file to pdf** nodig hebt voor afdrukken of naleving (bijv. ISO‑216 A4‑pagina's). + +--- + +![Illustratie hoe html‑bestand naar pdf te converteren](image.png){.center alt="Illustratie hoe html‑bestand naar pdf te converteren"} + +*Het diagram hierboven visualiseert de stroom: Java‑code → Aspose.HTML → PDF‑output.* + +## Veelgestelde vragen & randgevallen + +- **Wat als de HTML externe webfonts bevat?** + Aspose.HTML zal ze downloaden zolang de machine internettoegang heeft. Voor offline builds, bundel de lettertypen lokaal en verwijs ernaar met een relatief pad. + +- **Kan ik meerdere HTML‑bestanden in één batch converteren?** + Zeker. Plaats de `convert`‑aanroep in een lus, eventueel door bestandsnamen uit een map te lezen. Zorg ervoor dat je uitzonderingen per bestand afhandelt zodat één slecht bestand niet de hele batch stopt. + +- **Ondersteunt de bibliotheek Java 11+?** + Ja, de huidige 23.12‑release richt zich op Java 8 en hoger, dus je bent veilig op moderne runtimes. + +- **Licentieproblemen?** + Als je de proefversie langer dan 30 dagen gebruikt, zal de gegenereerde PDF een watermerk bevatten. Pas je licentiebestand vroeg toe in `main`: + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## Conclusie + +Je hebt nu een solide, productie‑klare oplossing voor **how to convert HTML file to PDF** met Aspose.HTML in Java. Van het opzetten van het Maven‑project tot het afhandelen van lokale bronnen en het afstemmen van pagina‑opties, de gids heeft alles behandeld wat je nodig hebt om **create PDF from HTML in Java** en **convert local HTML file to PDF** uit te voeren zonder externe command‑line tools. + +Wat is het volgende? Probeer headers/footers toe te voegen, de PDF te versleutelen, of deze converter te integreren in een Spring Boot REST‑endpoint zodat clients HTML kunnen uploaden en direct een PDF ontvangen. De mogelijkheden zijn eindeloos, en het kernpatroon blijft hetzelfde. + +Heb je vragen of wil je een slimme aanpassing delen? Laat een reactie achter – happy coding! + +## Wat moet je hierna leren? + +De volgende tutorials behandelen nauw verwante onderwerpen die voortbouwen op de technieken die in deze gids worden getoond. Elke bron bevat complete werkende code‑voorbeelden met stap‑voor‑stap uitleg om je te helpen extra API‑functies onder de knie te krijgen en alternatieve implementatie‑benaderingen in je eigen projecten te verkennen. + +- [HTML naar PDF converteren in Java – Omgeving configureren in Aspose.HTML](/html/english/java/configuring-environment/) +- [PDF maken vanuit HTML – Gebruikers‑stijlblad instellen in Aspose.HTML voor Java](/html/english/java/configuring-environment/set-user-style-sheet/) +- [PDF-paginagrootte instellen – HTML naar PDF converteren in Java](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/english/java/conversion-html-to-other-formats/_index.md b/html/english/java/conversion-html-to-other-formats/_index.md index f3a76a424c..22bb3506b1 100644 --- a/html/english/java/conversion-html-to-other-formats/_index.md +++ b/html/english/java/conversion-html-to-other-formats/_index.md @@ -97,6 +97,8 @@ Learn how to convert SVG to images in Java with Aspose.HTML. Comprehensive guide Convert SVG to PDF in Java with Aspose.HTML. A seamless solution for high-quality document conversion. ### [Converting SVG to XPS](./convert-svg-to-xps/) Learn how to convert SVG to XPS with Aspose.HTML for Java. Simple, step-by-step guide for seamless conversions. +### [How to Convert HTML File to PDF in Java – Complete Guide](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) +Step‑by‑step guide to convert an HTML file to PDF in Java using Aspose.HTML, covering setup, options, and best practices. ## Frequently Asked Questions diff --git a/html/english/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/english/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..bf0d15e8e7 --- /dev/null +++ b/html/english/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,251 @@ +--- +category: general +date: 2026-07-21 +description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: en +lastmod: 2026-07-21 +og_description: How to convert HTML file to PDF with Aspose.HTML in Java. Follow this + guide to create PDF from HTML in Java, handling local files effortlessly. +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: How to Convert HTML File to PDF in Java – Fast, Reliable Method +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: How to Convert HTML File to PDF in Java – Complete Guide +url: /java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# How to Convert HTML File to PDF in Java – Complete Guide + +Ever wondered **how to convert HTML file to PDF** without wrestling with command‑line tools or messy workarounds? You're not the only one. In many web‑centric projects – think automated reporting, invoice generation, or static site archiving – turning an HTML page into a crisp PDF is a daily need. + +The good news? With Aspose.HTML for Java you can do it in just a few lines of code. This tutorial walks you through creating PDF from HTML in Java, covering everything from project setup to handling edge cases like missing resources. + +## Prerequisites & What You’ll Build + +Before we dive, make sure you have: + +- JDK 17 or newer (the latest LTS version works best) +- Maven 3.8+ (or Gradle if you prefer) +- An Aspose.HTML for Java license (a free trial works for testing) +- A simple `input.html` file sitting in a local directory + +By the end of this guide you’ll have a runnable Java program that **converts a local HTML file to PDF**, ready to be dropped into any backend service. + +--- + +## Step 1: Set Up the Maven Project (Create PDF from HTML in Java) + +First, create a fresh Maven project. If you already have a `pom.xml`, just add the Aspose.HTML dependency: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **Pro tip:** Keep your `pom.xml` tidy; Maven will pull the transitive dependencies automatically, so you don’t need to hunt down extra JARs. + +## Step 2: Write the Conversion Code (How to Convert HTML File to PDF) + +Create a class named `HtmlToPdfConverter`. The core of the conversion lives in a single static call, but we’ll wrap it for clarity and error handling. + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### Why This Works + +- **`Converter.convert`** abstracts away parsing, CSS handling, and image embedding. You don’t have to manage a rendering engine yourself. +- The method throws **`ConverterException`**, giving you a clean way to react to missing files, malformed HTML, or licensing issues. +- By isolating the logic in `convert`, you can reuse it across micro‑services, batch jobs, or even a simple CLI tool. + +## Step 3: Run the Application (Create PDF from HTML in Java) + +Compile and execute the program: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +If everything is set up correctly, you’ll see: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +Open `output.pdf` – you should see a faithful rendering of `input.html`, including CSS styles, images, and even JavaScript‑generated content (as long as it’s static at conversion time). + +## Step 4: Handling Local Resources (Convert Local HTML File to PDF) + +Often your HTML references images, fonts, or CSS files via relative paths. Aspose.HTML resolves those automatically **if** the base URI is set correctly. Since we’re feeding a file path, the library treats the directory of `input.html` as the base. + +If you need to convert an HTML string instead of a file, specify a base URI manually: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **Watch out:** Forgetting the base URI will cause missing images or broken styles, a common pitfall when **convert html to pdf java** for the first time. + +## Step 5: Advanced Options (Fine‑tuning Convert HTML to PDF Java) + +Aspose.HTML lets you tweak page size, margins, and even PDF metadata: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +These settings are handy when you need **convert html file to pdf** for printing or compliance (e.g., ISO‑216 A4 pages). + +--- + +![How to convert html file to pdf illustration](image.png){.center alt="How to convert html file to pdf illustration"} + +*The diagram above visualizes the flow: Java code → Aspose.HTML → PDF output.* + +## Common Questions & Edge Cases + +- **What if the HTML contains external web fonts?** + Aspose.HTML will download them as long as the machine has internet access. For offline builds, bundle the fonts locally and reference them with a relative path. + +- **Can I convert multiple HTML files in a batch?** + Absolutely. Wrap the `convert` call inside a loop, perhaps reading file names from a directory. Remember to handle exceptions per file so one bad input doesn’t abort the whole batch. + +- **Does the library support Java 11+?** + Yes, the current 23.12 release targets Java 8 and above, so you’re safe on modern runtimes. + +- **License issues?** + If you run the trial longer than 30 days, the output PDF will contain a watermark. Apply your license file early in `main`: + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## Conclusion + +You now have a solid, production‑ready solution for **how to convert HTML file to PDF** using Aspose.HTML in Java. From setting up the Maven project to handling local resources and tweaking page options, the guide covered everything you need to **create PDF from HTML in Java** and **convert local HTML file to PDF** without third‑party command‑line tools. + +What’s next? Try adding headers/footers, encrypting the PDF, or integrating this converter into a Spring Boot REST endpoint so clients can upload HTML and receive a PDF on the fly. The possibilities are endless, and the core pattern stays the same. + +Got questions or want to share a clever tweak? Drop a comment below – happy coding! + + +## What Should You Learn Next? + + +The following tutorials cover closely related topics that build on the techniques demonstrated in this guide. Each resource includes complete working code examples with step-by-step explanations to help you master additional API features and explore alternative implementation approaches in your own projects. + +- [Convert HTML to PDF Java – Configuring Environment in Aspose.HTML](/html/english/java/configuring-environment/) +- [Create PDF from HTML – Set User Style Sheet in Aspose.HTML for Java](/html/english/java/configuring-environment/set-user-style-sheet/) +- [Set PDF Page Size - Convert HTML to PDF in Java](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/english/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/og-image.png b/html/english/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/og-image.png new file mode 100644 index 0000000000000000000000000000000000000000..23c6495d33919ebaf423642df80d5692e27b2787 GIT binary patch literal 47227 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Π?dDw#}XxPN>VQu7Gs z#j>%wFj%)^O)#fyu&+-^*_X!lr?;!+gbi=aHIKu9w1b0#dicR|hcVJ{8j*mrScS~jaLT(+;Qs=fNdPlH!=EJ80dp##QSw#sBIObiS~`Gv5%rKxW3 zgPqysk_sbQ#KoVHOy4>7M&X5(Ub$`*!Hf-qOm30`xE^}bgIizm*AV_M-Y69n6$h@X zx42>zrKN=`4n6h#rAEHR(_-zk2bjPd_w~3__Lt&n0ai8g>Q+aRiI_B5n1!97!NlA= zWo(7+R~Iu?__ddBxUCQYCCBM?bZI-)L0#@Q4RdLM3#?w%36a3#{!CV@cWYf}$dR-z~SCcpPd$ z6=&iMejTMUbw$jxZ*;jb%1eQN-pI*WL03|hdK$sV@6E!VZf-}jEmreG*PK*$+8&$| zUAfCXu&#jtR`oMraR*#l=AOz2@f$WZ`!9GELRI6zl=qhbzEKJTQ;U7MtEB~A3!R#N>r)}FVYe+Sz3yYP={*ksRk zz=$=y2(tP4dCMWAtJ6?^r{3-v$aL-80aJ*~g69D_6=-#1w~h!?PcNlP?>eLU%|T4@ zPyHP?A1~d}Bqt#up--P4tUZ*Z#i#3rb;eR{CnoDK(?6S#PuQ&V9}H+Gp?qAEN>f_N$sANG1(<3OzqnJ>eZT)K#ivC)pbeF_pT zLn9p>F55Z4M{C@U{%+;o?t$u2ECsTomm!j-ouI<)?NZ3ffEk+sx2JCBQU#weaurFtB42W zgZlL*RPGwV4P5qk^E~vC-Fh8c1?Om*v8vjl;Br_~AYVfR0EuKcCg2t(x;rmxqJKX` z`1?Yi$cTGs5Tj=7z;nN)hP04fU};TF1-;BGwX>Ct&P4o_%P!0>1ZG-OVHFoG#B*NB5a(!eky3>7URt<|pSSitpX`y3F!bCc!~u$X$c zZ?}t@+S(2`W_86Sd8T1)EvVxXFi&giOJLQ)dLit4S^%<^_p z)l#bi)1F77wvmzZ-cZXjn1Y;~Jq39#K*~3QZG>A&xTm)>HWD~{o%*yqq;+M96{@0h zn!wP~I+f3GuJVpnhktWZ76xg@<^^zcC@Na#-JT+b^GtEJJ%MCeS{gJWa*{{~KT%`U z#DecTsNyi4;GixAu%ydynqai)-mtzifUF7m5{Fm)u1>azA{XZ8gRv-BdEco=o*(HH z!WP7Eit>87uu$nnO28$~zD`iH7vlBBX zeJ7Bj*R_o?dxYq?%nEirT@{;rIn+?%SlZy~6y(KTSzdT+Bp>ws>UzORoKa?n&x)SQ33^4W)or z@bD^nW`4;|>=RoV@cXUF$w{*6?U>V;?M`70dQ9}GfJKZa1U1+`H$Lxkx|ov|03dZ? zwAfCWYcNz|diX$Ev4my`n=UbhXGxq3+r_fGKY3Y<=uEJ)6 zqY9AcO_4c+N4LUc$~)D5YE1%KWeeP*5>xiwstT| z0s49tN?K_}MZ0;3ykv6jj@X~$aYBbfNd-AMov>VYf7-L++*D3B8&sJf&`?(?ft3mVVRcK>3A5mgHi-ylXfW%*p-&U95}kwq&s^e^jt_ zC@z|TIy6QIX;4$?2`W`6m;z|;XJ0P>=()fJzRmf)s(c5pDkumM65-%D{N$pI^EuE< zs#qETN<`SGK<~N-b-Ec{?jCAEze!S*b}xmKPI<-`GSEXa6+m4j1^2wq8n8O)R%3+snNRGcq_@ zW^QUKWct@$a4U(=)gOt#`yTCZA>jvQod@ExV`Jir!?>8+HrW8Dl@NBrll7S?1V~X# z3Hyfz3RCu2?TLqnIaq9VX{AD7C&a{LoI39I!^6&;1DC7YO#U}Ipd|uPCovt zac%7+ksJM@X8|wSKup&GrDO6`3Aghi$b-1;Y{M6-KX>={_4V}B+_1S2dxNVP0`90< zFdFBpop4pr0I+A67F}2`IvCdB)zX~*_`2|Qv0YATWOi!H71@(%NkNW9DvlKwy=H}Z zKKZvv8+%EUWerBL2^O8L7Z#3htb0d9^c#=9r+muW!6pK|FtyW%e-!ag(D{7pZvO{6 zhhT1Q{;d{&0tfcv)6){mx;nznrx8DyT5+A1;WEaqu8Ojj)0tPnRA4(B+t5&92kff6 zJi=!*wPtT4KH;hJ)|OP36lDFJ_+_eQ0SSs?f2D&z@G?<$Zf#>?(=L}>Vtn^pu+GvA zDI+Cimh|NlHiku00YJJ9i1s-+louG%)6tdThSG;V_&jV0U2M=fy++R0Vy70W+;o!c z1sE@Y$G>mr@b5V!ZSPIDX5@Re^uV1-7QLjn_*tLT*HeXRfcros&&7lq@>-I=Euj$R&;JP`tztGWl@2w z+Wq39knu%!!Q8AaEWov(hfGV4u~0cucy4)at_AiZ2b-&cRLFff;~fwLWR6#6@n0p8 zZ2f{Z3T8YCi}|7#Ia|nm8V`uCGQwJl5yWq=%OWa39vz4^p$J;uHfo9{#}x@YhV50} z@8^mf`3G$aPhYF9>hMQ60B&v?>huJI7RVVoj!*aHVR7()DWc4&Gved~oa4IMm25j^ zyk$IAe0O6S0?}~N1p_q=jXpg9sf6DgE2*k-z5Ef2mz$G=PeMLnW^3U0kT$=pjE%O$ z>X61O^NlkO(~7E%ot@OU8c}qVR%7+2gVx9$zF+y|R+<_bgcn$bi=5t$LSh@2j~bz)nkf2EX}2<|)dTL{t=8XZPuE9 z#;cq9imbY9`qU>S8;`Y3)&D>QijhO6r?a?iJ{Qk1&qoqq2t9p^vfJkRbt6(ujVDgp zCpuagjT!A3%0-*ZZq+@a85ohFJ?)wG(vK%(_JNR94w6BF^N;-KNx4+5EzlP%6{ zj$TR$V+FY{UcA2TEP(e0`>~U-G4Mra&u3o!UM4nHGg0%o3CfWQl6Dx4)^}DAb+P6q z`Yp~zPWF36Sr6<%+>KRdsf65#=VI|eNghTSVNUb2YDyvVI9g^ZWm{@-wG249fCYc; zC+vk;YjddSYAX42@+wZxYm;3NJfVtZ+Q(PaI7lk?*%bSzag=Jmm>E1&ZoemY(RO*@ zWM>C$5EZtq)^8zB17~ z_D)Pn)KGHw@Q9fsDjVy0S**P9JYj6 zYv5Co6_)f9O`+#^ble)9`V&RZ=6?G*wa@>Kour#bQCWFQaev0|3OtJDEz2?xu3-hf z-Q&qwnH9ix#=<5`a^p(P4IE$c#Xa`Y%&tvH)bM9R_FEa>BKE0^C3BqY?|gf?!~*DS zS(68sS}F6Ci*qE5FtO*$7Q~MMlHuZLrFll{nV}Jkg_le#x7Yhxb1HfgPu|D>d%%Zu zCLdy!5}VvCB*1F>dizKR!w`GrzC41j!zSBOO*PF0y3vDAFyx=^O357l;}Wb!jdQcC zZs!wC#m2SaQE!PzBHcG;G1N7-M>B0~O}Q=I%Ew9oNaYKo&Q(ElYgKs9yVjMeR2nw~9bMu@i487ur$z4M z?s{(wL3-bB3^SI(WmS1XzLK)C$Td*$cD8@d;!wGjG;C$E3bwZTK8H@4SBfEcvAyIR z7yUXjF9Imd>xAD2WL5tix0@uf*FqrdZydKa8jKZ2*X`uy3AqQ09jcK0cRWSInLHYr z#%(%POU!wGmqVkom7L#1R(?y%m1-Ln6%!KP?4JM;=0&VW)a#s{CgxIIOzf=%6s@AX zyt2n*%j8y2XO;xf(Mjcib!H%0U@!T&-?3C;GFsEncFu*@vCpV3W}sp) zXQ21Lg9FqJ-um3FZ7zeImRldC=JjaSkdSXQJt)Q38`}knV+iQsOu0|M{?aAZbI81IuB!d=^@ZHk$B$|k2V!0+txT}tK*TTV$GM(AF1MY)$7onY7W*-VkW~q7 z4;4Vx8Js>3KLiRE=^L+%3=oEb@S9|5b!Uuj$Z_@8mDhJK?XACl`Xs7s;52iq&s!@W z`1N`p8W^6btP$VhI2>^f_w;Z?+5yJBz4Zf@ zkCm!e9)(Z$QGE`59)9BW-{7T6lO(@NWCrU2pFE79g}Io`ygW`_Ob2%dyExkU!!N;8+NW z$sBD>a|=p#cTA9rwcSmXnb~}1tlgid_!`oY%Mu+PRI#4>9__*Dtmp70kS8I%0itKP z^Vz5BKl1N2G!DfAXySvKi+%^ES zzufM_2@)x(rLSVtFoa3hNN813c+Hy zs+Y|zdHBO$`u-=G7_q%=#GYZMydQ{J$>#vZg456PxJkgX zsx$qo^pdkNZXn>NM-F!H0y-s&Camj$%t>Fs=@NiRj@{kcTcWns_7Dh!n}_ce50AU2 zD>g1>G&=6d>G=+9#xX+V@ADhnKfn9MAxtdr;xM)k4Opd--KHGIx4*6@<>+^R>7J%T zy5wRMxwnV)J?T?9*g!=&IW;gSkl(i$aJt7!O1=RK*^Wo+o&BSM9)}u`#P5NTvX(%O z$Fs#L)E>y>9yVj^iUq4mZ-Nq$5aT+#ef?0BuaMET>lLthqqwc2##>a=*yyt#jqTJ? z^Zuh%!b4RhlpP+x9Re)zFu)IX-1PXO;Znc27Z)e+WCDaWhi?G(g@CX~UcUnN@t> zZcB^BYTULlka}-fhBPSJF`P5bGUZijE_GYLyu?l?ANe?ST zmh95+95JZ4L73#lz4DyUN=u82qbNb%u;oY3Rl*cVqY;hBIxFkhV{oIrRgLaxK4Bog z^WEBZ0Kz-I)iObNV34iSsEyX6amg1p*d74{cDf#=o7E!YP4?cqf@4BLl$$8qdyuH6 zZomnXklkupK|UuDv0a1AJu7wo^8+9xOFKK?-zrw!UiK!r+i4G_z0v~e`f&xdwXThh zD-BlA2d~5Ex)i!&NVAiT)wHxYT*a^QtBZ9%YnMb!EiRr;gz}34Sx72RAvOj126WrZ z(bCf7JAj??BxUmO0Hz9%C7kH2+*Nz6w$JetVPoSEz=w;(0q(MY(khlxEHN&v@{)`p z*3cIRs8gnyh7OekOBaL_)NXr%)N@i*|B*+L5Yb4Kp`S1=ci>I1x32T-~doNYs-%FIJ_AKEZoOQ z6dlYyH2mUM*XN*z0Q+!wcu-zZaqi|0%zh9EM3J7Bo|eYSR>oadOKonxq$)o+F!J-2 z@XKrXHBM|e7S^$=vvXrz%`0wh$ixINuh~h;Dl(^l{99f9owl}-p3&WvbAY9`hxVmZ zVn7=@N-b`lKQ)W3fV$< zc*1|bcjn!chU`C^s^XTzSuX>K{@+`gP*7-@J8AQ2J@4f%sMzFxf1<2W_^&NgH2G+l zG8ZMk~bE`PMe#g45rUHUbp| zl^nGe1!cqB(UOFUgn(!Ry1DxvkS>@x09A{kii)YZxj6`AaduWyT`Tch>ct<4Euf0M zC>Q(94CPU9QlaIWzOf%Dfnvr^XucqQeF~teOX=Xi7(cf>Vrz4MI9S{JWh7_Acbowy z3@B^584CLNQGmTXFRSU97Tr9^U)b)IOm1fx){wM3erjcHU2Xky@f}ZL2o`4HWC$<6 z$;)Q|6`zzua&%PLl}C3iwzWx`A?kVu)T?cF$@-)|2ITact7HkkKRO_*p)+-JcMloK ztEwuhs_I38%yp~(z}gX??Pi<|+XBw^8Yt{>&{8q}PA*hR4Z`>tWB-%6f=HPqg|{Ev zodY%t+^gE_k5v4Aje_q2t_R#Vn8dTk0ewo{-t~o@&byTK{-n=kk#%K}X9JsqdwcsZ zYJqnD?dA4%KXZ1Jk9(3u+$c1e1*7ck*?*CS z4M1-zs?FCYXwbgr*dA84rnLcwrN5iY%zA&XnLI*KGrXU*aTAl1@Uy1uLZ!6tKX~2U z8ot$_3=|fWT;K8=3)gvd{?aHMw{{Vw0F=%TD1eHjH`v-`^t+|Cz_f%4U@tV-5&AJq z>(|flb;1Tau>GNl;H6SjH00jB=J^V_Hg7Wgq!(W)ml_`3HIc^V#G?ZUH^Yw6);6?xL0w9bLhd`VWYdp_~ zC@4Wfz>S{xz$#{5{E}iwtpn1O`RIk@Dg#wz#VSCZQc*HBF%86eJ{}(IV;H~#e~F2x zu6`+(^zb~I-^icEW8(vcl}g}OZ=mw9;OvPR8Ll>7mm6Vi~pFcn7k_-*S z!o6-S^ z=0ir=Rppfl)5(G4%o{#3yx<9RLkzwG=RVg48s!sa_i}hyv7?n@~qDD0#D0nJ#W|u})OifM#dXTjpbvl3l zc6$f=^K-X3dyjYTx`T$wBaN` zl1QzUFz7l>J9*IcX8IH@!sI6Ft}DTUK1M;)gurU%6!;{me`5aPq4K z+J2FiSrJ{F3e;DC%5iTM*vYbPZeV$3BbZ`DMM_#(#QkQmj%`}K_YF`vijASfC!}OK z{G-WGVBvd7wFs1#ZbDJ_(ytEAr2)U0qrp?>5*nMvyh_fb{H)1pn?zj$e6!UH4OpCo zfr=|7r9zDaToZh$`)#o(t4B5<6G<gX+q7gO zT{ClYW?K$`7x062sk%~&Xlrr+f#7yP(au=6O~Ke$6*6>zjlF`bc0QX9Y;A2#&}nEi~0I_J`rDjb>=HY^qV{^7wypI>#>vaE}K4*0eU~ac}2s0S0FADNVE3dh<00hup zGNq=DowkUo$fM*z!@7VV`*9kiO$hz?_wbq%pg+yt7YA|OnDo>qLo>bmVNT#T&93ef z!Ojr_U%woWEzEEMqPq08iW1=Is>A|ey@k{O{(CG2fI(vc*MlI~a{d=o4B9-o=w_dj zjpLm+A@)G2e!oGnXgR>_kqmF&=rWfmeCKMlW6QG8-_>AuZ!h3vP7cFaXQon*vpcC6@82O$*b|ZFb1^?WQG0qfFL41lJE?CAeu0k59`F&v z0>_@QKR=o&NJ%(S=oY*;c1*xl+euE~n|fa_#`JGpd9hTB469}#PtGinr|bL(aF~FQ zfsijd^O*53il2{so6yjn474=-lz6bMN_}$vA^F4IPVq6IOzl4&lh&g;a^$bfc-Q13 z7|(LSkBNo49^zicnIR(U9~5Ia25`v2>O-zy0q~S9=!u`~9x*t4(&hWxGVdc0^5^2i zh`DFY#HdU;3(CyG*QUw@m5mmv#|Z09krn!K-9WgFjiO! z1-hzAxxj_2xX(52<}Qnb{Y{$NT8+#<0 z;KQEhE>P_kb3*vjKzJUV(K(PuH#(d-b%mnJHza)eboWVQVe@%T(F$($k!N;92jPF| z*@?|o5rVZ#DFMev6hW(XzLI?uRh`n#PYS%`t(~mc`hTDjaS;H59YD_v0fUMy0nKHx zl|aCno0e9?>FXaey>>9M^pc>r{mNMaN4?O_uihsBYU=+$5{Os@f$tERSTGOKWg~z= zjPthJ9!|BfWL1QZ0(!fu&eP9vPa$(QeLwv{#T3H|ed9mx#yTnEny9Jl+i31KM7#_0 z>j8ZX^C*WtyHv7HFrJiD5TIu(y?Kx{`D-1i;nnkBTf=VUfi*uJWy4xi0#povSb{_h zLIJ!@PQ}wRC(MY zzYh1*Zkc9pWDn&J_8xVxdqky+`Lkz zutcN9CINKt*&!9v3o-55SpIdV3 zIBuRPVdEF5DX~-1}Kd0-aU_&E^xt_-~5~ z3K)1ZQ;N~4sjJElGM3}h($ZBkgxX9184u=2is*GFOl-@|?aTZx!MZ{XKh#D$=!3nb zgCI&x9w1|f@Bp$wjb)az(@48w{*NnRV?VokU8uHRH`UMU>PJUVb_QH1=;)NrI2-%j ztX?Z71JzQrfP!u4_WI!=ODUQRMpGkDKN#g$0NRWPs`Yql2fXH6=Oz2vTt(LK(th)R zt2=$gEd7GndH1P-ZRXD0^73-Mc6$p2z1Ba;zt+|`7VZT7&VR4oBEQ_^x&W-C=g}N8 zyGDpe_e*_N$;CJ)^XK&Rlz4v8S0zv!uUBkq;i;b(4PW&KmUmv<3_^w<2!TLNw{>uU zBL+4sP*P?BLNj3Tdc8kn4PQPOzkxr0fU@(%3Ekr7?#|WiD7aTC$k=Y^vr}gwf=0GiYtAT$dFXjD6`ED+wdObPctJhRKLP;;? zymR5C%5U0XJI>4Evl0zCfO}lps%~%3&CPu)Z^!>~EYJo3aDNp_BZi1mJExUS*QUb8 zm|;sX7WVnO(X3T7#!Mmq7*h#M%rmXQ&6`4gHjov-_;fs!te{+!dSMngcOJIkuso8{ zCg6W5NjfSHvVzJ_ZufLEsf|*T2q|SLb8uBX6Z9CcG7d=pTQzMcD7cW2od({6Ooz-P znw|!K#aNeJn4e|7`~Yk|h|Dbn1X3Z2NuJy3~4U?=i&e+lWkzU81{ z$Mh4dV^rjmjU3pAy4{PPsLWK(=Qx?^n@T`Y6~)EuK$|pL*vW&GYFgQyomB3i&wxM+ zc&^T~JLFMOKHuxtz&4dl;i22RBI7(Wrj1QvEQBktx#&U8L(LgT43*en5Yj&@E@>G+ ztn>3}05!FHRtC_w(WWdM92~fwO`lri6tj&fv%fM=y@2CVapI{Jm zg^Xr{G$8bVi;M^$EopmsI7q2UVd|S+URt8QJWo2Dt+=G?wxn2vak!MwZCYW3RJaLJ zim=cT25WA`1acX)a$BxN(ep3}hVpaP8hqkwlit>Bg zNA-i!B^?6N-6gFwBAt>-clQt~B_*9hO1HGMl7e(eBi-H1z?_ZW&-?z~b=(YmQHY+6DupH@z*u)R5?oR zKrnQmqn!xwRuM@Y#6CEefMEMQHL1q7%Ta+9jlO*B)v&T6qXZQ6IbIY^mP;?yfOwgT zwIm0-n|3ZKY08vw7&Dzh6UU^P26V7!F3wsiXGwCOgE9aFP~yMpqcb$EO>Q6ypzi!= zK3x(X-VYSb2Y#Im`&7rYIbe%DPF4yyo7WV8HbJ$k$~~C(76LxeaDiG&#AT1Jdu6pZ zO8f1Hp)~Hq6$6;-FOQvW97=InZug#vK0hbfq7jZy`=P~cIq&{x@+0kIEeAQ9G8HU_ zM@T@7%nr@3AFJFg*1L{m(t>*5>Fade=J(qKKDCA%=LDo`=Dek^9|FHLW;4WZ^L43B zO!$G2?SX!HD|4^YSqmFO4wCzvVP$Je{#>Mpvg@-gm{0|ITD#lZYJ!RLRj!=w=z@+* z%K z(ay+9sQ>%KXy)!_WVrb+)hN3)`N_RMHoc21kE$zD0DD4mr4cc|mX&d?R3H+w@PW?Q zQ6SG@c3J{wC@qJbhITaKml2G_j;?+~$%Y91L(HP}id@3;pweCF%oP zjDdpn8(9m1ZcKM~O-Hmd!r2dPaa+5)GC{%ESlDN0PM%*IYHDk_1bD`#MlE!9htPI*n%+1Yba(gktpD+Umw`=k0;ugEVpouT~3%Qm;ik=9wjp^*% zT(KpWfPngxSZXOo_r(1(dZO7t!UnymSD7vE_fAoCZr9RKI#-)2|0Y790RT;DzZ$yJ zXYOxigiMTE0H(Aq?(_Nyd9$#HT66~u_0H4@NGjlf7jl`>15nGv!Ww3Y;a2Z|zOqaZ z$B?F$mA7{=UAcWtwJRuVG3)a}+UD{S^ZPRIYAAHXDbBb8kL*g>O!=Y5iAg$veA_SlG-CVIZP3E44FB^Ryu z15Hepxc||gMG8<9tI2bZ+_ZE*0>G*Co5eeUM=;2@g} zETY^yj-j5O+5UcY($cBlg*FBY^Yb(cG!r$});6yobeh^)eZB`8p2wBt*(&E|Kl77_ zN@gOX2=D=0%yN5bZQk%fv)m9DasslYPbHctLOYcnP$-mM7^bI(d_S2`QBfia7`TZ8 zD=Ih==a`MDDt}o@?2?C7 zRF=wVT-v0&`3J+Ya{6C-noJ;zn_q?0?Frp~G8XLoIdh+Th~}!0T)plZamFcZ#x&A~ z#)3S@@kz|PH=05T85vn>AatC^vz!iT=T4`NzTCI=@ABIr#T`RcN<^q>N4$D-v@Ib- zoV=fP#romX<0Z&0zZ?oA-vB~4y=3^MxjRb)f*g?9hu;(CW2UdG>AO2cv7>c%h|SXS z)SSa==B}HOPOZ{mYQS1MDG7ZzRJ$L-gM{R#fXB_pmECr`v$du9=bBYz^k>tvoB?_y z1(&cJinpew@scckNgG7w#(iexWAtL?H}1p?-R|gKpqxWc09G zlaUd$^BC@M-k?&qi5n4UP;G9OUe4^Vt}5k@7CCkSh(UC|7`xH8uZe|l_t>;#-ow+A z;_ABCrTJN3A8ZW67W6TC2rg%i35J{m8e#O`h08^grYDODg9!N+(VS6HJ$J~n?Gg2W&Bk@l%`jA){4Gg)0(pkP$gu1>i1voNydC?=! zm)?w(AgfA}2uSqk5+&u+sPD}4XE`qOT|HD_l|Z1mqm-}qgctjQwxf)Y=OrT`xPatA z6<-)L`#YE$Ma0qJn8^X;V`G5nLZ^B$KQOVj&|rjLmrd7+gB?Vn>5dk5$#iqKTvJsg z9&jTM+66V4A>W$!=UUIR$^&#ScJA8h>e#ur#k;FPP5VVzRG6h>CY43D)nhejHhE#p zl1P2{tJ$b;c=4N=89M=eYW=aPDG!~q2bZAk0QERCGk#HT2*A)Ou9~wa;(t%|+^jUN z0#$QD6Fm^QRR`;W-n(tskYn6oq55k-i&4>??yNVW#&tu0odOYv%v~agBEgSE`Kg4g zT1MR-(Sk-%Z0u1^s*Q~er$I{@i%8MVA`oj=Eo`Pip&256YY{3EeEi%`pl{8*wx$N5 zD-H(P-zG);PxxfeY2~C<(w-{=r3}OAsmfxZZcACqijhnBEb;tG@G0E4RYnO56PONK zB6qJ4a~f*=>3J&gQY)Jv+P?@ZI_$=DT!ny_k6$gA=8Ik)PLZMNO`olW&&k$ZRvV&! zaY$PMddw7EB4+l!-SN=kA9%RQDHS>FuB%bndkrT#ER9Rqtb3iW%X#v|yu|(U1K<|$ zbi&4Fm#F|y1VsFO6J2Y&oDymi7EgtJ4Q7d-z_2N|K`crH&j_ICg11#NdvA2q9YfyR)!B(5;d)Ud)mOgr4dF z^jE(fCFDXvFYXK#6?dbT{Lzmtb9FuDJ}F7&<1{PHy(8kO@;H_spc6=ia={aRl=&clDtsn9ToHVW&|tfp^=1Hd z0QroG$ogTW;Z|ULa-SJ!1n1g5IPZjcw!u5nzK*;D+8Qh@td!Rwsl{Ot5gMA((-^zj zw{6ELq=K|!fj%LX?N>`c(?ap*uoO_lc4h>WL?^4B#+jn^?Z!Ro5?*V%`s7;cr<;xv z81~Wjrlzd{!vbib1**|Vm=7j4GatU;vRdEN@Dpo?&(Ongo_eRiiZ1ybmnzD!FFe9$ zBSAegZpk^2%5Qig<8dgIEh$oj+y=ja{X7~OiODh9oERU^5H?={>v-M3R72ymKtiDX zwg)+!FhjIHV7N^RvuT&(FF*=nimrST9u@txbrExX}&_1so;KgvXrl58&(|O?$K{Q}k`$FEhEA;bIV^~Ki(mUdty*1DX zEZ2=qMJQshJg2G$IBIPNxofQpfZHaq8FAqbrGdh%PrGmZ zJO*sz=g-P0kY>=J)$+}sP)5)K=>mlK7cZU{88$nY*3>9YWPiW8@d4=M_4;oK<*Zg! zP0fL~Jiu6>KsoapKw`r`Gnv&u4qx^mbu^>hH(QlXVV5+4o^`++WeRzJ9zyS5@L&Yr>bx=61>}%+{o9yGeVv4a?_aEpYNlDpd(bw zwy8bqD4CFtY(J6sH%E$y?e9z^P~`!b-@(pmVq%OB5Onn5O!sx@T9)oy$gaE`Lfpn;~B6pNf48=4lRXFCkI&i5KL8BEf73JaE84$Y-8_P3l}# zO-;zWrv=cW7c*qMJT=Lp4NVy?xV(KCA_3dy4U1HC!R`PR+*v%8QBVvxS{;Ta)M{N{ zt88%SGI)>(b~m}~%g$#sv$SHcIG?EF_@rhb%ubg?%;W_&-#Hjh3H>wYv4=N@Usn_{ zaTh43dHdjWqVO0&eeYy7$p)OPY!s!WI)A3@GzZrU#9odE%XIG=`6|s~3*1xXq765r ztD=t&x)*OlnPuPMJ$Kp5(_H@X9o+ZG{Cu_7cKGilpZ3N^88z$rx*AY0w-5@N0$0ZH zSB;K`9umza6z4^5J9H9=KDf;Aq#&Psou-k|j}Cg)=`U2&eVqLJKd$;}T&TnjYRdk& zGy?q+6BCo>f+5LQMowcnxlM4xN#YG5KJ}b!cQ0pO-J?cj-ikZsKDE>VzA$*n`51Qh z%s1$|d)uf?2q_HL4ml12Mj*jcl< zEvx>?`gRKX51#ZOO>P}#A zwo?mC+uGVf#UW}#QVROCR3gqkfH(DXdZ8XP!n?s12fsA~QlN=cjFlC9P4M0QE{lu) z=XW0*B)E-A|HC39)(Pex027_h(^9-52bb+;ZiYXp#RC|O83E|g|w`FREA=D#L0UjYb7`n9IC*Qcy|c~xs-e*WhQY`{JYS_ldVBqr*J z`XqQt@bAw?>3e%Wwn^Uvwe(`M?LEQlkN73HgkZa>1QLu|=6Km|?90>h`kK1Q$;o#$ zGwbV#I6O5RhHW13HBuSBB4+XciL8{ZpFn@3L(Hg8ZVQCO06UTUJg7f09R0Mh$kVes%q*| zMXlk}+*K7rLlzbVfahf|XIIH206mUEkh`%csB<+xiYlcNgKPg98ZgH|LqBV%s~R00 zwW!hs_X(DEuV8%*$y1{pADx(bmYZ7$GD~^RU|b`V66f<4X29Km}%BJwWyj zeqmK~?~V0h=sm6{KGHezSD^FnT;>xH(9+TYSpLvZUn?{vA;m4L+a%}D1KcNHuu;I< zgYU&t1Ox|KC1-f>O%i>QBR)7`Hy=VLVK>zCpj*NeP9Wt_RLmd7e>*p6P|BC(o*IWMgU(80@jWd@- zgyQd?d{MrP_3t17Bc%WQ>i^t${l9PMfB$L!596;hq>wFz{}(SZt`sg{=04IJ8L8Cs zI%Q>h-`38q<1G(pti6QCJ8f=!{ra;vw3>fIGZXI z&2D#m%DUDw)3fczcZ~3MPlsFD{X4NWv>n;W!Tpymst@1$AP4O*+Ia1y2P>jc8~dJl z7}{g;JnE(<$3iyM)mN9T8W&DM$q&4ic4Y6%<_Fmi%Guc~+rNIfJaqIwO0A1xFKxZO6*MA%%0nQ~&z~K< zCY;m+#g<2DAJs5JqUT$EQK=heQj7b-#2Dxqdl(seaO!Ce?jGoCXpB!SI`4HcFSb3j z*dQu3_S%OIFCJ3xB0Qh4Qy3bu+LBx9TpkrI%l0tjJQ-bVyPHGIp5;ALiA%)RWpNYb zB8dbIenBxw8w`F(QaGGc_!{FkO~Mmzi^wMrtxz7E2P&ICm{_{adnEa(t~?_*-u1B9 z$LGfX;g6sgSePg5ttlo}6e{)k`8OS+kDbe+eE}`!(NU>5W2n?2va;N?y`S`h7N%9R zpz-d@17X7wzPmf!HKLR%OW&QYo013F*<$nkXrFndRAf?8n_XTEW>8S@k+HM6JgqZeJZ!88px+!ERC+^d?e~=%lOYhdV}D1o@l(g@F-Mj}H)8Hr zugb||Ku4tF%T*YO{%TLo5QjYEsc{UFi+UE6KtL$&lai6?lZA^%_CzZ8-E-rKs0R;N z9w^BMo1+IlArcY=w-QyJ@wtLBV$w+KP3-wI{(}vEfrv@Jp>yv|)$*Gzgq-j-Y+ z3rp5sNlVXVEUJ`P=;`OT{y<r0`{1tOYD+~cjG@Y|J zLqhgsb!DUHusbiO?ckmE2KdiD4I4XE_U~f3!8{<+p1Qd~CLYf8O^4EYJ7c~G^K=jr zYDNwY%6MMg4#CEk?8ptlmpq`KUv_EipL_6<%Exza|TraaInWF~7K~FzeTQBseNmyciftO65~Y8wCYD)p09l32UK3sfHOD ztn4cxF zpe1p`liVJA5JkQ|Gv;CzWE}r3G14=&_b`d3xe zHB{AIVxiuwCLd1k6=txyJWrp1ggxP=^@IO&j)ke82K8a2_rl8}2xx{K0t14Gr1CQy zve{cXMOJb}R_LdcClF6Ka1v&7n@f2;sKr@!a(1Cnh$O-<0~VQ{z0j4##|}YiV1>)c5aBR#sPl^2EZ7 znrgYaiC*&6)6nY6GRB?o_PTaMJe}|S6^c7HIaB=Ot(O_zFOP zs{LvIT6NZ*$n^zRYN@er6oS9Ib8i5u!%0L)xN&QKoLiq_7UeAcPEi*Z4f z6ROL_`r?`mEN2ff=d~9;{jK#=Nz_9XJq!hSM7{63EowC4@jG)vLS?WI{l_~UnY3aq zi%O~`iv`6#a^Sb!Y(@qjx+OupY_Vy^Q0{A9=_kZ=eYd`#EU?5gu z+{X0+TM`5}%S`?9;^N7PX{U>|SUDV5y)PqGe?mh%+}z|7v)3k3sk=sg zrchyl2_0dnoJYqfASjrck|raK6-^IA1 z?TW45>}<`ZM2+`&G+ZH(a6Jm^9BkhUNRq-C2Rj=IsA27Xv-wvkRjb3oZ>(n_1`+($6q{A@qjZf$g`*ECyFhutfDsG zBA}tc`C9H;^au_vCb~%6IH%1dmduU+Ob3&pE;Nm+0MUW|n0LoJCEdrrUHqDJ%%4S`}b>0}I#v`IIig^W7rb*8w!j!Jaz>i#qw z`ls7aNo#$3HFS5^#*$N)W=`1~c0*1^3O2N!1p>I&;Xy{hj3H7p?m<@X>FE!Wm zwP@oud^UA8Z6Bv$3H$Q$+#V$tHy5-BGXKj9tkl1=K;eEC$bebE#LNL-Z{}=5jLnRV z&5o(7Yo=r+!{9r_hV!E72J?@e#M&iWSpVjUsbo0Wi=b;D?dNcQj}XOwN#qvbL{3K8 z9gt1`?W0E}!4>C?XsciIH;&GdeOtB5uPbF(T#%k5Sk0gKcQN% zgJh)f{ZA9u@(!YJOnM_3gC>4YW{6ImGLwaNZb<0W)K|GXpKi66^1~UcYJ#80J?4+W_?t$FJXQ1BY{88ymMT21|MJ z#xD-1&)~>ANI}`<7N%0Il6c^;jE;?=QxeId_PtiwUx?&A*r+?H#+#}Cu$1xI+gf2X z{+}Pw?CgW2+r`qlI`ll29k+SSA61q9z_(Z7Q$DfWwCh6J`LiYB;^(S@{Z6BrWs$W6 zcXN(9o;cndgVp6Sgp~{?mojm4k^XGXBtg<`)S9D1qmQ6|*YNGrFLE>C6e90-%C6zp zk0UUhUEXn}2E|OQN#`_Y`EY&+P+Z@5X6IG&JrMY+Re{iLPDu; zkVArE67rhohlUneec)W++1pxMH+p*!iVp2p*^?GuTJsQwo?t60#N}spAw;j?1UyET;4GgaazaS0VkUbl{u#*M(9t}d+<17n!7Mo#)u@P# zRk%bbLadYQ*-wm(y9yYFso5vnrQv*n-NE5&SHrne=iw_kP< zz{xnf5a4L-&_5)9iGhiYjV9r}_F}W$xaLuC5H~-+Lgj&3S(*J+00A)}>Vg1Avc8VK zy{WCEwfO?X<`Rc;;UD8rZhj2cK|JZvS?P3nGWb)?k zaBKx`HDyfrX$f|geqg`OP(IxHb4FQsaNM~!n`Xo78gaDs1Z)MVydMzgiqnVdLAYd5 z7A6)w5~$|S|L1Z^_)t(VHI``G>W9R%@s20;#30RF|JVE0w4XJcahlITNCJguhqbks zShMsw#jr)qBbD|?5?~WeOirAho`rb9=9@ee6!qsu`-0(fOnicjt`k=Z6_iG9!WqBT z#r?dmp6jTwx0{32@aP-^wnQf9U3#!bFy;JD^yL}ao66&6yutfah# zAR!`^LM<*Y?nfNri`Y{b-ckM1uGl>G62sfOYxrD|8N;6Z_EJkzQPFiHZ~`opWi{F> zF{n;LqKD&7f#e$7`kmPCrd)qk8gj+b!b?FVber^ICJ_OIfb&k-&t+PGDckMs+3)RL z=SC9{tr?34u!zta_Fugjvspt#s7OZ+#xh@Q=)8Pguwl7`V6n;ko|D6fy}#dPG{f_9 z?Zf5a;YYuOeceRg(wnOZsRgDv84bM}BGJxhdjK{ZcK3pTsjcPn^l&?hxC#KJUL|MV zDt$4>AWx$5cC80&Y&f*Q^@`7JMi9~pKnb!TnPR4 zO;}jyv_0LR>L4**4tu`EN3C(PIVov`lurh({9|&V29}Neg^J$lF&4(5|Chcbv^2e0 zY2D4ckL<*IxpuuJYx$Tuf_yb=BlsuC;c)UoA-w zz4%GL!v1--ni2SunJ@8{vF`$7ZoH!d{uvvan$Ai$WhDQjRL8aAn%L0x9pr9xzM?`| z@>6p|bn_pij)20A4KqARFf>>DGNAtJ|D{N`MDgQW0H1K{rDkfwo2~XQ9q{^kZAp1~ zFM=rL+{`yUS`lL3rB#$#AQ6Z^>~u8Y6)&lXh+d-h4fX+xmBU6_72pLui%RYP;fFev zko3ih>f#UPxhZr*+Gse!U6@u3xTMH@;Um;#SEZx3K?=I%FlEMxbXB@ANPHU$Qt^|} z+J1Qz5cV|G)uw*`#*+jI|Leg)h{`$6Q$Ws)we| z@BA$-8L7J@tcpft;2%R?CGrY4HNhX2@lxig4kX29N}`gk?3sW8wq$tpDD=!oHSos~ z8Y)dtLLxzx?tZwKwv2sZhlV~Q|mLy-y>UM0aj*_k{p94WioG263aqs zBVk`+kaQ;x$BrFe+;x7%M|ku2a4usbRt66hT0}rB&wd9s_4&PlG=vBB&*iUKYnx9% zXQ}iN74N3_z|P$rIF)W~WoLa?1=ahEt67c~-R7e>b!1Q!Bg3gcgwKTM?kxSC)EP7H z1`BhuSwM)6Rv*wHt za4cwKaNHBY>R}JlaKDsX&Yw@-OgmY`Qce?qoL%(=#Y`m;<$pFXh`Bu5&Hl6%E5-l- zNjH)eHZ2?BCYAPOYe!qHo~aWQD#jpyC^SQE&Qi!odE=J4i`GIyWVuq)f?@{FG{a}A zdB?AD$b6`H$1EhB`(wT$0T}kQ9r*0oygrZpt#uoMtg>n z>sv3KrA~B8tSNzub&@4J(!LGP+snr<1iW%@seokR6yP{K0;x4l#f`z{9T`y2Fak27 zAJohE48z%@R(3?YTR+5FiG9zweoZdKFU1uG$bGBsZSAb6Sku<_Fd*fR98SJ1 zr=EfC_tj(IP+wFPPqqVkeQh9J@jQ+-s-UboJvpXY*&`G2_)=GXTW*^ij(#fg{HYYJ zsjDI@@ccJ$_+1sCp|Mv&A4?MOtFL=-VBY0s?{QE}ef`wH89|P#QM>Qr!uZ@^Cu9<% zlD=o@Rb#TMkzR*Mo$c-x83_pqG^Nqo$J+-6EU62#bIK&ck#6El6dR+5`DNbm@VmRY zgM1>xP^^Q-^y&~9C{61TjcR)_$R|u}KRMZ%t7|-;@;l%`2VX_DFHFt$A8NXG6*((- zu7WHN!p7q=@Q9PD9fT=RcnS*ggJUShPzSpv_?)bC_ol<(&oo93)Ru=bgm=hs^Kx@x z@HAr1bfMU^^y#sAGZPyk0BU;dbxpv+UP^V+sj#!zJg3g9%4vf*!dk0l=T504+%C^Z ziHN*!u9iWRNabCAIeVM9E08YY$0kN!T$evN-{EpqR0X$c*;4S2zT?Ul)6QRDnNe;% z6tt(mFDLwuNA-)^kab_^zB!{?8ttQ}@u7nbwn1P%QhpgZvCbo3zdGX=uCH%Q&x#zO zSj23Ov7PGO{P`Js5tGE*dryd20Wdtk0q)S@uLOZS~kIn#$rd>nGlJXr7~uoxE}+4q7zGP5?#6S3+`MNILu1XH;%cIB1gGO4mrrdrOV(04Cbm*;WBdaIALbBiZ3VSSP<$A~-|{Gzc7QkHa1>j9Xfo z(?dM$)E1`%1STABSCa{CjYmf(GX!k!YTukbj$d&w8XS@bXVS&FJ+ue4$k1XeZrt@V ztv%WtPziaeP#KE(wSWIp3sV5K)3zxJa5c6VGURhT_<~?l*Q>s*G;TDg5dF;q01O2} zww)e-x3`z|?&OP8zXd;0@KSpWJo<4+FB1&$yt}=DWHGIcu?_1b=<)G99rJ7F1X&DB z*(%6@Ph+p)XRZ3lX>*vqloPv@PreWV0pUo+LwN|fW0x@ex$JOYayRCN~l}_C8 zRJc=`Isy~F6`B=LF73eVMkgb)v9`}GFCTBlV4JCbL!b?TU9|hVpB`bOMZ0*o^YZa+ zJTcNRl~QuolGS_V(=WDOuE!<-&G3+5-dmcwmL$(db#r=-;^EltzVD)I773t)u++w+ zBoBRkTSZq_Kl{Pe`MvpcHvh|&aCYo1#c+18cmH1NT|Ito2ax;4>1kDMb66ctHjU@w$HA_>GJ# z6`+)(R%ZZ}zK5hI)?f<9ABUeOt|{EDI!Zt!Jm%?)5ih_=69P~}BW>T!jXLlikXypN zXX&@-1lUfjv&1I$WwMZiwwY@-B&1N$qRC=CBosDY|8bgz3f|)Ko4CpA=A{PHN6A)J zl*ub7e`@C66&(A|AN{Ct_M5hjdE%B6>F(HmiqvfKrR`$u?+L?4%)Yz7m z0=DUJzKMb4t?Hd(ji@cDl}`MJ7S0D_U-&sZh=qTg3zKy`eDFP+%VT8%tRk1jd7MQr z1=5A|em0MRAb{;Xkrem0l(JRCc!j>UMvMyw@GL4dV>Bh`Eym+{^Z@lG@S%9XwRMex zj1LkSMHEe7*Wk24lmwTsK~Q7@0{5O0#%pH+K|m67F}+UZ4*l`g%u>9lyx76cZX|oW+uznpw zE$@{haWf1c-h2d37hXR*rZuOh&lLCH*dRgH{ zQbrG2Xz6HK6cjGD`3KX#bZmOS<&~YR_LsN?$0>sYUH-oQe_lK9d(1FIozj2 zC4crF+F99KzYKYR=>*U}(;k(JqYKco_7}*If*=&WxncQ?Jbpix-uY zy$C771#vEMR}fdyAGQts*dk{WfJRi;?&peGI+99rS`c2cFGK%n7U`Z`{shXA#)Cvb z2z+{G6!?`~HjXwnZ0sB?9KI*d*c)5Rl}ZvXobJw! ze{HHLR$~A@lzj2#`}Yy~R*bEaU|zt+;zMv+O-~(3x0&zxVBg!Cdp>wqrT*y22kD|pZYuvP;?SMmop!9Kq)?whPWMTTY6IH6Im z{fb^HE-n8t$~ApLgz~;*4KJ{d4IalW<94DIzBs=@;iDTF!3!6%mZLpb@-WGXoj@x!sDq7a5?-z0(L-

~0h_yZ* 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 +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Comment convertir un fichier HTML en PDF en Java – Guide complet + +Vous vous êtes déjà demandé **comment convertir un fichier HTML en PDF** sans vous battre avec des outils en ligne de commande ou des solutions bricolées ? Vous n'êtes pas le seul. Dans de nombreux projets centrés sur le web – pensez aux rapports automatisés, à la génération de factures ou à l'archivage de sites statiques – transformer une page HTML en un PDF net est un besoin quotidien. + +Bonne nouvelle ? Avec Aspose.HTML for Java, vous pouvez le faire en quelques lignes de code seulement. Ce tutoriel vous guide dans la création d’un PDF à partir de HTML en Java, couvrant tout, de la configuration du projet à la gestion des cas particuliers comme les ressources manquantes. + +## Prérequis et ce que vous allez créer + +Avant de plonger, assurez-vous d’avoir : + +- JDK 17 ou plus récent (la dernière version LTS fonctionne le mieux) +- Maven 3.8+ (ou Gradle si vous préférez) +- Une licence Aspose.HTML for Java (un essai gratuit suffit pour les tests) +- Un fichier `input.html` simple placé dans un répertoire local + +À la fin de ce guide, vous disposerez d’un programme Java exécutable qui **convertit un fichier HTML local en PDF**, prêt à être intégré à n’importe quel service backend. + +--- + +## Étape 1 : Configurer le projet Maven (Créer un PDF à partir de HTML en Java) + +Tout d'abord, créez un nouveau projet Maven. Si vous avez déjà un `pom.xml`, ajoutez simplement la dépendance Aspose.HTML : + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **Astuce :** Gardez votre `pom.xml` propre ; Maven récupérera automatiquement les dépendances transitives, vous n’avez donc pas besoin de chercher des JAR supplémentaires. + +## Étape 2 : Écrire le code de conversion (Comment convertir un fichier HTML en PDF) + +Créez une classe nommée `HtmlToPdfConverter`. Le cœur de la conversion se trouve dans un appel statique unique, mais nous l’enveloppons pour plus de clarté et de gestion des erreurs. + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### Pourquoi cela fonctionne + +- **`Converter.convert`** abstrait le parsing, la gestion du CSS et l’insertion d’images. Vous n’avez pas à gérer vous‑même un moteur de rendu. +- La méthode lève **`ConverterException`**, vous offrant un moyen propre de réagir aux fichiers manquants, au HTML mal formé ou aux problèmes de licence. +- En isolant la logique dans `convert`, vous pouvez la réutiliser dans des micro‑services, des jobs batch, ou même un simple outil CLI. + +## Étape 3 : Exécuter l’application (Créer un PDF à partir de HTML en Java) + +Compilez et exécutez le programme : + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +Si tout est correctement configuré, vous verrez : + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +Ouvrez `output.pdf` – vous devriez voir un rendu fidèle de `input.html`, incluant les styles CSS, les images, et même le contenu généré par JavaScript (tant qu’il est statique au moment de la conversion). + +## Étape 4 : Gestion des ressources locales (Convertir un fichier HTML local en PDF) + +Souvent, votre HTML référence des images, des polices ou des fichiers CSS via des chemins relatifs. Aspose.HTML résout ceux‑ci automatiquement **si** l’URI de base est correctement définie. Comme nous fournissons un chemin de fichier, la bibliothèque considère le répertoire de `input.html` comme base. + +Si vous devez convertir une chaîne HTML au lieu d’un fichier, spécifiez manuellement une URI de base : + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **Attention :** Oublier l’URI de base entraînera des images manquantes ou des styles cassés, un piège fréquent lors de la première utilisation de **convert html to pdf java**. + +## Étape 5 : Options avancées (Affiner la conversion HTML vers PDF en Java) + +Aspose.HTML vous permet d’ajuster la taille de la page, les marges, et même les métadonnées du PDF : + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +Ces réglages sont utiles lorsque vous devez **convert html file to pdf** pour l’impression ou la conformité (par ex., pages ISO‑216 A4). + +--- + +![Illustration de la conversion d'un fichier html en pdf](image.png){.center alt="Illustration de la conversion d'un fichier html en pdf"} + +*Le diagramme ci‑dessus visualise le flux : code Java → Aspose.HTML → sortie PDF.* + +## Questions fréquentes et cas particuliers + +- **Et si le HTML contient des polices web externes ?** + Aspose.HTML les téléchargera tant que la machine a accès à Internet. Pour des builds hors ligne, regroupez les polices localement et référencez‑les avec un chemin relatif. + +- **Puis‑je convertir plusieurs fichiers HTML en lot ?** + Absolument. Enveloppez l’appel `convert` dans une boucle, en lisant éventuellement les noms de fichiers depuis un répertoire. Pensez à gérer les exceptions par fichier afin qu’un mauvais fichier n’interrompe pas tout le lot. + +- **La bibliothèque prend‑elle en charge Java 11+ ?** + Oui, la version 23.12 cible Java 8 et supérieur, vous êtes donc à l’abri sur les runtimes modernes. + +- **Problèmes de licence ?** + Si vous utilisez l’essai pendant plus de 30 jours, le PDF de sortie contiendra un filigrane. Appliquez votre fichier de licence tôt dans `main` : + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## Conclusion + +Vous disposez maintenant d’une solution solide, prête pour la production, pour **comment convertir un fichier HTML en PDF** en utilisant Aspose.HTML en Java. De la configuration du projet Maven à la gestion des ressources locales en passant par le réglage des options de page, le guide a couvert tout ce dont vous avez besoin pour **créer un PDF à partir de HTML en Java** et **convertir un fichier HTML local en PDF** sans outils en ligne de commande tiers. + +Et ensuite ? Essayez d’ajouter des en‑têtes/pieds de page, de chiffrer le PDF, ou d’intégrer ce convertisseur dans un endpoint REST Spring Boot afin que les clients puissent télécharger du HTML et recevoir un PDF instantanément. Les possibilités sont infinies, et le modèle de base reste le même. + +Des questions ou envie de partager une astuce ? Laissez un commentaire ci‑dessous – bon codage ! + +## Que devriez‑vous apprendre ensuite ? + +Les tutoriels suivants couvrent des sujets étroitement liés qui s’appuient sur les techniques démontrées dans ce guide. Chaque ressource inclut des exemples de code complets et fonctionnels avec des explications étape par étape pour vous aider à maîtriser des fonctionnalités supplémentaires de l’API et explorer des approches d’implémentation alternatives dans vos propres projets. + +- [Convertir HTML en PDF Java – Configurer l’environnement dans Aspose.HTML](/html/english/java/configuring-environment/) +- [Créer un PDF à partir de HTML – Définir la feuille de style utilisateur dans Aspose.HTML pour Java](/html/english/java/configuring-environment/set-user-style-sheet/) +- [Définir la taille de page PDF - Convertir HTML en PDF en Java](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/german/java/conversion-html-to-other-formats/_index.md b/html/german/java/conversion-html-to-other-formats/_index.md index 5645e79f7f..1e5c5ce95e 100644 --- a/html/german/java/conversion-html-to-other-formats/_index.md +++ b/html/german/java/conversion-html-to-other-formats/_index.md @@ -102,11 +102,14 @@ Konvertieren Sie Markdown in Java nahtlos zu HTML mit Aspose.HTML für Java. Fol Erfahren Sie, wie Sie SVG in Java mit Aspose.HTML zu Bildern konvertieren. Umfassende Anleitung für hochwertige Ausgaben. ### [Konvertierung von SVG zu PDF](./convert-svg-to-pdf/) -Konvertieren Sie SVG in Java mit Aspose.HTML zu PDF. Eine nahtlose Lösung für hochwertige Dokumentenkonvertierung. +Konvertieren Sie SVG in Java mit Aspose.HTML zu PDF. Eine nahtlose Lösung für hochwertige Dokumentkonvertierung. ### [Konvertierung von SVG zu XPS](./convert-svg-to-xps/) Erfahren Sie, wie Sie SVG mit Aspose.HTML für Java zu XPS konvertieren. Einfache, Schritt‑für‑Schritt‑Anleitung für reibungslose Konvertierungen. +### [Wie man HTML-Datei in PDF in Java konvertiert – Komplettanleitung](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) +Erfahren Sie, wie Sie mit Aspose.HTML für Java eine HTML‑Datei vollständig in ein PDF‑Dokument umwandeln – Schritt für Schritt. + ## Häufig gestellte Fragen **Q: Kann ich Aspose.HTML für Java in einer kommerziellen Anwendung verwenden?** diff --git a/html/german/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/german/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..0e82e75f1a --- /dev/null +++ b/html/german/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,252 @@ +--- +category: general +date: 2026-07-21 +description: Wie man eine HTML‑Datei mit Aspose.HTML in Java in PDF konvertiert. Lernen + Sie Schritt für Schritt, wie man in Java aus HTML ein PDF erstellt und lokale Dateien + verarbeitet. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: de +lastmod: 2026-07-21 +og_description: Wie man eine HTML‑Datei mit Aspose.HTML in Java in PDF konvertiert. + Folgen Sie dieser Anleitung, um in Java PDFs aus HTML zu erstellen und lokale Dateien + mühelos zu verarbeiten. +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: Wie man eine HTML‑Datei in Java in PDF konvertiert – schnelle, zuverlässige + Methode +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: Wie man HTML-Datei in PDF in Java konvertiert – Komplettanleitung +url: /de/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# So konvertieren Sie HTML-Dateien in PDF mit Java – Komplettanleitung + +Haben Sie sich jemals gefragt, **wie man HTML-Dateien in PDF** konvertiert, ohne sich mit Kommandozeilen‑Tools oder umständlichen Workarounds herumzuschlagen? Sie sind nicht allein. In vielen web‑zentrierten Projekten – denken Sie an automatisierte Berichte, Rechnungserstellung oder das Archivieren statischer Websites – ist das Umwandeln einer HTML‑Seite in ein scharfes PDF ein täglicher Bedarf. + +Die gute Nachricht? Mit Aspose.HTML for Java können Sie das in nur wenigen Code‑Zeilen erledigen. Dieses Tutorial führt Sie Schritt für Schritt durch die Erstellung von PDF aus HTML in Java und deckt alles ab, von der Projekt‑Einrichtung bis zum Umgang mit Randfällen wie fehlenden Ressourcen. + +## Voraussetzungen & Was Sie erstellen werden + +Bevor wir starten, stellen Sie sicher, dass Sie folgendes haben: + +- JDK 17 oder neuer (die neueste LTS‑Version funktioniert am besten) +- Maven 3.8+ (oder Gradle, falls Sie das bevorzugen) +- Eine Aspose.HTML for Java Lizenz (eine kostenlose Testversion reicht für Tests) +- Eine einfache `input.html`‑Datei, die in einem lokalen Verzeichnis liegt + +Am Ende dieses Leitfadens besitzen Sie ein lauffähiges Java‑Programm, das **eine lokale HTML‑Datei in PDF** konvertiert und bereit ist, in jeden Backend‑Service eingebunden zu werden. + +--- + +## Schritt 1: Maven‑Projekt einrichten (PDF aus HTML in Java erstellen) + +Zuerst erstellen Sie ein frisches Maven‑Projekt. Wenn Sie bereits eine `pom.xml` haben, fügen Sie einfach die Aspose.HTML‑Abhängigkeit hinzu: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **Profi‑Tipp:** Halten Sie Ihre `pom.xml` übersichtlich; Maven zieht die transitiven Abhängigkeiten automatisch, sodass Sie nicht nach zusätzlichen JARs suchen müssen. + +## Schritt 2: Konvertierungscode schreiben (Wie man HTML‑Datei in PDF konvertiert) + +Erstellen Sie eine Klasse namens `HtmlToPdfConverter`. Der Kern der Konvertierung steckt in einem einzigen statischen Aufruf, aber wir verpacken ihn für Klarheit und Fehlerbehandlung. + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### Warum das funktioniert + +- **`Converter.convert`** übernimmt das Parsen, die CSS‑Verarbeitung und das Einbetten von Bildern. Sie müssen keine eigene Rendering‑Engine verwalten. +- Die Methode wirft **`ConverterException`**, was Ihnen eine saubere Möglichkeit gibt, auf fehlende Dateien, fehlerhaftes HTML oder Lizenzprobleme zu reagieren. +- Durch das Isolieren der Logik in `convert` können Sie sie in Micro‑Services, Batch‑Jobs oder sogar einem einfachen CLI‑Tool wiederverwenden. + +## Schritt 3: Anwendung ausführen (PDF aus HTML in Java erstellen) + +Kompilieren und führen Sie das Programm aus: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +Wenn alles korrekt eingerichtet ist, sehen Sie: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +Öffnen Sie `output.pdf` – Sie sollten eine getreue Darstellung von `input.html` sehen, inklusive CSS‑Stilen, Bildern und sogar JavaScript‑generiertem Inhalt (solange er zum Zeitpunkt der Konvertierung statisch ist). + +## Schritt 4: Lokale Ressourcen behandeln (Lokale HTML‑Datei in PDF konvertieren) + +Oft referenziert Ihr HTML Bilder, Schriftarten oder CSS‑Dateien über relative Pfade. Aspose.HTML löst diese automatisch **auf**, **wenn** die Basis‑URI korrekt gesetzt ist. Da wir einen Dateipfad übergeben, behandelt die Bibliothek das Verzeichnis von `input.html` als Basis. + +Wenn Sie stattdessen einen HTML‑String konvertieren möchten, geben Sie eine Basis‑URI manuell an: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **Achtung:** Wenn Sie die Basis‑URI vergessen, führt das zu fehlenden Bildern oder kaputten Styles – ein häufiger Stolperstein beim **convert html to pdf java** beim ersten Mal. + +## Schritt 5: Erweiterte Optionen (Feinabstimmung Convert HTML to PDF Java) + +Aspose.HTML lässt Sie Seitengröße, Ränder und sogar PDF‑Metadaten anpassen: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +Diese Einstellungen sind praktisch, wenn Sie **convert html file to pdf** für den Druck oder zur Einhaltung von Vorgaben (z. B. ISO‑216 A4‑Seiten) benötigen. + +--- + +![Wie man HTML‑Datei in PDF konvertiert Illustration](image.png){.center alt="Wie man HTML‑Datei in PDF konvertiert Illustration"} + +*Das obige Diagramm visualisiert den Ablauf: Java‑Code → Aspose.HTML → PDF‑Ausgabe.* + +## Häufige Fragen & Randfälle + +- **Was passiert, wenn das HTML externe Web‑Fonts enthält?** + Aspose.HTML lädt sie herunter, solange die Maschine Internetzugang hat. Für Offline‑Builds bündeln Sie die Fonts lokal und referenzieren sie mit einem relativen Pfad. + +- **Kann ich mehrere HTML‑Dateien stapelweise konvertieren?** + Absolut. Verpacken Sie den `convert`‑Aufruf in einer Schleife, zum Beispiel indem Sie Dateinamen aus einem Verzeichnis lesen. Denken Sie daran, Ausnahmen pro Datei zu behandeln, damit ein fehlerhaftes Eingabedokument nicht den gesamten Batch abbricht. + +- **Unterstützt die Bibliothek Java 11+?** + Ja, das aktuelle Release 23.12 zielt auf Java 8 und höher ab, sodass Sie auf modernen Laufzeiten sicher sind. + +- **Lizenzprobleme?** + Wenn Sie die Testversion länger als 30 Tage nutzen, enthält das ausgegebene PDF ein Wasserzeichen. Laden Sie Ihre Lizenzdatei früh im `main`‑Methoden‑Block: + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## Fazit + +Sie haben nun eine solide, produktionsreife Lösung für **wie man HTML‑Dateien in PDF** mit Aspose.HTML in Java konvertiert. Von der Einrichtung des Maven‑Projekts über den Umgang mit lokalen Ressourcen bis hin zur Feinabstimmung von Seiteneinstellungen deckte der Leitfaden alles ab, was Sie benötigen, um **PDF aus HTML in Java** zu erstellen und **lokale HTML‑Datei in PDF** zu konvertieren – ganz ohne Drittanbieter‑Kommandozeilen‑Tools. + +Was kommt als Nächstes? Versuchen Sie, Header/Footer hinzuzufügen, das PDF zu verschlüsseln oder diesen Konverter in einen Spring‑Boot‑REST‑Endpoint zu integrieren, sodass Clients HTML hochladen und sofort ein PDF erhalten können. Die Möglichkeiten sind endlos, und das Kernmuster bleibt gleich. + +Haben Sie Fragen oder möchten Sie einen cleveren Trick teilen? Hinterlassen Sie unten einen Kommentar – happy coding! + +## Was sollten Sie als Nächstes lernen? + +Die folgenden Tutorials behandeln eng verwandte Themen, die auf den in diesem Leitfaden gezeigten Techniken aufbauen. Jede Ressource enthält vollständige, funktionierende Code‑Beispiele mit Schritt‑für‑Schritt‑Erklärungen, um Ihnen zu helfen, weitere API‑Funktionen zu meistern und alternative Implementierungsansätze in Ihren eigenen Projekten zu erkunden. + +- [HTML zu PDF Java – Umgebung konfigurieren in Aspose.HTML](/html/english/java/configuring-environment/) +- [PDF aus HTML erstellen – Benutzer‑Stylesheet setzen in Aspose.HTML für Java](/html/english/java/configuring-environment/set-user-style-sheet/) +- [PDF‑Seitengröße festlegen – HTML zu PDF in Java](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/greek/java/conversion-html-to-other-formats/_index.md b/html/greek/java/conversion-html-to-other-formats/_index.md index f8b92d079f..584fce3a11 100644 --- a/html/greek/java/conversion-html-to-other-formats/_index.md +++ b/html/greek/java/conversion-html-to-other-formats/_index.md @@ -85,6 +85,8 @@ weight: 25 ## Μετατροπή - HTML σε Άλλες Μορφές Μαθήματα ### [Μετατροπή HTML σε PDF](./convert-html-to-pdf/) Μάθετε πώς να μετατρέψετε HTML σε PDF σε Java χρησιμοποιώντας το Aspose.HTML. Δημιουργήστε PDF υψηλής ποιότητας από το περιεχόμενο HTML σας χωρίς κόπο. +### [Πώς να Μετατρέψετε Αρχείο HTML σε PDF σε Java – Πλήρης Οδηγός](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) +Μάθετε βήμα‑βήμα πώς να μετατρέψετε ένα αρχείο HTML σε PDF χρησιμοποιώντας το Aspose.HTML for Java, με παραδείγματα κώδικα και βέλτιστες πρακτικές. ### [Μετατροπή HTML σε PDF σε Java – Οδηγός βήμα‑βήμα με ρυθμίσεις μεγέθους σελίδας](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) Ακολουθήστε τον πλήρη οδηγό για μετατροπή HTML σε PDF σε Java, με παραμετροποίηση μεγέθους σελίδας για ακριβή έγγραφα. ### [Μετατροπή HTML σε MHTML](./convert-html-to-mhtml/) diff --git a/html/greek/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/greek/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..bcb8a1b42c --- /dev/null +++ b/html/greek/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-07-21 +description: Πώς να μετατρέψετε αρχείο HTML σε PDF χρησιμοποιώντας το Aspose.HTML + σε Java. Μάθετε βήμα‑βήμα πώς να δημιουργήσετε PDF από HTML σε Java και να διαχειριστείτε + τοπικά αρχεία. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: el +lastmod: 2026-07-21 +og_description: Πώς να μετατρέψετε ένα αρχείο HTML σε PDF με το Aspose.HTML στη Java. + Ακολουθήστε αυτόν τον οδηγό για να δημιουργήσετε PDF από HTML στη Java, διαχειριζόμενοι + τοπικά αρχεία άψογα. +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: Πώς να μετατρέψετε ένα αρχείο HTML σε PDF με τη Java – Γρήγορη, αξιόπιστη + μέθοδος +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: Πώς να μετατρέψετε αρχείο HTML σε PDF στη Java – Πλήρης οδηγός +url: /el/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Πώς να Μετατρέψετε Αρχείο HTML σε PDF με Java – Πλήρης Οδηγός + +Έχετε αναρωτηθεί ποτέ **πώς να μετατρέψετε αρχείο HTML σε PDF** χωρίς να παλεύετε με εργαλεία γραμμής εντολών ή ακατάστατες λύσεις; Δεν είστε μόνοι. Σε πολλά web‑κεντρικά έργα – σκεφτείτε αυτοματοποιημένες αναφορές, δημιουργία τιμολογίων ή αρχειοθέτηση στατικών ιστοσελίδων – η μετατροπή μιας σελίδας HTML σε καθαρό PDF είναι καθημερινή ανάγκη. + +Τα καλά νέα; Με το Aspose.HTML for Java μπορείτε να το κάνετε με λίγες μόνο γραμμές κώδικα. Αυτό το tutorial σας οδηγεί στη δημιουργία PDF από HTML με Java, καλύπτοντας τα πάντα από τη ρύθμιση του έργου μέχρι τη διαχείριση ειδικών περιπτώσεων όπως ελλιπείς πόροι. + +## Προαπαιτούμενα & Τι Θα Δημιουργήσετε + +Πριν ξεκινήσουμε, βεβαιωθείτε ότι έχετε: + +- JDK 17 ή νεότερο (η τελευταία έκδοση LTS λειτουργεί καλύτερα) +- Maven 3.8+ (ή Gradle αν προτιμάτε) +- Άδεια Aspose.HTML for Java (μια δωρεάν δοκιμή λειτουργεί για δοκιμές) +- Ένα απλό αρχείο `input.html` σε τοπικό φάκελο + +Στο τέλος αυτού του οδηγού θα έχετε ένα εκτελέσιμο πρόγραμμα Java που **μετατρέπει ένα τοπικό αρχείο HTML σε PDF**, έτοιμο να ενσωματωθεί σε οποιαδήποτε υπηρεσία backend. + +--- + +## Βήμα 1: Ρύθμιση του Έργου Maven (Δημιουργία PDF από HTML με Java) + +Πρώτα, δημιουργήστε ένα νέο έργο Maven. Αν έχετε ήδη ένα `pom.xml`, απλώς προσθέστε την εξάρτηση Aspose.HTML: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **Συμβουλή:** Κρατήστε το `pom.xml` σας καθαρό· το Maven θα κατεβάσει αυτόματα τις μεταβατικές εξαρτήσεις, έτσι δεν χρειάζεται να ψάχνετε για επιπλέον JARs. + +## Βήμα 2: Γράψτε τον Κώδικα Μετατροπής (Πώς να Μετατρέψετε Αρχείο HTML σε PDF) + +Δημιουργήστε μια κλάση με όνομα `HtmlToPdfConverter`. Ο πυρήνας της μετατροπής βρίσκεται σε μία στατική κλήση, αλλά θα το τυλίξουμε για σαφήνεια και διαχείριση σφαλμάτων. + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### Γιατί Λειτουργεί Αυτό + +- **`Converter.convert`** αφαιρεί την ανάγκη για χειρισμό parsing, CSS και ενσωμάτωσης εικόνων. Δεν χρειάζεται να διαχειριστείτε εσείς μια μηχανή απόδοσης. +- Η μέθοδος ρίχνει **`ConverterException`**, παρέχοντάς σας έναν καθαρό τρόπο να αντιδράσετε σε ελλιπή αρχεία, κακοδιατυπωμένο HTML ή ζητήματα άδειας. +- Με την απομόνωση της λογικής στο `convert`, μπορείτε να το επαναχρησιμοποιήσετε σε μικρο‑υπηρεσίες, εργασίες batch ή ακόμη και ένα απλό εργαλείο CLI. + +## Βήμα 3: Εκτελέστε την Εφαρμογή (Δημιουργία PDF από HTML με Java) + +Συγκεντρώστε και εκτελέστε το πρόγραμμα: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +Αν όλα έχουν ρυθμιστεί σωστά, θα δείτε: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +Ανοίξτε το `output.pdf` – θα πρέπει να δείτε μια ακριβή απόδοση του `input.html`, συμπεριλαμβανομένων των στυλ CSS, των εικόνων και ακόμη του περιεχομένου που δημιουργείται από JavaScript (εφόσον είναι στατικό τη στιγμή της μετατροπής). + +## Βήμα 4: Διαχείριση Τοπικών Πόρων (Μετατροπή Τοπικού Αρχείου HTML σε PDF) + +Συχνά το HTML σας αναφέρει εικόνες, γραμματοσειρές ή αρχεία CSS μέσω σχετικών διαδρομών. Το Aspose.HTML τα επιλύει αυτόματα **αν** το base URI έχει οριστεί σωστά. Εφόσον παρέχουμε μια διαδρομή αρχείου, η βιβλιοθήκη θεωρεί τον φάκελο του `input.html` ως βάση. + +Αν χρειάζεστε να μετατρέψετε μια συμβολοσειρά HTML αντί για αρχείο, ορίστε το base URI χειροκίνητα: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **Προσοχή:** Η παράλειψη του base URI θα προκαλέσει ελλιπείς εικόνες ή σπασμένα στυλ, ένα κοινό λάθος όταν **convert html to pdf java** για πρώτη φορά. + +## Βήμα 5: Προχωρημένες Επιλογές (Λεπτομερής Ρύθμιση Convert HTML to PDF Java) + +Το Aspose.HTML σας επιτρέπει να ρυθμίσετε το μέγεθος σελίδας, τα περιθώρια και ακόμη τα μεταδεδομένα PDF: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +Αυτές οι ρυθμίσεις είναι χρήσιμες όταν χρειάζεται **convert html file to pdf** για εκτύπωση ή συμμόρφωση (π.χ., σελίδες ISO‑216 A4). + +![Πώς να μετατρέψετε αρχείο html σε pdf εικονογράφηση](image.png){.center alt="Πώς να μετατρέψετε αρχείο html σε pdf εικονογράφηση"} + +*Το παραπάνω διάγραμμα οπτικοποιεί τη ροή: κώδικας Java → Aspose.HTML → έξοδος PDF.* + +## Συχνές Ερωτήσεις & Ειδικές Περιπτώσεις + +- **Τι γίνεται αν το HTML περιέχει εξωτερικές web γραμματοσειρές;** + Το Aspose.HTML θα τις κατεβάσει εφόσον η μηχανή έχει πρόσβαση στο internet. Για offline builds, ενσωματώστε τις γραμματοσειρές τοπικά και αναφερθείτε σε αυτές με σχετική διαδρομή. + +- **Μπορώ να μετατρέψω πολλά αρχεία HTML σε batch;** + Απόλυτα. Τυλίξτε την κλήση `convert` μέσα σε βρόχο, ίσως διαβάζοντας τα ονόματα αρχείων από έναν φάκελο. Θυμηθείτε να διαχειρίζεστε εξαιρέσεις ανά αρχείο ώστε ένα κακό αρχείο να μην διακόψει ολόκληρο το batch. + +- **Υποστηρίζει η βιβλιοθήκη Java 11+;** + Ναι, η τρέχουσα έκδοση 23.12 στοχεύει σε Java 8 και άνω, οπότε είστε ασφαλείς σε σύγχρονες εκτελέσεις. + +- **Προβλήματα άδειας;** + Αν τρέξετε τη δοκιμαστική έκδοση περισσότερο από 30 ημέρες, το παραγόμενο PDF θα περιέχει υδατογράφημα. Εφαρμόστε το αρχείο άδειας νωρίς στο `main`: + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +## Συμπέρασμα + +Τώρα έχετε μια σταθερή, έτοιμη για παραγωγή λύση για **πώς να μετατρέψετε αρχείο HTML σε PDF** χρησιμοποιώντας το Aspose.HTML σε Java. Από τη ρύθμιση του έργου Maven μέχρι τη διαχείριση τοπικών πόρων και τη ρύθμιση επιλογών σελίδας, ο οδηγός κάλυψε όλα όσα χρειάζεστε για **δημιουργία PDF από HTML σε Java** και **μετατροπή τοπικού αρχείου HTML σε PDF** χωρίς εργαλεία γραμμής εντολών τρίτων. + +Τι ακολουθεί; Δοκιμάστε να προσθέσετε κεφαλίδες/υποσέλιδα, να κρυπτογραφήσετε το PDF, ή να ενσωματώσετε αυτόν τον μετατροπέα σε ένα Spring Boot REST endpoint ώστε οι πελάτες να μπορούν να ανεβάζουν HTML και να λαμβάνουν PDF άμεσα. Οι δυνατότητες είναι ατελείωτες, και το βασικό μοτίβο παραμένει το ίδιο. + +Έχετε ερωτήσεις ή θέλετε να μοιραστείτε μια έξυπνη βελτίωση; Αφήστε ένα σχόλιο παρακάτω – καλή κωδικοποίηση! + +## Τι Θα Πρέπει Να Μάθετε Στη Σειρά; + +Τα παρακάτω tutorials καλύπτουν στενά συναφή θέματα που βασίζονται στις τεχνικές που παρουσιάστηκαν σε αυτόν τον οδηγό. Κάθε πόρος περιλαμβάνει πλήρη παραδείγματα κώδικα με βήμα‑βήμα εξηγήσεις για να σας βοηθήσει να κυριαρχήσετε σε πρόσθετα χαρακτηριστικά του API και να εξερευνήσετε εναλλακτικές προσεγγίσεις υλοποίησης στα δικά σας έργα. + +- [Μετατροπή HTML σε PDF Java – Ρύθμιση Περιβάλλοντος στο Aspose.HTML](/html/english/java/configuring-environment/) +- [Δημιουργία PDF από HTML – Ορισμός Φύλλου Στυλ Χρήστη στο Aspose.HTML για Java](/html/english/java/configuring-environment/set-user-style-sheet/) +- [Ορισμός Μεγέθους Σελίδας PDF - Μετατροπή HTML σε PDF σε Java](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/hindi/java/conversion-html-to-other-formats/_index.md b/html/hindi/java/conversion-html-to-other-formats/_index.md index 1c90698de4..61f29b2583 100644 --- a/html/hindi/java/conversion-html-to-other-formats/_index.md +++ b/html/hindi/java/conversion-html-to-other-formats/_index.md @@ -83,28 +83,14 @@ SVG ग्राफ़िक्स को XPS फ़ॉर्मेट में ## रूपांतरण - HTML से अन्य फ़ॉर्मेट ट्यूटोरियल ### [HTML को PDF में बदलना](./convert-html-to-pdf/) -Java में Aspose.HTML का उपयोग करके HTML को PDF में कैसे बदलें सीखें। अपने HTML कंटेंट से आसानी से उच्च‑गुणवत्ता वाले PDF बनाएं। - +### [जावा में HTML फ़ाइल को PDF में बदलने का पूर्ण गाइड](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) ### [HTML को MHTML में बदलना](./convert-html-to-mhtml/) -Aspose.HTML for Java का उपयोग करके HTML को MHTML में आसानी से बदलें। कुशल HTML‑to‑MHTML रूपांतरण के लिए हमारे चरण‑दर‑चरण गाइड का पालन करें। - ### [HTML को XPS में बदलना](./convert-html-to-xps/) -Aspose.HTML for Java का उपयोग करके HTML को XPS में आसानी से कैसे बदलें सीखें। आसानी से क्रॉस‑प्लेटफ़ॉर्म दस्तावेज़ बनाएं। - ### [Markdown को HTML में बदलना](./convert-markdown-to-html/) -Aspose.HTML for Java के साथ Java में Markdown को HTML में सहजता से बदलें। अपने दस्तावेज़ रूपांतरण आवश्यकताओं को सुव्यवस्थित करने के लिए हमारे चरण‑दर‑चरण गाइड का पालन करें। - ### [SVG को इमेज में बदलना](./convert-svg-to-image/) -Aspose.HTML के साथ Java में SVG को इमेज में कैसे बदलें सीखें। उच्च‑गुणवत्ता आउटपुट के लिए व्यापक गाइड। - ### [SVG को PDF में बदलना](./convert-svg-to-pdf/) -Aspose.HTML के साथ Java में SVG को PDF में बदलें। उच्च‑गुणवत्ता दस्तावेज़ रूपांतरण के लिए एक सहज समाधान। - ### [SVG को XPS में बदलना](./convert-svg-to-xps/) -Aspose.HTML for Java के साथ SVG को XPS में कैसे बदलें सीखें। सहज रूपांतरण के लिए सरल, चरण‑दर‑चरण गाइड। - ### [Java में HTML को PDF में बदलें – पेज आकार सेटिंग्स के साथ चरण‑दर‑चरण गाइड](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) -Aspose.HTML for Java के साथ पेज आकार सेटिंग्स को नियंत्रित करते हुए HTML को PDF में बदलने का विस्तृत गाइड। ## अक्सर पूछे जाने वाले प्रश्न diff --git a/html/hindi/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/hindi/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..53dcc68ff3 --- /dev/null +++ b/html/hindi/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,243 @@ +--- +category: general +date: 2026-07-21 +description: Java में Aspose.HTML का उपयोग करके HTML फ़ाइल को PDF में कैसे बदलें। + Java में HTML से PDF बनाने और स्थानीय फ़ाइलों को संभालने के लिए चरण‑दर‑चरण सीखें। +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: hi +lastmod: 2026-07-21 +og_description: Aspose.HTML के साथ जावा में HTML फ़ाइल को PDF में कैसे बदलें। इस गाइड + का पालन करके जावा में HTML से PDF बनाएं, स्थानीय फ़ाइलों को आसानी से संभालें। +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: जावा में HTML फ़ाइल को PDF में कैसे बदलें – तेज़, भरोसेमंद तरीका +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: जावा में HTML फ़ाइल को PDF में कैसे बदलें – पूर्ण गाइड +url: /hi/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Java में HTML फ़ाइल को PDF में बदलने का तरीका – पूर्ण गाइड + +क्या आपने कभी **how to convert HTML file to PDF** को कमांड‑लाइन टूल्स या गड़बड़ वर्कअराउंड्स के बिना करने के बारे में सोचा है? आप अकेले नहीं हैं। कई वेब‑केंद्रित प्रोजेक्ट्स में – जैसे स्वचालित रिपोर्टिंग, इनवॉइस जेनरेशन, या स्थैतिक साइट आर्काइविंग – एक HTML पेज को साफ़ PDF में बदलना रोज़ की आवश्यकता है। + +अच्छी खबर? Aspose.HTML for Java के साथ आप इसे कुछ ही कोड लाइनों में कर सकते हैं। यह ट्यूटोरियल आपको Java में HTML से PDF बनाने की प्रक्रिया दिखाता है, प्रोजेक्ट सेटअप से लेकर मिसिंग रिसोर्सेज जैसी एज केस को संभालने तक सब कुछ कवर करता है। + +## आवश्यकताएँ और आप क्या बनाएँगे + +- JDK 17 या नया (नवीनतम LTS संस्करण सबसे अच्छा काम करता है) +- Maven 3.8+ (या Gradle यदि आप पसंद करते हैं) +- Aspose.HTML for Java लाइसेंस (टेस्टिंग के लिए एक फ्री ट्रायल काम करता है) +- एक साधारण `input.html` फ़ाइल जो स्थानीय डायरेक्टरी में स्थित है + +इस गाइड के अंत तक आपके पास एक रनएबल Java प्रोग्राम होगा जो **converts a local HTML file to PDF** करता है, जिसे किसी भी बैकएंड सर्विस में डाला जा सकता है। + +--- + +## Step 1: Set Up the Maven Project (Create PDF from HTML in Java) + +पहले, एक नया Maven प्रोजेक्ट बनाएं। यदि आपके पास पहले से ही एक `pom.xml` है, तो बस Aspose.HTML डिपेंडेंसी जोड़ें: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **Pro tip:** अपने `pom.xml` को साफ़ रखें; Maven स्वचालित रूप से ट्रांज़िटिव डिपेंडेंसीज़ खींच लेगा, इसलिए आपको अतिरिक्त JARs खोजने की ज़रूरत नहीं है। + +## Step 2: Write the Conversion Code (How to Convert HTML File to PDF) + +`HtmlToPdfConverter` नाम की एक क्लास बनाएं। रूपांतरण का कोर एक सिंगल स्टैटिक कॉल में रहता है, लेकिन हम इसे स्पष्टता और एरर हैंडलिंग के लिए रैप करेंगे। + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### यह क्यों काम करता है + +- **`Converter.convert`** पार्सिंग, CSS हैंडलिंग और इमेज एम्बेडिंग को एब्स्ट्रैक्ट करता है। आपको खुद रेंडरिंग इंजन मैनेज करने की ज़रूरत नहीं। +- यह मेथड **`ConverterException`** थ्रो करता है, जिससे आप मिसिंग फ़ाइलें, गलत HTML, या लाइसेंसिंग इश्यूज़ को साफ़ तरीके से हैंडल कर सकते हैं। +- `convert` में लॉजिक को अलग करके, आप इसे माइक्रो‑सर्विसेज, बैच जॉब्स, या यहाँ तक कि एक साधारण CLI टूल में भी रीउज़ कर सकते हैं। + +## Step 3: Run the Application (Create PDF from HTML in Java) + +Compile and execute the program: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +यदि सब कुछ सही ढंग से सेट है, तो आप देखेंगे: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +`output.pdf` खोलें – आपको `input.html` का सटीक रेंडरिंग दिखना चाहिए, जिसमें CSS स्टाइल्स, इमेजेज, और यहाँ तक कि JavaScript‑जनित कंटेंट (जब तक वह कन्वर्ज़न समय पर स्थैतिक हो) शामिल हैं। + +## Step 4: Handling Local Resources (Convert Local HTML File to PDF) + +अक्सर आपका HTML इमेजेज, फ़ॉन्ट्स, या CSS फ़ाइलों को रिलेटिव पाथ्स से रेफ़र करता है। Aspose.HTML उन्हें स्वचालित रूप से **यदि** बेस URI सही सेट हो तो रिजॉल्व करता है। चूँकि हम फ़ाइल पाथ दे रहे हैं, लाइब्रेरी `input.html` की डायरेक्टरी को बेस मानती है। + +यदि आपको फ़ाइल की बजाय HTML स्ट्रिंग को कन्वर्ट करना है, तो बेस URI को मैन्युअली स्पेसिफ़ाई करें: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **Watch out:** बेस URI भूलने से इमेजेज मिसिंग या स्टाइल्स टूट सकते हैं, जो पहली बार **convert html to pdf java** करते समय आम समस्या है। + +## Step 5: Advanced Options (Fine‑tuning Convert HTML to PDF Java) + +Aspose.HTML आपको पेज साइज, मार्जिन, और यहाँ तक कि PDF मेटाडेटा को ट्यून करने देता है: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +ये सेटिंग्स तब उपयोगी होती हैं जब आपको **convert html file to pdf** प्रिंटिंग या कंप्लायंस (जैसे, ISO‑216 A4 पेज) के लिए चाहिए। + +![HTML फ़ाइल को PDF में बदलने का चित्रण](image.png){.center alt="HTML फ़ाइल को PDF में बदलने का चित्रण"} + +*उपरोक्त डायग्राम फ्लो को विज़ुअलाइज़ करता है: Java कोड → Aspose.HTML → PDF आउटपुट.* + +## सामान्य प्रश्न और एज केस + +- **यदि HTML में एक्सटर्नल वेब फ़ॉन्ट्स हैं तो?** + Aspose.HTML उन्हें डाउनलोड करेगा जब तक मशीन के पास इंटरनेट एक्सेस हो। ऑफ़लाइन बिल्ड्स के लिए, फ़ॉन्ट्स को लोकली बंडल करें और रिलेटिव पाथ से रेफ़र करें। + +- **क्या मैं बैच में कई HTML फ़ाइलें कन्वर्ट कर सकता हूँ?** + बिल्कुल। `convert` कॉल को लूप में रैप करें, संभवतः डायरेक्टरी से फ़ाइल नाम पढ़ते हुए। प्रत्येक फ़ाइल के लिए एक्सेप्शन हैंडल करना याद रखें ताकि एक खराब इनपुट पूरी बैच को रोक न सके। + +- **क्या लाइब्रेरी Java 11+ को सपोर्ट करती है?** + हाँ, वर्तमान 23.12 रिलीज़ Java 8 और उससे ऊपर को टार्गेट करती है, इसलिए आप आधुनिक रनटाइम्स पर सुरक्षित हैं। + +- **लाइसेंस संबंधी समस्याएँ?** + यदि आप ट्रायल को 30 दिन से अधिक चलाते हैं, तो आउटपुट PDF में वॉटरमार्क रहेगा। `main` में जल्दी लाइसेंस फ़ाइल लागू करें: + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +## निष्कर्ष + +अब आपके पास Aspose.HTML का उपयोग करके Java में **how to convert HTML file to PDF** के लिए एक ठोस, प्रोडक्शन‑रेडी समाधान है। Maven प्रोजेक्ट सेट अप करने से लेकर स्थानीय रिसोर्सेज को हैंडल करने और पेज ऑप्शन ट्यून करने तक, गाइड ने वह सब कवर किया है जो आपको **create PDF from HTML in Java** और **convert local HTML file to PDF** थर्ड‑पार्टी कमांड‑लाइन टूल्स के बिना चाहिए। + +अगला क्या? हेडर/फ़ूटर जोड़ने, PDF को एन्क्रिप्ट करने, या इस कन्वर्टर को Spring Boot REST एंडपॉइंट में इंटीग्रेट करने की कोशिश करें ताकि क्लाइंट HTML अपलोड कर सकें और तुरंत PDF प्राप्त कर सकें। संभावनाएँ अनंत हैं, और कोर पैटर्न वही रहता है। + +कोई प्रश्न हैं या कोई चतुर ट्रिक शेयर करना चाहते हैं? नीचे कमेंट छोड़ें – कोडिंग का आनंद लें! + +## अब आपको क्या सीखना चाहिए? + +निम्नलिखित ट्यूटोरियल्स उन संबंधित विषयों को कवर करते हैं जो इस गाइड में दिखाए गए तकनीकों पर आधारित हैं। प्रत्येक रिसोर्स में पूर्ण कार्यशील कोड उदाहरण और स्टेप‑बाय‑स्टेप व्याख्याएँ शामिल हैं जो आपको अतिरिक्त API फीचर्स में महारत हासिल करने और अपने प्रोजेक्ट्स में वैकल्पिक इम्प्लीमेंटेशन अप्रोचेज़ को एक्सप्लोर करने में मदद करेंगे। + +- [HTML को PDF में बदलें Java – Aspose.HTML में पर्यावरण कॉन्फ़िगर करना](/html/english/java/configuring-environment/) +- [HTML से PDF बनाएं – Aspose.HTML for Java में यूज़र स्टाइल शीट सेट करें](/html/english/java/configuring-environment/set-user-style-sheet/) +- [PDF पेज साइज सेट करें - Java में HTML को PDF में बदलें](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/hongkong/java/conversion-html-to-other-formats/_index.md b/html/hongkong/java/conversion-html-to-other-formats/_index.md index bcd12f00f5..f876083011 100644 --- a/html/hongkong/java/conversion-html-to-other-formats/_index.md +++ b/html/hongkong/java/conversion-html-to-other-formats/_index.md @@ -97,6 +97,8 @@ Aspose.HTML for Java 簡化了 HTML‑to‑PDF 工作流程。請參考專屬教 使用 Aspose.HTML 在 Java 中將 SVG 轉為 PDF，提供高品質文件轉換的無縫解決方案。 ### [Converting SVG to XPS](./convert-svg-to-xps/) 學習如何使用 Aspose.HTML for Java 將 SVG 轉為 XPS，提供簡單、步驟式的無縫轉換指南。 +### [如何在 Java 中將 HTML 檔案轉換為 PDF – 完整指南](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) +完整指南說明如何在 Java 中使用 Aspose.HTML 將 HTML 檔案轉換為 PDF，步驟詳盡。 ## 常見問題 diff --git a/html/hongkong/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/hongkong/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..54a719c39e --- /dev/null +++ b/html/hongkong/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-07-21 +description: 如何使用 Aspose.HTML 在 Java 中將 HTML 檔案轉換為 PDF。一步一步學習在 Java 中從 HTML 建立 PDF + 並處理本機檔案。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: zh-hant +lastmod: 2026-07-21 +og_description: 如何使用 Aspose.HTML 在 Java 中將 HTML 檔案轉換為 PDF。跟隨本指南，輕鬆在 Java 中從 HTML 生成 + PDF，輕鬆處理本機檔案。 +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: 在 Java 中將 HTML 檔案轉換為 PDF – 快速可靠的方法 +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: 如何在 Java 中將 HTML 檔案轉換為 PDF – 完整指南 +url: /zh-hant/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 如何在 Java 中將 HTML 檔案轉換為 PDF – 完整指南 + +有沒有想過 **如何將 HTML 檔案轉換為 PDF**，卻不想與命令列工具或繁雜的變通方法糾纏？你並非唯一有此需求的人。在許多以網頁為中心的專案中——例如自動化報告、發票產生或靜態網站存檔——將 HTML 頁面轉換成清晰的 PDF 是日常需求。 + +好消息是？使用 Aspose.HTML for Java，只需幾行程式碼即可完成。本教學將帶您一步步在 Java 中從 HTML 建立 PDF，涵蓋從專案設定到處理資源遺失等邊緣情況。 + +## 前置條件與您將建立的內容 + +在開始之前，請確保您具備： + +- JDK 17 或更新版本（最新的 LTS 版最佳） +- Maven 3.8+（若偏好亦可使用 Gradle） +- Aspose.HTML for Java 授權（免費試用版可用於測試） +- 一個放置於本機目錄的簡易 `input.html` 檔案 + +完成本指南後，您將擁有一個可執行的 Java 程式，**將本機 HTML 檔案轉換為 PDF**，可直接嵌入任何後端服務。 + +--- + +## 步驟 1：設定 Maven 專案（在 Java 中從 HTML 建立 PDF） + +首先，建立一個全新的 Maven 專案。如果您已經有 `pom.xml`，只需加入 Aspose.HTML 的相依性： + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **小技巧：** 保持 `pom.xml` 整潔；Maven 會自動下載傳遞相依性，您不必自行搜尋額外的 JAR。 + +## 步驟 2：撰寫轉換程式碼（如何將 HTML 檔案轉換為 PDF） + +建立一個名為 `HtmlToPdfConverter` 的類別。轉換的核心只需一次靜態呼叫，但我們會將其包裝起來，以提升可讀性與錯誤處理。 + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### 為什麼這樣可行 + +- `Converter.convert` 抽象化了解析、CSS 處理與影像嵌入，您不必自行管理渲染引擎。 +- 此方法會拋出 **`ConverterException`**，讓您能乾淨地因檔案遺失、HTML 格式錯誤或授權問題作出回應。 +- 將邏輯封裝在 `convert` 中，可在微服務、批次工作或簡易 CLI 工具間重複使用。 + +## 步驟 3：執行應用程式（在 Java 中從 HTML 建立 PDF） + +編譯並執行程式： + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +如果一切設定正確，您會看到： + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +開啟 `output.pdf` 後，應可看到 `input.html` 的完整呈現，包括 CSS 樣式、圖片，甚至在轉換時為靜態的 JavaScript 產生內容。 + +## 步驟 4：處理本機資源（將本機 HTML 檔案轉換為 PDF） + +您的 HTML 常會以相對路徑引用圖片、字型或 CSS 檔案。只要正確設定 base URI，Aspose.HTML 會自動解析這些資源。因為我們是以檔案路徑作為輸入，函式庫會將 `input.html` 所在目錄視為基礎路徑。 + +若需將 HTML 字串而非檔案轉換，請手動指定 base URI： + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **注意：** 忘記設定 base URI 會導致圖片遺失或樣式斷裂，這是首次 **convert html to pdf java** 時常見的陷阱。 + +## 步驟 5：進階選項（微調在 Java 中將 HTML 轉換為 PDF） + +Aspose.HTML 允許您調整頁面大小、邊距，甚至 PDF 的中繼資料： + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +當您需要 **convert html file to pdf** 以供列印或符合規範（例如 ISO‑216 A4 頁面）時，這些設定相當實用。 + +![How to convert html file to pdf illustration](image.png){.center alt="How to convert html file to pdf illustration"} + +*上圖說明了流程：Java 程式碼 → Aspose.HTML → PDF 輸出。* + +## 常見問題與邊緣案例 + +- **如果 HTML 包含外部網路字型呢？** + 只要機器能連上網路，Aspose.HTML 會自動下載。若需離線建置，請將字型打包於本機，並以相對路徑引用。 + +- **可以一次批次轉換多個 HTML 檔案嗎？** + 當然可以。將 `convert` 呼叫包在迴圈中，或從目錄讀取檔名。務必為每個檔案分別處理例外，避免單一錯誤中斷整個批次。 + +- **函式庫支援 Java 11+ 嗎？** + 支援。最新的 23.12 版以 Java 8 以上為目標，於現代執行環境皆可順利運行。 + +- **授權問題？** + 若試用版使用超過 30 天，輸出的 PDF 會加上浮水印。請在 `main` 方法一開始即載入授權檔： + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## 結論 + +現在您已掌握使用 Aspose.HTML 在 Java 中 **如何將 HTML 檔案轉換為 PDF** 的完整、可投入生產環境的解決方案。從 Maven 專案設定、處理本機資源到微調頁面選項，本文涵蓋了 **在 Java 中從 HTML 建立 PDF** 以及 **將本機 HTML 檔案轉換為 PDF** 所需的全部步驟，且不需依賴第三方命令列工具。 + +接下來可以嘗試加入頁首/頁尾、加密 PDF，或將此轉換器整合至 Spring Boot REST 端點，讓客戶端上傳 HTML 後即時取得 PDF。可能性無窮，而核心模式保持不變。 + +有任何問題或想分享巧思嗎？歡迎在下方留言 – 祝編程愉快！ + +## 接下來您可以學習什麼？ + +以下教學與本指南所示技巧緊密相關，能幫助您進一步掌握 API 功能並探索其他實作方式。每篇資源皆提供完整可執行的程式碼範例與逐步說明，協助您在專案中靈活運用。 + +- [將 HTML 轉換為 PDF（Java） – 在 Aspose.HTML 中設定環境](/html/english/java/configuring-environment/) +- [從 HTML 建立 PDF – 在 Aspose.HTML for Java 中設定使用者樣式表](/html/english/java/configuring-environment/set-user-style-sheet/) +- [設定 PDF 頁面大小 – 在 Java 中將 HTML 轉換為 PDF](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/hungarian/java/conversion-html-to-other-formats/_index.md b/html/hungarian/java/conversion-html-to-other-formats/_index.md index 1c7d52b932..e2950a4e89 100644 --- a/html/hungarian/java/conversion-html-to-other-formats/_index.md +++ b/html/hungarian/java/conversion-html-to-other-formats/_index.md @@ -97,6 +97,7 @@ Ismerje meg, hogyan konvertálhatja az SVG‑t képekké Java‑ban az Aspose.HT Konvertálja az SVG‑t PDF‑re Java‑ban az Aspose.HTML‑el. Zökkenőmentes megoldás a magas minőségű dokumentumkonverzióhoz. ### [SVG átalakítása XPS-re](./convert-svg-to-xps/) Ismerje meg, hogyan konvertálhatja az SVG‑t XPS‑re az Aspose.HTML for Java segítségével. Egyszerű, lépésről‑lépésre útmutató a zökkenőmentes átalakításokhoz. +### [HTML fájl PDF-re konvertálása Java-ban – Teljes útmutató](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) ## Gyakran Ismételt Kérdések diff --git a/html/hungarian/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/hungarian/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..e6ddd4056a --- /dev/null +++ b/html/hungarian/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,249 @@ +--- +category: general +date: 2026-07-21 +description: Hogyan konvertáljunk HTML fájlt PDF-re az Aspose.HTML segítségével Java-ban. + Tanulja meg lépésről lépésre, hogyan hozhatunk létre PDF-et HTML-ből Java-ban, és + hogyan kezelhetjük a helyi fájlokat. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: hu +lastmod: 2026-07-21 +og_description: Hogyan konvertáljunk HTML fájlt PDF-re az Aspose.HTML segítségével + Java-ban. Kövesse ezt az útmutatót, hogy PDF-et hozzon létre HTML-ből Java-ban, + a helyi fájlok könnyed kezelésével. +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: HTML fájl PDF-re konvertálása Java-ban – Gyors, megbízható módszer +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: Hogyan konvertáljunk HTML-fájlt PDF-re Java-ban – Teljes útmutató +url: /hu/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hogyan konvertáljunk HTML fájlt PDF-re Java‑ban – Teljes útmutató + +Gondolkodtál már azon, **hogyan konvertáljunk HTML fájlt PDF-re** anélkül, hogy parancssori eszközökkel vagy zavaros megoldásokkal kellene küzdeni? Nem vagy egyedül. Sok web‑központú projektben – gondolj az automatizált jelentéskészítésre, számlagenerálásra vagy statikus weboldalak archiválására – egy HTML oldal éles PDF‑re alakítása mindennapi igény. + +A jó hír? Az Aspose.HTML for Java segítségével néhány kódsorral megoldható. Ez az útmutató végigvezet a HTML‑ből PDF‑et készítés folyamatán Java‑ban, a projekt beállításától egészen a hiányzó erőforrások kezeléséig. + +## Előfeltételek és Mit Fogsz Elkészíteni + +- JDK 17 vagy újabb (a legújabb LTS verzió a legjobb) +- Maven 3.8+ (vagy Gradle, ha azt részesíted előnyben) +- Aspose.HTML for Java licenc (egy ingyenes próba a teszteléshez) +- Egy egyszerű `input.html` fájl egy helyi könyvtárban + +A útmutató végére egy futtatható Java programod lesz, amely **helyi HTML fájlt konvertál PDF‑re**, és készen áll bármely háttérszolgáltatásba integrálásra. + +--- + +## 1. lépés: Maven projekt beállítása (PDF létrehozása HTML‑ből Java‑ban) + +Először hozz létre egy új Maven projektet. Ha már van egy `pom.xml` fájlod, csak add hozzá az Aspose.HTML függőséget: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **Pro tipp:** Tartsd tisztán a `pom.xml`‑t; a Maven automatikusan letölti a transitív függőségeket, így nem kell külön JAR‑okat keresned. + +## 2. lépés: A konverziós kód megírása (Hogyan konvertáljunk HTML fájlt PDF‑re) + +Hozz létre egy `HtmlToPdfConverter` nevű osztályt. A konverzió magja egyetlen statikus hívásban található, de átfogjuk a kódot az átláthatóság és a hibakezelés érdekében. + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### Miért működik ez + +- **`Converter.convert`** elrejti a parse‑olást, a CSS‑kezelést és a képek beágyazását. Nem kell saját renderelő motorral foglalkoznod. +- A metódus **`ConverterException`**‑t dob, ami tiszta módot biztosít a hiányzó fájlok, hibás HTML vagy licencproblémák kezelésére. +- A logika `convert`‑ben való elkülönítésével újra felhasználhatod mikro‑szolgáltatásokban, kötegelt feladatokban vagy akár egy egyszerű CLI‑eszközben. + +## 3. lépés: Az alkalmazás futtatása (PDF létrehozása HTML‑ből Java‑ban) + +Fordítsd le és futtasd a programot: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +Ha minden helyesen van beállítva, a következőt fogod látni: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +Nyisd meg az `output.pdf`‑t – egy hűséges megjelenítést kell látnod az `input.html`‑ról, beleértve a CSS‑stílusokat, képeket, és még a JavaScript‑ből generált tartalmat is (amennyiben az a konverzió időpontjában statikus). + +## 4. lépés: Helyi erőforrások kezelése (Helyi HTML fájl konvertálása PDF‑re) + +Gyakran a HTML képekre, betűtípusokra vagy CSS‑fájlokra hivatkozik relatív útvonalakkal. Az Aspose.HTML automatikusan feloldja ezeket **ha** az alap‑URI helyesen van beállítva. Mivel egy fájlútvonalat adunk meg, a könyvtár az `input.html` könyvtárát kezeli alapként. + +Ha egy HTML‑szöveget kell konvertálni fájl helyett, manuálisan add meg az alap‑URI‑t: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **Figyelem:** Az alap‑URI elhagyása hiányzó képeket vagy törött stílusokat eredményez, ami gyakori buktató, amikor először **convert html to pdf java**-t próbálsz. + +## 5. lépés: Haladó beállítások (Finomhangolás: Convert HTML to PDF Java) + +Az Aspose.HTML lehetővé teszi az oldalméret, margók és még a PDF metaadatok finomhangolását: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +Ezek a beállítások hasznosak, ha **convert html file to pdf**‑t kell végezni nyomtatás vagy megfelelőség (pl. ISO‑216 A4 oldalak) céljából. + +--- + +![How to convert html file to pdf illustration](image.png){.center alt="Hogyan konvertáljunk HTML fájlt PDF-re ábra"} + +*A fenti diagram a folyamatot ábrázolja: Java kód → Aspose.HTML → PDF kimenet.* + +## Gyakori kérdések és szélhelyzetek + +- **Mi van, ha a HTML külső web‑fontokat tartalmaz?** + Az Aspose.HTML letölti őket, amíg a gépnek van internetkapcsolata. Offline build esetén csomagold be a betűtípusokat helyileg, és hivatkozz rájuk relatív úttal. + +- **Konvertálhatok több HTML fájlt kötegben?** + Természetesen. A `convert` hívást egy ciklusba ágyazhatod, például a könyvtárból beolvasva a fájlneveket. Ne felejtsd el a kivételeket fájlonként kezelni, hogy egy rossz bemenet ne szakítsa meg a teljes köteget. + +- **Támogatja a könyvtár a Java 11+ verziót?** + Igen, a jelenlegi 23.12 kiadás Java 8‑tól felfelé célozza, így modern futtatókörnyezetekben is biztonságosan használható. + +- **Licencproblémák?** + Ha a próbaverziót 30 napnál tovább használod, a kimeneti PDF vízjelet tartalmaz majd. A licencfájlt már a `main` elején alkalmazd: + +```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## Összegzés + +Most már egy stabil, termelés‑kész megoldásod van a **how to convert HTML file to PDF** feladatra az Aspose.HTML Java‑val. A Maven projekt beállításától a helyi erőforrások kezeléséig és az oldalbeállítások finomhangolásáig, az útmutató mindent lefed, amire szükséged van a **create PDF from HTML in Java** és a **convert local HTML file to PDF** végrehajtásához külső parancssori eszközök nélkül. + +Mi a következő? Próbálj meg fejlécet/láblécet hozzáadni, a PDF‑et titkosítani, vagy integráld a konvertert egy Spring Boot REST végpontra, hogy a kliensek HTML‑t tölthessenek fel és azonnal PDF‑et kapjanak. A lehetőségek végtelenek, és az alapminta változatlan marad. + +Van kérdésed vagy szeretnél egy okos trükköt megosztani? Írj egy megjegyzést alább – jó kódolást! + +## Mit érdemes legközelebb megtanulni? + +A következő oktatóanyagok szorosan kapcsolódó témákat fednek le, amelyek a jelen útmutatóban bemutatott technikákra épülnek. Minden forrás teljes, működő kódrészleteket tartalmaz lépésről‑lépésre magyarázatokkal, hogy elsajátíthasd a további API‑funkciókat és alternatív megvalósítási megközelítéseket a saját projektjeidben. + +- [HTML PDF-re konvertálás Java – Környezet beállítása az Aspose.HTML-ben](/html/english/java/configuring-environment/) +- [PDF létrehozása HTML‑ből – Felhasználói stíluslap beállítása az Aspose.HTML for Java-ban](/html/english/java/configuring-environment/set-user-style-sheet/) +- [PDF oldalméret beállítása – HTML PDF-re konvertálás Java‑ban](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/indonesian/java/conversion-html-to-other-formats/_index.md b/html/indonesian/java/conversion-html-to-other-formats/_index.md index 1fe7d1786c..a0673dc1c2 100644 --- a/html/indonesian/java/conversion-html-to-other-formats/_index.md +++ b/html/indonesian/java/conversion-html-to-other-formats/_index.md @@ -87,6 +87,9 @@ Sebagai kesimpulan, menguasai **html to pdf java** dan rangkaian konversi yang l ### [Mengonversi HTML ke PDF](./convert-html-to-pdf/) Pelajari cara mengonversi HTML ke PDF di Java menggunakan Aspose.HTML. Buat PDF berkualitas tinggi dari konten HTML Anda dengan mudah. +### [Cara Mengonversi File HTML ke PDF di Java – Panduan Lengkap](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) +Pelajari cara mengonversi file HTML menjadi PDF di Java dengan panduan lengkap dan contoh kode. + ### [Mengonversi HTML ke PDF di Java – Panduan Langkah‑demi‑Langkah dengan Pengaturan Ukuran Halaman](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) Panduan lengkap mengonversi HTML ke PDF di Java dengan pengaturan ukuran halaman yang dapat disesuaikan. diff --git a/html/indonesian/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/indonesian/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..8adaa16c6b --- /dev/null +++ b/html/indonesian/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,249 @@ +--- +category: general +date: 2026-07-21 +description: Cara mengonversi file HTML ke PDF menggunakan Aspose.HTML di Java. Pelajari + langkah demi langkah cara membuat PDF dari HTML di Java dan menangani file lokal. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: id +lastmod: 2026-07-21 +og_description: Cara mengonversi file HTML ke PDF dengan Aspose.HTML di Java. Ikuti + panduan ini untuk membuat PDF dari HTML di Java, menangani file lokal dengan mudah. +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: Cara Mengonversi File HTML ke PDF di Java – Metode Cepat dan Andal +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: Cara Mengonversi File HTML ke PDF di Java – Panduan Lengkap +url: /id/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cara Mengonversi File HTML ke PDF di Java – Panduan Lengkap + +Pernah bertanya-tanya **cara mengonversi file HTML ke PDF** tanpa berurusan dengan alat baris perintah atau solusi yang berantakan? Anda bukan satu-satunya. Dalam banyak proyek yang berfokus pada web – seperti pelaporan otomatis, pembuatan faktur, atau pengarsipan situs statis – mengubah halaman HTML menjadi PDF yang tajam adalah kebutuhan harian. + +Berita baik? Dengan Aspose.HTML untuk Java Anda dapat melakukannya hanya dengan beberapa baris kode. Tutorial ini memandu Anda membuat PDF dari HTML di Java, mencakup semua hal mulai dari penyiapan proyek hingga penanganan kasus tepi seperti sumber daya yang hilang. + +## Prasyarat & Apa yang Akan Anda Bangun + +Sebelum kita melangkah lebih jauh, pastikan Anda memiliki: + +- JDK 17 atau lebih baru (versi LTS terbaru bekerja paling baik) +- Maven 3.8+ (atau Gradle jika Anda lebih suka) +- Lisensi Aspose.HTML untuk Java (versi percobaan gratis cukup untuk pengujian) +- File `input.html` sederhana yang berada di direktori lokal + +Pada akhir panduan ini Anda akan memiliki program Java yang dapat dijalankan yang **mengonversi file HTML lokal ke PDF**, siap untuk dimasukkan ke layanan backend mana pun. + +--- + +## Langkah 1: Siapkan Proyek Maven (Buat PDF dari HTML di Java) + +Pertama, buat proyek Maven baru. Jika Anda sudah memiliki `pom.xml`, cukup tambahkan dependensi Aspose.HTML: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **Tips Pro:** Jaga `pom.xml` Anda tetap rapi; Maven akan menarik dependensi transitif secara otomatis, jadi Anda tidak perlu mencari JAR tambahan. + +## Langkah 2: Tulis Kode Konversi (Cara Mengonversi File HTML ke PDF) + +Buat kelas bernama `HtmlToPdfConverter`. Inti konversi berada dalam satu panggilan statis, tetapi kami akan membungkusnya untuk kejelasan dan penanganan error. + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### Mengapa Ini Berfungsi + +- **`Converter.convert`** menyederhanakan parsing, penanganan CSS, dan penyematan gambar. Anda tidak perlu mengelola mesin rendering sendiri. +- Metode ini melempar **`ConverterException`**, memberikan cara bersih untuk menanggapi file yang hilang, HTML yang tidak valid, atau masalah lisensi. +- Dengan mengisolasi logika dalam `convert`, Anda dapat menggunakannya kembali di micro‑service, pekerjaan batch, atau bahkan alat CLI sederhana. + +## Langkah 3: Jalankan Aplikasi (Buat PDF dari HTML di Java) + +Kompilasi dan jalankan program: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +Jika semuanya sudah diatur dengan benar, Anda akan melihat: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +Buka `output.pdf` – Anda akan melihat rendering yang setia dari `input.html`, termasuk gaya CSS, gambar, dan bahkan konten yang dihasilkan JavaScript (asalkan bersifat statis pada saat konversi). + +## Langkah 4: Menangani Sumber Daya Lokal (Konversi File HTML Lokal ke PDF) + +Seringkali HTML Anda merujuk gambar, font, atau file CSS melalui jalur relatif. Aspose.HTML menyelesaikannya secara otomatis **jika** base URI diatur dengan benar. Karena kami memberikan jalur file, perpustakaan memperlakukan direktori `input.html` sebagai basis. + +Jika Anda perlu mengonversi string HTML alih-alih file, tentukan base URI secara manual: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **Waspada:** Lupa menyertakan base URI akan menyebabkan gambar hilang atau gaya rusak, jebakan umum saat **convert html to pdf java** untuk pertama kalinya. + +## Langkah 5: Opsi Lanjutan (Penyetelan Halus Convert HTML ke PDF Java) + +Aspose.HTML memungkinkan Anda menyesuaikan ukuran halaman, margin, dan bahkan metadata PDF: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +Pengaturan ini berguna ketika Anda perlu **convert html file to pdf** untuk pencetakan atau kepatuhan (mis., halaman ISO‑216 A4). + +--- + +![How to convert html file to pdf illustration](image.png){.center alt="How to convert html file to pdf illustration"} + +*Diagram di atas memvisualisasikan alur: kode Java → Aspose.HTML → output PDF.* + +## Pertanyaan Umum & Kasus Tepi + +- **Bagaimana jika HTML berisi font web eksternal?** + Aspose.HTML akan mengunduhnya selama mesin memiliki akses internet. Untuk build offline, bundel font secara lokal dan referensikan dengan jalur relatif. + +- **Bisakah saya mengonversi beberapa file HTML dalam satu batch?** + Tentu saja. Bungkus panggilan `convert` dalam loop, mungkin membaca nama file dari sebuah direktori. Ingat untuk menangani exception per file sehingga satu input yang buruk tidak menghentikan seluruh batch. + +- **Apakah perpustakaan mendukung Java 11+?** + Ya, rilis 23.12 saat ini menargetkan Java 8 ke atas, jadi Anda aman pada runtime modern. + +- **Masalah lisensi?** + Jika Anda menjalankan percobaan lebih dari 30 hari, PDF output akan berisi watermark. Terapkan file lisensi Anda di awal `main`: + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## Kesimpulan + +Anda sekarang memiliki solusi yang solid dan siap produksi untuk **cara mengonversi file HTML ke PDF** menggunakan Aspose.HTML di Java. Dari menyiapkan proyek Maven hingga menangani sumber daya lokal dan menyesuaikan opsi halaman, panduan ini mencakup semua yang Anda perlukan untuk **membuat PDF dari HTML di Java** dan **mengonversi file HTML lokal ke PDF** tanpa alat baris perintah pihak ketiga. + +Apa selanjutnya? Coba tambahkan header/footer, enkripsi PDF, atau integrasikan konverter ini ke endpoint REST Spring Boot sehingga klien dapat mengunggah HTML dan menerima PDF secara langsung. Kemungkinannya tak terbatas, dan pola inti tetap sama. + +Ada pertanyaan atau ingin berbagi trik cerdas? Tinggalkan komentar di bawah – selamat coding! + +## Apa yang Harus Anda Pelajari Selanjutnya? + +Tutorial berikut mencakup topik yang terkait erat yang membangun teknik yang ditunjukkan dalam panduan ini. Setiap sumber menyertakan contoh kode lengkap yang berfungsi dengan penjelasan langkah demi langkah untuk membantu Anda menguasai fitur API tambahan dan mengeksplorasi pendekatan implementasi alternatif dalam proyek Anda sendiri. + +- [Mengonversi HTML ke PDF Java – Mengonfigurasi Lingkungan di Aspose.HTML](/html/english/java/configuring-environment/) +- [Membuat PDF dari HTML – Menetapkan User Style Sheet di Aspose.HTML untuk Java](/html/english/java/configuring-environment/set-user-style-sheet/) +- [Mengatur Ukuran Halaman PDF - Mengonversi HTML ke PDF di Java](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/italian/java/conversion-html-to-other-formats/_index.md b/html/italian/java/conversion-html-to-other-formats/_index.md index 8c3556a362..6498cbac23 100644 --- a/html/italian/java/conversion-html-to-other-formats/_index.md +++ b/html/italian/java/conversion-html-to-other-formats/_index.md @@ -91,6 +91,7 @@ In conclusione, padroneggiare **html to pdf java** e l'insieme più ampio di con ### [Conversione da SVG a Immagine](./convert-svg-to-image/) ### [Conversione da SVG a PDF](./convert-svg-to-pdf/) ### [Conversione da SVG a XPS](./convert-svg-to-xps/) +### [Come convertire un file HTML in PDF con Java – Guida completa](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) ## Domande frequenti diff --git a/html/italian/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/italian/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..5df5c9e294 --- /dev/null +++ b/html/italian/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,250 @@ +--- +category: general +date: 2026-07-21 +description: Come convertire un file HTML in PDF usando Aspose.HTML in Java. Impara + passo passo a creare PDF da HTML in Java e gestire i file locali. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: it +lastmod: 2026-07-21 +og_description: Come convertire un file HTML in PDF con Aspose.HTML in Java. Segui + questa guida per creare PDF da HTML in Java, gestendo i file locali senza sforzo. +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: Come convertire un file HTML in PDF con Java – Metodo veloce e affidabile +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: Come convertire un file HTML in PDF in Java – Guida completa +url: /it/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Come Convertire un File HTML in PDF con Java – Guida Completa + +Ti sei mai chiesto **come convertire un file HTML in PDF** senza dover combattere con strumenti da riga di comando o soluzioni ingarbugliate? Non sei l'unico. In molti progetti web‑centrici – pensa a report automatici, generazione di fatture o archiviazione di siti statici – trasformare una pagina HTML in un PDF nitido è una necessità quotidiana. + +La buona notizia? Con Aspose.HTML per Java puoi farlo in poche righe di codice. Questo tutorial ti guida nella creazione di PDF da HTML in Java, coprendo tutto, dall’impostazione del progetto alla gestione di casi particolari come risorse mancanti. + +## Prerequisiti e Cosa Costruirai + +Prima di iniziare, assicurati di avere: + +- JDK 17 o superiore (l’ultima versione LTS è la migliore) +- Maven 3.8+ (o Gradle se preferisci) +- Una licenza Aspose.HTML per Java (una prova gratuita è sufficiente per i test) +- Un semplice file `input.html` posizionato in una directory locale + +Al termine di questa guida avrai un programma Java eseguibile che **converte un file HTML locale in PDF**, pronto per essere inserito in qualsiasi servizio backend. + +--- + +## Passo 1: Configura il Progetto Maven (Crea PDF da HTML in Java) + +Per prima cosa, crea un nuovo progetto Maven. Se hai già un `pom.xml`, aggiungi semplicemente la dipendenza Aspose.HTML: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **Consiglio:** Mantieni il tuo `pom.xml ordinato; Maven scaricherà automaticamente le dipendenze transitive, così non dovrai cercare JAR aggiuntivi. + +## Passo 2: Scrivi il Codice di Conversione (Come Convertire un File HTML in PDF) + +Crea una classe chiamata `HtmlToPdfConverter`. Il cuore della conversione è una singola chiamata statica, ma la avvolgeremo per chiarezza e gestione degli errori. + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### Perché Funziona + +- **`Converter.convert`** astrae il parsing, la gestione del CSS e l’incorporamento delle immagini. Non devi gestire un motore di rendering da solo. +- Il metodo lancia **`ConverterException`**, offrendoti un modo pulito per reagire a file mancanti, HTML malformato o problemi di licenza. +- Isolando la logica in `convert`, puoi riutilizzarla in micro‑servizi, job batch o anche in un semplice strumento da riga di comando. + +## Passo 3: Esegui l’Applicazione (Crea PDF da HTML in Java) + +Compila ed esegui il programma: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +Se tutto è configurato correttamente, vedrai: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +Apri `output.pdf` – dovresti vedere una resa fedele di `input.html`, inclusi stili CSS, immagini e persino contenuti generati da JavaScript (purché siano statici al momento della conversione). + +## Passo 4: Gestione delle Risorse Locali (Converti un File HTML Locale in PDF) + +Spesso il tuo HTML fa riferimento a immagini, font o file CSS tramite percorsi relativi. Aspose.HTML risolve questi automaticamente **se** l’URI di base è impostato correttamente. Poiché forniamo un percorso file, la libreria tratta la directory di `input.html` come base. + +Se devi convertire una stringa HTML invece di un file, specifica manualmente un URI di base: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **Attenzione:** Dimenticare l’URI di base causerà immagini mancanti o stili rotti, un errore comune quando **converti html in pdf java** per la prima volta. + +## Passo 5: Opzioni Avanzate (Ottimizzare la Conversione da HTML a PDF in Java) + +Aspose.HTML ti permette di regolare dimensione della pagina, margini e persino i metadati PDF: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +Queste impostazioni sono utili quando devi **convertire un file html in pdf** per stampa o conformità (ad es. pagine A4 ISO‑216). + +--- + +![How to convert html file to pdf illustration](image.png){.center alt="Come convertire un file html in pdf illustrazione"} + +*Il diagramma sopra visualizza il flusso: codice Java → Aspose.HTML → output PDF.* + +## Domande Frequenti e Casi Particolari + +- **E se l’HTML contiene web‑font esterni?** + Aspose.HTML li scaricherà purché la macchina abbia accesso a Internet. Per build offline, includi i font localmente e riferiscili con un percorso relativo. + +- **Posso convertire più file HTML in batch?** + Assolutamente. Avvolgi la chiamata `convert` dentro un ciclo, magari leggendo i nomi dei file da una directory. Ricorda di gestire le eccezioni per ogni file così un input errato non interrompe l’intero batch. + +- **La libreria supporta Java 11+?** + Sì, l’attuale release 23.12 mira a Java 8 e versioni successive, quindi sei a posto su runtime moderni. + +- **Problemi di licenza?** + Se usi la versione di prova per più di 30 giorni, il PDF generato conterrà una filigrana. Applica il file di licenza subito in `main`: + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## Conclusione + +Ora disponi di una soluzione solida, pronta per la produzione, su **come convertire un file HTML in PDF** usando Aspose.HTML in Java. Dall’impostazione del progetto Maven alla gestione delle risorse locali e alla personalizzazione delle opzioni di pagina, la guida ha coperto tutto ciò che ti serve per **creare PDF da HTML in Java** e **convertire file HTML locale in PDF** senza strumenti da riga di comando di terze parti. + +Qual è il prossimo passo? Prova ad aggiungere intestazioni/piedi di pagina, a crittografare il PDF o a integrare questo convertitore in un endpoint REST Spring Boot così i client possono caricare HTML e ricevere un PDF al volo. Le possibilità sono infinite, e il modello di base rimane lo stesso. + +Hai domande o vuoi condividere un trucco intelligente? Lascia un commento qui sotto – buona programmazione! + +## Cosa Dovresti Imparare Dopo? + + +I tutorial seguenti trattano argomenti strettamente correlati che si basano sulle tecniche dimostrate in questa guida. Ogni risorsa include esempi di codice completi e funzionanti con spiegazioni passo‑passo per aiutarti a padroneggiare funzionalità aggiuntive dell’API ed esplorare approcci di implementazione alternativi nei tuoi progetti. + +- [Convertire HTML in PDF Java – Configurare l’Ambiente in Aspose.HTML](/html/english/java/configuring-environment/) +- [Creare PDF da HTML – Impostare un Foglio di Stile Utente in Aspose.HTML per Java](/html/english/java/configuring-environment/set-user-style-sheet/) +- [Impostare la Dimensione della Pagina PDF - Convertire HTML in PDF in Java](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/japanese/java/conversion-html-to-other-formats/_index.md b/html/japanese/java/conversion-html-to-other-formats/_index.md index ef52efca8d..a51c34d005 100644 --- a/html/japanese/java/conversion-html-to-other-formats/_index.md +++ b/html/japanese/java/conversion-html-to-other-formats/_index.md @@ -82,21 +82,14 @@ SVG グラフィックを XPS フォーマットに変換し、デバイス間 ## Conversion - HTML to Other Formats Tutorials ### [Converting HTML to PDF](./convert-html-to-pdf/) -Aspose.HTML を使用して Java で HTML を PDF に変換する方法を学びます。HTML コンテンツから高品質な PDF を手軽に作成できます。 ### [Converting HTML to MHTML](./convert-html-to-mhtml/) -Aspose.HTML for Java で HTML を MHTML に簡単に変換します。効率的な HTML‑to‑MHTML 変換の手順をご覧ください。 ### [Converting HTML to XPS](./convert-html-to-xps/) -Aspose.HTML for Java を使用して HTML を XPS にシームレスに変換する方法を学びます。クロスプラットフォーム文書を簡単に作成できます。 ### [Converting Markdown to HTML](./convert-markdown-to-html/) -Aspose.HTML for Java で Java の Markdown を HTML にシームレスに変換します。文書変換のニーズを効率化する手順をご確認ください。 ### [Converting SVG to Image](./convert-svg-to-image/) -Aspose.HTML を使用して Java で SVG を画像に変換する方法を学びます。高品質出力のための包括的ガイドです。 ### [Converting SVG to PDF](./convert-svg-to-pdf/) -Aspose.HTML で Java の SVG を PDF に変換します。高品質文書変換のシームレスなソリューションです。 ### [Converting SVG to XPS](./convert-svg-to-xps/) -Aspose.HTML for Java を使用して SVG を XPS に変換する方法を学びます。シンプルでステップバイステップのガイドでシームレスに変換できます。 ### [JavaでHTMLをPDFに変換 – ページサイズ設定付きステップバイステップガイド](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) -JavaでHTMLをPDFに変換し、ページサイズをカスタマイズする手順を詳しく解説します。 +### [JavaでHTMLファイルをPDFに変換する方法 – 完全ガイド](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) ## よくある質問 diff --git a/html/japanese/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/japanese/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..9796bc73f9 --- /dev/null +++ b/html/japanese/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-07-21 +description: Aspose.HTML を使用して Java で HTML ファイルを PDF に変換する方法。Java で HTML から PDF を作成し、ローカルファイルを扱う手順をステップバイステップで学びます。 +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: ja +lastmod: 2026-07-21 +og_description: JavaでAspose.HTMLを使用してHTMLファイルをPDFに変換する方法。ローカルファイルを簡単に扱いながら、JavaでHTMLからPDFを作成するこのガイドに従ってください。 +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: JavaでHTMLファイルをPDFに変換する方法 – 高速で信頼性の高い手法 +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: JavaでHTMLファイルをPDFに変換する方法 – 完全ガイド +url: /ja/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# JavaでHTMLファイルをPDFに変換する方法 – 完全ガイド + +コマンドラインツールや面倒な回避策に悩まされずに **HTMLファイルをPDFに変換する方法** を知りたくありませんか？ あなただけではありません。自動レポート作成、請求書生成、静的サイトのアーカイブなど、Web中心のプロジェクトでは HTML ページをきれいな PDF に変換する必要が日常的にあります。 + +朗報です！ Aspose.HTML for Java を使えば、数行のコードで実現できます。このチュートリアルでは、Java で HTML から PDF を作成する手順を、プロジェクトのセットアップからリソースが欠如している場合の対処まで網羅的に解説します。 + +## 前提条件と作成するもの + +始める前に以下を用意してください。 + +- JDK 17 以上（最新の LTS バージョンが最適です） +- Maven 3.8+（好みであれば Gradle でも可） +- Aspose.HTML for Java のライセンス（テスト用の無料トライアルで可） +- ローカルディレクトリに置いたシンプルな `input.html` ファイル + +このガイドを終える頃には、**ローカルの HTML ファイルを PDF に変換する** ことができる実行可能な Java プログラムが完成し、任意のバックエンドサービスに組み込める状態になります。 + +--- + +## 手順 1: Maven プロジェクトのセットアップ（Java で HTML から PDF を作成） + +まず、Maven プロジェクトを新規作成します。既に `pom.xml` がある場合は、Aspose.HTML の依存関係を追加するだけです。 + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **プロのコツ:** `pom.xml` はすっきり保ちましょう。Maven が自動的にトランジティブ依存関係を取得してくれるので、余計な JAR を探す必要はありません。 + +## 手順 2: 変換コードの作成（HTML ファイルを PDF に変換する方法） + +`HtmlToPdfConverter` という名前のクラスを作成します。変換の核心は 1 つの静的メソッド呼び出しにありますが、可読性とエラーハンドリングのためにラップします。 + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### なぜこの方法が有効なのか + +- **`Converter.convert`** はパース、CSS の処理、画像埋め込みをすべて抽象化します。自前でレンダリングエンジンを管理する必要はありません。 +- メソッドは **`ConverterException`** をスローし、ファイル欠如、HTML の不正、ライセンス問題などに対してクリーンに対処できます。 +- ロジックを `convert` に切り出すことで、マイクロサービス、バッチジョブ、シンプルな CLI ツールなど、あらゆる場所で再利用可能です。 + +## 手順 3: アプリケーションの実行（Java で HTML から PDF を作成） + +プログラムをコンパイルして実行します。 + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +正しくセットアップされていれば、次のような出力が表示されます。 + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +`output.pdf` を開くと、`input.html` の忠実なレンダリングが確認でき、CSS スタイル、画像、さらには変換時点で静的であれば JavaScript によって生成されたコンテンツまで含まれます。 + +## 手順 4: ローカルリソースの取り扱い（ローカル HTML ファイルを PDF に変換） + +HTML が画像、フォント、CSS ファイルを相対パスで参照していることがよくあります。Aspose.HTML は **ベース URI が正しく設定されていれば** それらを自動的に解決します。ファイルパスを渡すので、ライブラリは `input.html` があるディレクトリをベースとして扱います。 + +文字列から HTML を変換したい場合は、ベース URI を手動で指定します。 + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **注意:** ベース URI を忘れると画像が欠けたりスタイルが崩れたりします。これは **convert html to pdf java** を初めて行うときの典型的な落とし穴です。 + +## 手順 5: 詳細オプション（Java で HTML を PDF に変換する際の微調整） + +Aspose.HTML ではページサイズ、余白、PDF メタデータなどを細かく設定できます。 + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +印刷やコンプライアンス（例: ISO‑216 A4 ページ）向けに **convert html file to pdf** が必要な場合に便利です。 + +--- + +![HTML ファイルを PDF に変換する方法のイラスト](image.png){.center alt="HTML ファイルを PDF に変換する方法のイラスト"} + +*上図はフローを可視化しています: Java コード → Aspose.HTML → PDF 出力。* + +## よくある質問とエッジケース + +- **HTML に外部ウェブフォントが含まれている場合は？** + Aspose.HTML はインターネットに接続できれば自動でダウンロードします。オフライン環境向けにはフォントをローカルにバンドルし、相対パスで参照してください。 + +- **複数の HTML ファイルをバッチで変換できますか？** + 可能です。`convert` 呼び出しをループで回し、ディレクトリからファイル名を取得すると良いでしょう。ファイルごとに例外処理を行い、1 つの不正な入力でバッチ全体が中断しないようにします。 + +- **ライブラリは Java 11+ をサポートしていますか？** + はい。現在の 23.12 リリースは Java 8 以上を対象としているので、最新ランタイムでも問題なく動作します。 + +- **ライセンスに関する問題は？** + トライアルを 30 日以上使用すると、出力 PDF に透かしが入ります。`main` メソッドの冒頭でライセンスファイルを適用してください。 + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## 結論 + +これで、Aspose.HTML for Java を使って **HTML ファイルを PDF に変換する方法** の実装が完了しました。Maven プロジェクトのセットアップからローカルリソースの処理、ページオプションの調整まで、**Java で HTML から PDF を作成** し、**ローカル HTML ファイルを PDF に変換** するために必要なすべてを網羅しました。サードパーティのコマンドラインツールは不要です。 + +次は何をしますか？ ヘッダー/フッターの追加、PDF の暗号化、あるいは Spring Boot の REST エンドポイントに統合して、クライアントが HTML をアップロードし即座に PDF を受け取れるようにしてみましょう。可能性は無限大で、基本パターンは変わりません。 + +質問や便利なカスタマイズがあれば、ぜひコメントでシェアしてください – ハッピーコーディング！ + +## 次に学ぶべきこと + +以下のチュートリアルは、本ガイドで示したテクニックを応用した関連トピックを扱っています。各リソースには、ステップバイステップの解説と完全なコード例が含まれており、追加の API 機能を習得したり、別の実装アプローチを探求したりするのに役立ちます。 + +- [Convert HTML to PDF Java – Configuring Environment in Aspose.HTML](/html/english/java/configuring-environment/) +- [Create PDF from HTML – Set User Style Sheet in Aspose.HTML for Java](/html/english/java/configuring-environment/set-user-style-sheet/) +- [Set PDF Page Size - Convert HTML to PDF in Java](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/korean/java/conversion-html-to-other-formats/_index.md b/html/korean/java/conversion-html-to-other-formats/_index.md index de4e019fe7..c1e0ed5b72 100644 --- a/html/korean/java/conversion-html-to-other-formats/_index.md +++ b/html/korean/java/conversion-html-to-other-formats/_index.md @@ -98,6 +98,8 @@ Aspose.HTML를 사용하여 Java에서 SVG를 이미지로 변환하는 방법 Aspose.HTML를 사용하여 Java에서 SVG를 PDF로 변환합니다. 고품질 문서 변환을 위한 원활한 솔루션입니다. ### [SVG를 XPS로 변환](./convert-svg-to-xps/) Aspose.HTML for Java를 사용하여 SVG를 XPS로 변환하는 방법을 배우세요. 원활한 변환을 위한 간단하고 단계별 가이드입니다. +### [Java에서 HTML 파일을 PDF로 변환하는 방법 – 완전 가이드](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) +Aspose.HTML를 사용하여 Java에서 HTML 파일을 PDF로 변환하는 전체 단계별 가이드를 확인하세요. ## 자주 묻는 질문 diff --git a/html/korean/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/korean/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..69484d2b4a --- /dev/null +++ b/html/korean/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,243 @@ +--- +category: general +date: 2026-07-21 +description: Java에서 Aspose.HTML을 사용하여 HTML 파일을 PDF로 변환하는 방법. Java에서 HTML을 PDF로 만들고 + 로컬 파일을 처리하는 단계별 학습. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: ko +lastmod: 2026-07-21 +og_description: Java에서 Aspose.HTML을 사용해 HTML 파일을 PDF로 변환하는 방법. 이 가이드를 따라 Java에서 HTML을 + PDF로 만들고 로컬 파일을 손쉽게 처리하세요. +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: Java에서 HTML 파일을 PDF로 변환하는 방법 – 빠르고 신뢰할 수 있는 방법 +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: Java에서 HTML 파일을 PDF로 변환하는 방법 – 완전 가이드 +url: /ko/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Java에서 HTML 파일을 PDF로 변환하는 방법 – 완전 가이드 + +명령줄 도구나 복잡한 우회 방법 없이 **HTML 파일을 PDF로 변환하는 방법**을 궁금해 본 적 있나요? 당신만 그런 것이 아닙니다. 자동 보고서, 청구서 생성, 정적 사이트 보관 등 웹 중심 프로젝트에서 HTML 페이지를 선명한 PDF로 바꾸는 일은 일상적인 요구입니다. + +좋은 소식은? Aspose.HTML for Java를 사용하면 몇 줄의 코드만으로도 가능합니다. 이 튜토리얼은 Java에서 HTML을 PDF로 만드는 과정을 프로젝트 설정부터 누락된 리소스와 같은 엣지 케이스 처리까지 단계별로 안내합니다. + +## 사전 요구 사항 및 구축할 내용 + +- JDK 17 이상 (최신 LTS 버전이 가장 좋습니다) +- Maven 3.8+ (또는 선호한다면 Gradle) +- Aspose.HTML for Java 라이선스 (무료 체험판으로 테스트 가능) +- 로컬 디렉터리에 위치한 간단한 `input.html` 파일 + +이 가이드를 마치면 **로컬 HTML 파일을 PDF로 변환**하는 실행 가능한 Java 프로그램을 얻게 되며, 이를 어떤 백엔드 서비스에도 손쉽게 적용할 수 있습니다. + +--- + +## 단계 1: Maven 프로젝트 설정 (Java에서 HTML을 PDF로 만들기) + +먼저 새 Maven 프로젝트를 생성합니다. 이미 `pom.xml`이 있다면 Aspose.HTML 의존성을 추가하기만 하면 됩니다: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **Pro tip:** `pom.xml`을 깔끔하게 유지하세요; Maven이 전이 의존성을 자동으로 가져오므로 별도의 JAR를 찾아볼 필요가 없습니다. + +## 단계 2: 변환 코드 작성 (HTML 파일을 PDF로 변환하는 방법) + +`HtmlToPdfConverter`라는 클래스를 만듭니다. 변환의 핵심은 하나의 정적 메서드 호출에 있지만, 가독성과 오류 처리를 위해 래핑합니다. + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### 왜 이렇게 동작할까요 + +- **`Converter.convert`**는 파싱, CSS 처리 및 이미지 삽입을 추상화합니다. 직접 렌더링 엔진을 관리할 필요가 없습니다. +- 이 메서드는 **`ConverterException`**을 발생시켜 파일 누락, 잘못된 HTML, 라이선스 문제 등에 깔끔하게 대응할 수 있게 합니다. +- `convert` 로직을 분리함으로써 마이크로서비스, 배치 작업, 혹은 간단한 CLI 도구에서도 재사용할 수 있습니다. + +## 단계 3: 애플리케이션 실행 (Java에서 HTML을 PDF로 만들기) + +프로그램을 컴파일하고 실행합니다: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +설정이 모두 올바르면 다음과 같은 출력이 보일 것입니다: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +`output.pdf`를 열면 `input.html`의 CSS 스타일, 이미지, 그리고 변환 시점에 정적인 JavaScript‑생성 콘텐츠까지 충실히 렌더링된 것을 확인할 수 있습니다. + +## 단계 4: 로컬 리소스 처리 (로컬 HTML 파일을 PDF로 변환하기) + +HTML이 이미지, 폰트, CSS 파일을 상대 경로로 참조하는 경우가 많습니다. Aspose.HTML는 **베이스 URI가 올바르게 설정된 경우** 이를 자동으로 해결합니다. 파일 경로를 제공하면 라이브러리는 `input.html`이 위치한 디렉터리를 베이스로 간주합니다. + +파일 대신 HTML 문자열을 변환해야 한다면 베이스 URI를 수동으로 지정하세요: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **Watch out:** 베이스 URI를 지정하지 않으면 이미지가 누락되거나 스타일이 깨지는 흔한 실수가 발생합니다. 특히 **convert html to pdf java**를 처음 시도할 때 주의하세요. + +## 단계 5: 고급 옵션 (HTML을 PDF로 변환하기 세부 조정) + +Aspose.HTML를 사용하면 페이지 크기, 여백, PDF 메타데이터 등을 조정할 수 있습니다: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +인쇄나 규정 준수(예: ISO‑216 A4 페이지)가 필요할 때 **convert html file to pdf** 옵션이 유용합니다. + +![HTML 파일을 PDF로 변환하는 방법 일러스트](image.png){.center alt="HTML 파일을 PDF로 변환하는 방법 일러스트"} + +*위 다이어그램은 흐름을 시각화합니다: Java 코드 → Aspose.HTML → PDF 출력.* + +## 일반적인 질문 및 엣지 케이스 + +- **HTML에 외부 웹 폰트가 포함된 경우는?** + 머신에 인터넷 연결이 되어 있으면 Aspose.HTML가 폰트를 다운로드합니다. 오프라인 빌드가 필요하면 폰트를 로컬에 번들하고 상대 경로로 참조하세요. + +- **여러 HTML 파일을 배치로 변환할 수 있나요?** + 물론 가능합니다. `convert` 호출을 루프 안에 넣고 디렉터리에서 파일명을 읽어 처리하면 됩니다. 파일마다 예외를 개별적으로 처리해 하나의 잘못된 입력이 전체 배치를 중단하지 않도록 하세요. + +- **라이브러리가 Java 11+을 지원하나요?** + 네, 현재 23.12 릴리스는 Java 8 이상을 대상으로 하므로 최신 런타임에서도 안전하게 사용할 수 있습니다. + +- **라이선스 문제는?** + 체험판을 30일 이상 사용하면 출력 PDF에 워터마크가 삽입됩니다. `main` 메서드 초기에 라이선스 파일을 적용하세요: + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +## 결론 + +이제 Aspose.HTML for Java를 사용해 **HTML 파일을 PDF로 변환하는 방법**에 대한 견고하고 프로덕션 수준의 솔루션을 갖추었습니다. Maven 프로젝트 설정부터 로컬 리소스 처리, 페이지 옵션 조정까지, **Java에서 HTML을 PDF로 만들기**와 **로컬 HTML 파일을 PDF로 변환**에 필요한 모든 내용을 다루었습니다. + +다음 단계는 무엇인가요? 헤더/푸터 추가, PDF 암호화, 혹은 Spring Boot REST 엔드포인트에 이 변환기를 통합해 클라이언트가 HTML을 업로드하면 즉시 PDF를 반환하도록 해보세요. 가능성은 무궁무진하며 핵심 패턴은 변하지 않습니다. + +질문이 있거나 멋진 팁을 공유하고 싶다면 아래 댓글을 남겨 주세요 – 즐거운 코딩 되세요! + +## 다음에 배울 내용은? + +다음 튜토리얼은 이 가이드에서 시연한 기술을 기반으로 하는 밀접한 주제를 다룹니다. 각 리소스는 완전한 코드 예제와 단계별 설명을 포함하고 있어 추가 API 기능을 마스터하고 프로젝트에 다양한 구현 방식을 적용하는 데 도움이 됩니다. + +- [HTML을 PDF로 변환 Java – Aspose.HTML에서 환경 구성](/html/english/java/configuring-environment/) +- [HTML에서 PDF 만들기 – Aspose.HTML for Java에서 사용자 스타일 시트 설정](/html/english/java/configuring-environment/set-user-style-sheet/) +- [PDF 페이지 크기 설정 - Java에서 HTML을 PDF로 변환](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/polish/java/conversion-html-to-other-formats/_index.md b/html/polish/java/conversion-html-to-other-formats/_index.md index f5a75bf2cc..5c0ba38930 100644 --- a/html/polish/java/conversion-html-to-other-formats/_index.md +++ b/html/polish/java/conversion-html-to-other-formats/_index.md @@ -98,6 +98,8 @@ Learn how to convert SVG to images in Java with Aspose.HTML. Comprehensive guide Convert SVG to PDF in Java with Aspose.HTML. A seamless solution for high-quality document conversion. ### [Converting SVG to XPS](./convert-svg-to-xps/) Learn how to convert SVG to XPS with Aspose.HTML for Java. Simple, step-by-step guide for seamless conversions. +### [Jak przekonwertować plik HTML do PDF w Javie – Kompletny przewodnik](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) +Pełny przewodnik, jak w Javie przekształcić plik HTML w wysokiej jakości PDF przy użyciu Aspose.HTML. ## Często zadawane pytania diff --git a/html/polish/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/polish/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..fee1fe0cdd --- /dev/null +++ b/html/polish/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,250 @@ +--- +category: general +date: 2026-07-21 +description: Jak przekonwertować plik HTML na PDF przy użyciu Aspose.HTML w Javie. + Dowiedz się krok po kroku, jak tworzyć PDF z HTML w Javie i obsługiwać pliki lokalne. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: pl +lastmod: 2026-07-21 +og_description: Jak przekonwertować plik HTML na PDF przy użyciu Aspose.HTML w Javie. + Skorzystaj z tego przewodnika, aby stworzyć PDF z HTML w Javie, obsługując lokalne + pliki bez wysiłku. +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: Jak przekonwertować plik HTML na PDF w Javie – szybka, niezawodna metoda +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: Jak przekonwertować plik HTML na PDF w Javie – Kompletny przewodnik +url: /pl/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Jak przekonwertować plik HTML na PDF w Javie – Kompletny przewodnik + +Zastanawiałeś się kiedyś **jak przekonwertować plik HTML na PDF** bez walki z narzędziami wiersza poleceń czy niechlujnymi obejściami? Nie jesteś jedyny. W wielu projektach skoncentrowanych na sieci – pomyśl o automatycznym raportowaniu, generowaniu faktur lub archiwizacji statycznych stron – przekształcenie strony HTML w wyraźny PDF jest codzienną potrzebą. + +Dobre wieści? Z Aspose.HTML for Java możesz to zrobić w zaledwie kilku linijkach kodu. Ten samouczek przeprowadzi Cię przez tworzenie PDF z HTML w Javie, obejmując wszystko od konfiguracji projektu po obsługę przypadków brzegowych, takich jak brakujące zasoby. + +## Wymagania wstępne i co zbudujesz + +Before we dive, make sure you have: + +- JDK 17 lub nowszy (najlepsza jest najnowsza wersja LTS) +- Maven 3.8+ (lub Gradle, jeśli wolisz) +- Licencja Aspose.HTML for Java (bezpłatna wersja próbna wystarczy do testów) +- Prosty plik `input.html` znajdujący się w lokalnym katalogu + +Po zakończeniu tego przewodnika będziesz mieć uruchamialny program w Javie, który **konwertuje lokalny plik HTML na PDF**, gotowy do wstawienia w dowolną usługę backendową. + +--- + +## Krok 1: Konfiguracja projektu Maven (Tworzenie PDF z HTML w Javie) + +Najpierw utwórz nowy projekt Maven. Jeśli już masz plik `pom.xml`, po prostu dodaj zależność Aspose.HTML: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **Wskazówka:** Trzymaj swój `pom.xml` w porządku; Maven automatycznie pobierze zależności tranzytywne, więc nie musisz szukać dodatkowych plików JAR. + +## Krok 2: Napisz kod konwersji (Jak przekonwertować plik HTML na PDF) + +Utwórz klasę o nazwie `HtmlToPdfConverter`. Rdzeń konwersji znajduje się w pojedynczym wywołaniu statycznym, ale opakujemy go dla przejrzystości i obsługi błędów. + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### Dlaczego to działa + +- **`Converter.convert`** abstrahuje parsowanie, obsługę CSS i osadzanie obrazów. Nie musisz sam zarządzać silnikiem renderującym. +- Metoda rzuca **`ConverterException`**, co daje czysty sposób reagowania na brakujące pliki, niepoprawny HTML lub problemy z licencją. +- Izolując logikę w `convert`, możesz ją ponownie używać w mikro‑serwisach, zadaniach wsadowych lub nawet w prostym narzędziu CLI. + +## Krok 3: Uruchom aplikację (Tworzenie PDF z HTML w Javie) + +Skompiluj i uruchom program: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +Jeśli wszystko jest poprawnie skonfigurowane, zobaczysz: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +Otwórz `output.pdf` – powinieneś zobaczyć wierne odwzorowanie `input.html`, w tym style CSS, obrazy oraz nawet treść generowaną przez JavaScript (o ile jest statyczna w momencie konwersji). + +## Krok 4: Obsługa lokalnych zasobów (Konwertowanie lokalnego pliku HTML na PDF) + +Często Twój HTML odwołuje się do obrazów, czcionek lub plików CSS za pomocą ścieżek względnych. Aspose.HTML rozwiązuje je automatycznie **jeśli** bazowy URI jest ustawiony prawidłowo. Ponieważ podajemy ścieżkę do pliku, biblioteka traktuje katalog `input.html` jako bazę. + +Jeśli potrzebujesz skonwertować ciąg HTML zamiast pliku, określ bazowy URI ręcznie: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **Uwaga:** Zapomnienie o ustawieniu bazowego URI spowoduje brakujące obrazy lub zepsute style, co jest częstą pułapką przy **konwertowanie html na pdf java** po raz pierwszy. + +## Krok 5: Zaawansowane opcje (Dostrajanie konwersji HTML do PDF w Javie) + +Aspose.HTML pozwala dostosować rozmiar strony, marginesy i nawet metadane PDF: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +Te ustawienia są przydatne, gdy potrzebujesz **konwertować plik html na pdf** do druku lub zgodności (np. strony ISO‑216 A4). + +--- + +![Ilustracja jak przekonwertować plik html na pdf](image.png){.center alt="Ilustracja jak przekonwertować plik html na pdf"} + +*Diagram powyżej wizualizuje przepływ: kod Java → Aspose.HTML → wynik PDF.* + +## Częste pytania i przypadki brzegowe + +- **Co jeśli HTML zawiera zewnętrzne czcionki internetowe?** + Aspose.HTML pobierze je, o ile maszyna ma dostęp do internetu. Dla kompilacji offline, dołącz czcionki lokalnie i odwołuj się do nich względną ścieżką. + +- **Czy mogę konwertować wiele plików HTML jednocześnie?** + Oczywiście. Umieść wywołanie `convert` w pętli, np. odczytując nazwy plików z katalogu. Pamiętaj, aby obsługiwać wyjątki dla każdego pliku, aby jeden niepoprawny plik nie przerwał całej partii. + +- **Czy biblioteka obsługuje Java 11+?** + Tak, bieżąca wersja 23.12 jest przeznaczona dla Java 8 i wyższych, więc jesteś bezpieczny na nowoczesnych środowiskach uruchomieniowych. + +- **Problemy z licencją?** + Jeśli używasz wersji próbnej dłużej niż 30 dni, wygenerowany PDF będzie zawierał znak wodny. Zastosuj plik licencji wcześnie w metodzie `main`: + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## Podsumowanie + +Masz teraz solidne, gotowe do produkcji rozwiązanie dla **jak przekonwertować plik HTML na PDF** przy użyciu Aspose.HTML w Javie. Od konfiguracji projektu Maven po obsługę lokalnych zasobów i dostrajanie opcji strony, przewodnik pokrył wszystko, co potrzebujesz, aby **tworzyć PDF z HTML w Javie** i **konwertować lokalny plik HTML na PDF** bez narzędzi wiersza poleceń firm trzecich. + +Co dalej? Spróbuj dodać nagłówki/stopki, zaszyfrować PDF lub zintegrować ten konwerter z endpointem REST Spring Boot, aby klienci mogli przesyłać HTML i otrzymywać PDF w locie. Możliwości są nieograniczone, a podstawowy wzorzec pozostaje taki sam. + +Masz pytania lub chcesz podzielić się sprytnym trikiem? zostaw komentarz poniżej – miłego kodowania! + +## Co powinieneś nauczyć się dalej? + +Poniższe samouczki obejmują ściśle powiązane tematy, które rozwijają techniki przedstawione w tym przewodniku. Każdy zasób zawiera kompletny, działający kod wraz z wyjaśnieniami krok po kroku, aby pomóc Ci opanować dodatkowe funkcje API i odkrywać alternatywne podejścia implementacyjne w własnych projektach. + +- [Konwertowanie HTML na PDF w Javie – Konfiguracja środowiska w Aspose.HTML](/html/english/java/configuring-environment/) +- [Tworzenie PDF z HTML – Ustawianie arkusza stylów użytkownika w Aspose.HTML dla Java](/html/english/java/configuring-environment/set-user-style-sheet/) +- [Ustaw rozmiar strony PDF – Konwertowanie HTML na PDF w Javie](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/portuguese/java/conversion-html-to-other-formats/_index.md b/html/portuguese/java/conversion-html-to-other-formats/_index.md index 7a450e1460..bf4a82faae 100644 --- a/html/portuguese/java/conversion-html-to-other-formats/_index.md +++ b/html/portuguese/java/conversion-html-to-other-formats/_index.md @@ -98,6 +98,8 @@ Aprenda como converter SVG para imagens em Java com Aspose.HTML. Guia abrangente Converta SVG para PDF em Java com Aspose.HTML. Uma solução fluida para conversão de documentos de alta qualidade. ### [Convertendo SVG para XPS](./convert-svg-to-xps/) Aprenda como converter SVG para XPS com Aspose.HTML for Java. Guia simples, passo a passo, para conversões sem complicações. +### [Como Converter Arquivo HTML para PDF em Java – Guia Completo](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) +Aprenda passo a passo a converter arquivos HTML em PDFs usando Aspose.HTML for Java, com configurações avançadas e exemplos completos. ## Perguntas Frequentes diff --git a/html/portuguese/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/portuguese/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..8e48a5a455 --- /dev/null +++ b/html/portuguese/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,246 @@ +--- +category: general +date: 2026-07-21 +description: Como converter um arquivo HTML em PDF usando Aspose.HTML em Java. Aprenda + passo a passo a criar PDF a partir de HTML em Java e lidar com arquivos locais. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: pt +lastmod: 2026-07-21 +og_description: Como converter um arquivo HTML em PDF com Aspose.HTML em Java. Siga + este guia para criar PDF a partir de HTML em Java, manipulando arquivos locais sem + esforço. +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: Como Converter Arquivo HTML para PDF em Java – Método Rápido e Confiável +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: Como Converter Arquivo HTML para PDF em Java – Guia Completo +url: /pt/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Como Converter Arquivo HTML para PDF em Java – Guia Completo + +Já se perguntou **como converter arquivo HTML para PDF** sem lutar com ferramentas de linha de comando ou soluções complicadas? Você não está sozinho. Em muitos projetos centrados na web – pense em relatórios automatizados, geração de faturas ou arquivamento de sites estáticos – transformar uma página HTML em um PDF nítido é uma necessidade diária. + +A boa notícia? Com Aspose.HTML for Java você pode fazer isso em apenas algumas linhas de código. Este tutorial orienta você a criar PDF a partir de HTML em Java, cobrindo tudo, desde a configuração do projeto até o tratamento de casos extremos, como recursos ausentes. + +## Pré-requisitos e o que você vai construir + +Antes de mergulharmos, certifique‑se de que você tem: + +- JDK 17 ou mais recente (a versão LTS mais recente funciona melhor) +- Maven 3.8+ (ou Gradle, se preferir) +- Uma licença Aspose.HTML for Java (uma avaliação gratuita serve para testes) +- Um simples arquivo `input.html` localizado em um diretório local + +Ao final deste guia, você terá um programa Java executável que **converte um arquivo HTML local para PDF**, pronto para ser inserido em qualquer serviço de backend. + +--- + +## Etapa 1: Configurar o Projeto Maven (Criar PDF a partir de HTML em Java) + +Primeiro, crie um novo projeto Maven. Se você já tem um `pom.xml`, basta adicionar a dependência Aspose.HTML: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **Dica profissional:** Mantenha seu `pom.xml` organizado; o Maven buscará as dependências transitivas automaticamente, então você não precisa procurar JARs extras. + +## Etapa 2: Escrever o Código de Conversão (Como Converter Arquivo HTML para PDF) + +Crie uma classe chamada `HtmlToPdfConverter`. O núcleo da conversão está em uma única chamada estática, mas vamos encapsulá‑la para clareza e tratamento de erros. + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### Por que isso funciona + +- **`Converter.convert`** abstrai o parsing, o tratamento de CSS e a incorporação de imagens. Você não precisa gerenciar um motor de renderização. +- O método lança **`ConverterException`**, oferecendo uma forma limpa de reagir a arquivos ausentes, HTML malformado ou problemas de licença. +- Ao isolar a lógica em `convert`, você pode reutilizá‑la em micro‑serviços, jobs em lote ou até mesmo em uma ferramenta CLI simples. + +## Etapa 3: Executar a Aplicação (Criar PDF a partir de HTML em Java) + +Compile e execute o programa: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +Se tudo estiver configurado corretamente, você verá: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +Abra `output.pdf` – você deverá ver uma renderização fiel de `input.html`, incluindo estilos CSS, imagens e até conteúdo gerado por JavaScript (desde que seja estático no momento da conversão). + +## Etapa 4: Manipulando Recursos Locais (Converter Arquivo HTML Local para PDF) + +Frequentemente seu HTML referencia imagens, fontes ou arquivos CSS via caminhos relativos. Aspose.HTML resolve esses recursos automaticamente **se** a URI base estiver configurada corretamente. Como estamos fornecendo um caminho de arquivo, a biblioteca trata o diretório de `input.html` como a base. + +Se precisar converter uma string HTML em vez de um arquivo, especifique manualmente uma URI base: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **Atenção:** Esquecer a URI base causará imagens ausentes ou estilos quebrados, um erro comum ao **converter html para pdf java** pela primeira vez. + +## Etapa 5: Opções Avançadas (Ajuste fino da Conversão de HTML para PDF em Java) + +Aspose.HTML permite ajustar o tamanho da página, margens e até metadados do PDF: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +Essas configurações são úteis quando você precisa **converter arquivo html para pdf** para impressão ou conformidade (por exemplo, páginas ISO‑216 A4). + +![Ilustração de como converter arquivo html para pdf](image.png){.center alt="Ilustração de como converter arquivo html para pdf"} + +*O diagrama acima visualiza o fluxo: código Java → Aspose.HTML → saída PDF.* + +## Perguntas Frequentes e Casos Limite + +- **E se o HTML contiver fontes web externas?** + Aspose.HTML as baixará enquanto a máquina tiver acesso à internet. Para builds offline, agrupe as fontes localmente e faça referência a elas com um caminho relativo. + +- **Posso converter vários arquivos HTML em lote?** + Absolutamente. Envolva a chamada `convert` dentro de um loop, talvez lendo nomes de arquivos de um diretório. Lembre‑se de tratar exceções por arquivo para que um input com erro não interrompa todo o lote. + +- **A biblioteca suporta Java 11+?** + Sim, a versão atual 23.12 tem como alvo Java 8 e superior, portanto você está seguro em runtimes modernos. + +- **Problemas de licença?** + Se você usar a avaliação por mais de 30 dias, o PDF de saída conterá uma marca d'água. Aplique seu arquivo de licença cedo no `main`: + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +## Conclusão + +Agora você tem uma solução sólida e pronta para produção para **como converter arquivo HTML para PDF** usando Aspose.HTML em Java. Desde a configuração do projeto Maven até o tratamento de recursos locais e o ajuste de opções de página, o guia cobriu tudo o que você precisa para **criar PDF a partir de HTML em Java** e **converter arquivo HTML local para PDF** sem ferramentas de linha de comando de terceiros. + +O que vem a seguir? Experimente adicionar cabeçalhos/rodapés, criptografar o PDF ou integrar este conversor a um endpoint REST Spring Boot para que clientes possam enviar HTML e receber um PDF instantaneamente. As possibilidades são infinitas, e o padrão central permanece o mesmo. + +Tem perguntas ou quer compartilhar uma dica inteligente? Deixe um comentário abaixo – feliz codificação! + +## O que você deve aprender a seguir? + +Os tutoriais a seguir abordam tópicos estreitamente relacionados que expandem as técnicas demonstradas neste guia. Cada recurso inclui exemplos de código completos e funcionais com explicações passo a passo para ajudá‑lo a dominar recursos adicionais da API e explorar abordagens de implementação alternativas em seus próprios projetos. + +- [Converter HTML para PDF Java – Configurando o Ambiente no Aspose.HTML](/html/english/java/configuring-environment/) +- [Criar PDF a partir de HTML – Definir Folha de Estilo do Usuário no Aspose.HTML para Java](/html/english/java/configuring-environment/set-user-style-sheet/) +- [Definir Tamanho da Página PDF - Converter HTML para PDF em Java](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/russian/java/conversion-html-to-other-formats/_index.md b/html/russian/java/conversion-html-to-other-formats/_index.md index 7a599423a5..eb7932c889 100644 --- a/html/russian/java/conversion-html-to-other-formats/_index.md +++ b/html/russian/java/conversion-html-to-other-formats/_index.md @@ -87,6 +87,9 @@ Aspose.HTML for Java упрощает процесс конвертации HTML ### [Конвертация HTML в PDF](./convert-html-to-pdf/) Узнайте, как конвертировать HTML в PDF в Java с помощью Aspose.HTML. Создавайте высококачественные PDF из вашего HTML‑контента без усилий. +### [Как конвертировать HTML‑файл в PDF в Java – Полное руководство](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) +Подробное пошаговое руководство по конвертации HTML‑файла в PDF в Java с использованием Aspose.HTML, включая настройки и оптимизацию. + ### [Конвертация HTML в MHTML](./convert-html-to-mhtml/) Легко конвертируйте HTML в MHTML с помощью Aspose.HTML for Java. Следуйте нашему пошаговому руководству для эффективной конвертации HTML в MHTML. diff --git a/html/russian/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/russian/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..8ee0ecf412 --- /dev/null +++ b/html/russian/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-07-21 +description: Как конвертировать HTML‑файл в PDF с помощью Aspose.HTML в Java. Узнайте + пошагово, как создать PDF из HTML в Java и работать с локальными файлами. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: ru +lastmod: 2026-07-21 +og_description: Как конвертировать HTML‑файл в PDF с помощью Aspose.HTML в Java. Следуйте + этому руководству, чтобы создать PDF из HTML в Java, легко работая с локальными + файлами. +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: Как конвертировать HTML‑файл в PDF на Java – быстрый, надёжный метод +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: Как конвертировать HTML‑файл в PDF на Java – Полное руководство +url: /ru/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Как конвертировать HTML файл в PDF на Java – Полное руководство + +Когда‑нибудь задумывались **как конвертировать HTML файл в PDF** без борьбы с инструментами командной строки или громоздкими обходными решениями? Вы не одиноки. Во многих веб‑ориентированных проектах — например, автоматизированные отчёты, генерация счетов или архивирование статических сайтов — преобразование HTML‑страницы в чёткий PDF является ежедневной потребностью. + +Хорошие новости? С Aspose.HTML for Java вы можете сделать это всего в несколько строк кода. Этот учебник проведёт вас через процесс создания PDF из HTML на Java, охватывая всё от настройки проекта до обработки краевых случаев, таких как отсутствующие ресурсы. + +## Предварительные требования и что вы создадите + +- JDK 17 или новее (последняя LTS‑версия работает лучше всего) +- Maven 3.8+ (или Gradle, если предпочитаете) +- Лицензия Aspose.HTML for Java (бесплатная пробная версия подходит для тестирования) +- Простой файл `input.html`, находящийся в локальном каталоге + +К концу этого руководства у вас будет исполняемая Java‑программа, которая **конвертирует локальный HTML файл в PDF**, готовая к интеграции в любой бэкенд‑сервис. + +--- + +## Шаг 1: Настройка Maven‑проекта (Создание PDF из HTML на Java) + +Сначала создайте новый Maven‑проект. Если у вас уже есть `pom.xml`, просто добавьте зависимость Aspose.HTML: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **Совет:** Держите ваш `pom.xml` в порядке; Maven автоматически подтянет транзитивные зависимости, так что вам не придётся искать дополнительные JAR‑файлы. + +## Шаг 2: Написание кода конвертации (Как конвертировать HTML файл в PDF) + +Создайте класс с именем `HtmlToPdfConverter`. Основная часть конвертации находится в едином статическом вызове, но мы обернём её для ясности и обработки ошибок. + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### Почему это работает + +- **`Converter.convert`** абстрагирует парсинг, обработку CSS и встраивание изображений. Вам не нужно самостоятельно управлять движком рендеринга. +- Метод бросает **`ConverterException`**, предоставляя чистый способ реагировать на отсутствующие файлы, некорректный HTML или проблемы с лицензией. +- Изолируя логику в `convert`, вы можете переиспользовать её в микросервисах, пакетных заданиях или даже в простом CLI‑инструменте. + +## Шаг 3: Запуск приложения (Создание PDF из HTML на Java) + +Скомпилируйте и выполните программу: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +Если всё настроено правильно, вы увидите: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +Откройте `output.pdf` — вы должны увидеть точную отрисовку `input.html`, включая стили CSS, изображения и даже контент, сгенерированный JavaScript (при условии, что он статичен во время конвертации). + +## Шаг 4: Обработка локальных ресурсов (Конвертировать локальный HTML файл в PDF) + +Часто ваш HTML ссылается на изображения, шрифты или CSS‑файлы через относительные пути. Aspose.HTML разрешает их автоматически **если** базовый URI установлен правильно. Поскольку мы передаём путь к файлу, библиотека рассматривает каталог `input.html` как базовый. + +Если вам нужно конвертировать строку HTML вместо файла, укажите базовый URI вручную: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **Внимание:** Забвение базового URI приведёт к отсутствию изображений или сломанным стилям, что является распространённой ошибкой при первом использовании **convert html to pdf java**. + +## Шаг 5: Расширенные параметры (Тонкая настройка Convert HTML to PDF Java) + +Aspose.HTML позволяет настроить размер страницы, отступы и даже метаданные PDF: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +Эти настройки удобны, когда вам нужно **convert html file to pdf** для печати или соответствия требованиям (например, страницы ISO‑216 A4). + +--- + +![Иллюстрация как конвертировать html файл в pdf](image.png){.center alt="Иллюстрация как конвертировать html файл в pdf"} + +*Диаграмма выше визуализирует поток: Java‑код → Aspose.HTML → PDF‑вывод.* + +## Часто задаваемые вопросы и краевые случаи + +- **Что если HTML содержит внешние веб‑шрифты?** + Aspose.HTML загрузит их, пока у машины есть доступ к интернету. Для офлайн‑сборок упакуйте шрифты локально и указывайте их относительным путём. + +- **Можно ли конвертировать несколько HTML файлов пакетно?** + Конечно. Оберните вызов `convert` в цикл, возможно, читая имена файлов из каталога. Не забудьте обрабатывать исключения для каждого файла, чтобы один плохой ввод не прервал всю партию. + +- **Поддерживает ли библиотека Java 11+?** + Да, текущий релиз 23.12 ориентирован на Java 8 и выше, так что вы в безопасности на современных средах выполнения. + +- **Проблемы с лицензией?** + Если вы используете пробную версию более 30 дней, в выходном PDF будет водяной знак. Примените файл лицензии в начале `main`: + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## Заключение + +Теперь у вас есть надёжное, готовое к продакшну решение для **how to convert HTML file to PDF** с использованием Aspose.HTML в Java. От настройки Maven‑проекта до обработки локальных ресурсов и настройки параметров страницы, руководство охватило всё, что нужно для **create PDF from HTML in Java** и **convert local HTML file to PDF** без сторонних инструментов командной строки. + +Что дальше? Попробуйте добавить заголовки/нижние колонтитулы, зашифровать PDF или интегрировать этот конвертер в REST‑endpoint Spring Boot, чтобы клиенты могли загружать HTML и мгновенно получать PDF. Возможности безграничны, а основной шаблон остаётся тем же. + +Есть вопросы или хотите поделиться хитрым трюком? Оставьте комментарий ниже — happy coding! + +## Что стоит изучить дальше? + +Следующие учебники охватывают тесно связанные темы, построенные на техниках, продемонстрированных в этом руководстве. Каждый ресурс включает полностью работающие примеры кода с пошаговыми объяснениями, чтобы помочь вам освоить дополнительные возможности API и исследовать альтернативные подходы к реализации в ваших проектах. + +- [Конвертировать HTML в PDF на Java – Настройка окружения в Aspose.HTML](/html/english/java/configuring-environment/) +- [Создать PDF из HTML – Установить пользовательскую таблицу стилей в Aspose.HTML для Java](/html/english/java/configuring-environment/set-user-style-sheet/) +- [Установить размер страницы PDF — Конвертировать HTML в PDF на Java](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/spanish/java/conversion-html-to-other-formats/_index.md b/html/spanish/java/conversion-html-to-other-formats/_index.md index 5c04b8250e..863c17e2ee 100644 --- a/html/spanish/java/conversion-html-to-other-formats/_index.md +++ b/html/spanish/java/conversion-html-to-other-formats/_index.md @@ -84,6 +84,8 @@ En conclusión, dominar **html to pdf java** y el conjunto más amplio de conver ## Conversión - HTML a Otros Formatos Tutoriales ### [Conversión de HTML a PDF](./convert-html-to-pdf/) ### [Convertir HTML a PDF en Java – Guía paso a paso con configuración de tamaño de página](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) +### [Cómo convertir un archivo HTML a PDF en Java – Guía completa](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) +Aprende paso a paso a convertir archivos HTML a PDF en Java usando Aspose.HTML, con ejemplos y mejores prácticas. ### [Conversión de HTML a MHTML](./convert-html-to-mhtml/) Convierte HTML a MHTML de forma sencilla con Aspose.HTML para Java. Sigue nuestra guía paso a paso para una conversión eficiente de HTML a MHTML. ### [Conversión de HTML a XPS](./convert-html-to-xps/) diff --git a/html/spanish/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/spanish/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..4345ede807 --- /dev/null +++ b/html/spanish/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-07-21 +description: Cómo convertir un archivo HTML a PDF usando Aspose.HTML en Java. Aprende + paso a paso a crear PDF a partir de HTML en Java y manejar archivos locales. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: es +lastmod: 2026-07-21 +og_description: Cómo convertir un archivo HTML a PDF con Aspose.HTML en Java. Sigue + esta guía para crear PDF a partir de HTML en Java, manejando archivos locales sin + esfuerzo. +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: Cómo convertir un archivo HTML a PDF en Java – método rápido y fiable +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: Cómo convertir un archivo HTML a PDF en Java – Guía completa +url: /es/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cómo convertir un archivo HTML a PDF en Java – Guía completa + +¿Alguna vez te has preguntado **cómo convertir un archivo HTML a PDF** sin luchar con herramientas de línea de comandos o soluciones complicadas? No eres el único. En muchos proyectos centrados en la web – piensa en generación automática de informes, facturación o archivado de sitios estáticos – convertir una página HTML en un PDF nítido es una necesidad diaria. + +¿La buena noticia? Con Aspose.HTML for Java puedes hacerlo en solo unas pocas líneas de código. Este tutorial te guía paso a paso para crear PDF a partir de HTML en Java, cubriendo todo desde la configuración del proyecto hasta el manejo de casos límite como recursos faltantes. + +## Requisitos previos y lo que construirás + +Antes de sumergirnos, asegúrate de tener: + +- JDK 17 o superior (la última versión LTS funciona mejor) +- Maven 3.8+ (o Gradle si lo prefieres) +- Una licencia de Aspose.HTML for Java (una prueba gratuita sirve para pruebas) +- Un archivo `input.html` sencillo ubicado en un directorio local + +Al final de esta guía tendrás un programa Java ejecutable que **convierte un archivo HTML local a PDF**, listo para integrarse en cualquier servicio backend. + +--- + +## Paso 1: Configurar el proyecto Maven (Crear PDF a partir de HTML en Java) + +Primero, crea un nuevo proyecto Maven. Si ya tienes un `pom.xml`, simplemente agrega la dependencia de Aspose.HTML: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **Consejo profesional:** Mantén tu `pom.xml` ordenado; Maven descargará automáticamente las dependencias transitivas, así que no necesitas buscar JARs adicionales. + +## Paso 2: Escribir el código de conversión (Cómo convertir un archivo HTML a PDF) + +Crea una clase llamada `HtmlToPdfConverter`. El núcleo de la conversión se encuentra en una única llamada estática, pero la envolveremos para mayor claridad y manejo de errores. + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### Por qué funciona + +- **`Converter.convert`** abstrae el análisis, el manejo de CSS y la incrustación de imágenes. No tienes que gestionar un motor de renderizado tú mismo. +- El método lanza **`ConverterException`**, brindándote una forma clara de reaccionar ante archivos faltantes, HTML mal formado o problemas de licencia. +- Al aislar la lógica en `convert`, puedes reutilizarla en micro‑servicios, trabajos por lotes o incluso en una herramienta CLI sencilla. + +## Paso 3: Ejecutar la aplicación (Crear PDF a partir de HTML en Java) + +Compila y ejecuta el programa: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +Si todo está configurado correctamente, verás: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +Abre `output.pdf` – deberías ver una representación fiel de `input.html`, incluyendo estilos CSS, imágenes e incluso contenido generado por JavaScript (siempre que sea estático en el momento de la conversión). + +## Paso 4: Manejo de recursos locales (Convertir archivo HTML local a PDF) + +A menudo tu HTML hace referencia a imágenes, fuentes o archivos CSS mediante rutas relativas. Aspose.HTML los resuelve automáticamente **si** la URI base está configurada correctamente. Como estamos proporcionando una ruta de archivo, la biblioteca trata el directorio de `input.html` como la base. + +Si necesitas convertir una cadena HTML en lugar de un archivo, especifica manualmente una URI base: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **Cuidado:** Olvidar la URI base provocará imágenes faltantes o estilos rotos, una trampa común al **convertir html a pdf java** por primera vez. + +## Paso 5: Opciones avanzadas (Ajuste fino de Convertir HTML a PDF en Java) + +Aspose.HTML te permite ajustar el tamaño de página, los márgenes e incluso los metadatos del PDF: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +--- + +![Cómo convertir un archivo html a pdf ilustración](image.png){.center alt="Cómo convertir un archivo html a pdf ilustración"} + +*El diagrama anterior visualiza el flujo: código Java → Aspose.HTML → salida PDF.* + +## Preguntas frecuentes y casos límite + +- **¿Qué pasa si el HTML contiene fuentes web externas?** + Aspose.HTML las descargará siempre que la máquina tenga acceso a internet. Para compilaciones sin conexión, empaqueta las fuentes localmente y haz referencia a ellas con una ruta relativa. + +- **¿Puedo convertir varios archivos HTML en lote?** + Por supuesto. Envuelve la llamada `convert` dentro de un bucle, quizás leyendo los nombres de archivo de un directorio. Recuerda manejar excepciones por archivo para que una entrada incorrecta no aborta todo el lote. + +- **¿La biblioteca soporta Java 11+?** + Sí, la versión actual 23.12 está dirigida a Java 8 y superiores, por lo que estás seguro en entornos modernos. + +- **¿Problemas de licencia?** + Si ejecutas la prueba por más de 30 días, el PDF de salida contendrá una marca de agua. Aplica tu archivo de licencia al inicio de `main`: + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## Conclusión + +Ahora tienes una solución sólida y lista para producción para **cómo convertir un archivo HTML a PDF** usando Aspose.HTML en Java. Desde la configuración del proyecto Maven hasta el manejo de recursos locales y el ajuste de opciones de página, la guía cubrió todo lo que necesitas para **crear PDF a partir de HTML en Java** y **convertir un archivo HTML local a PDF** sin herramientas de línea de comandos de terceros. + +¿Qué sigue? Prueba a añadir encabezados/pies de página, encriptar el PDF, o integrar este conversor en un endpoint REST de Spring Boot para que los clientes puedan subir HTML y recibir un PDF al instante. Las posibilidades son infinitas, y el patrón central sigue siendo el mismo. + +¿Tienes preguntas o quieres compartir un truco ingenioso? Deja un comentario abajo – ¡feliz codificación! + +## ¿Qué deberías aprender a continuación? + +Los siguientes tutoriales cubren temas estrechamente relacionados que amplían las técnicas demostradas en esta guía. Cada recurso incluye ejemplos de código completos y funcionales con explicaciones paso a paso para ayudarte a dominar características adicionales de la API y explorar enfoques de implementación alternativos en tus propios proyectos. + +- [Convertir HTML a PDF Java – Configuración del entorno en Aspose.HTML](/html/english/java/configuring-environment/) +- [Crear PDF a partir de HTML – Establecer hoja de estilo de usuario en Aspose.HTML para Java](/html/english/java/configuring-environment/set-user-style-sheet/) +- [Establecer tamaño de página PDF - Convertir HTML a PDF en Java](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/swedish/java/conversion-html-to-other-formats/_index.md b/html/swedish/java/conversion-html-to-other-formats/_index.md index 91c83a46f3..733cb55642 100644 --- a/html/swedish/java/conversion-html-to-other-formats/_index.md +++ b/html/swedish/java/conversion-html-to-other-formats/_index.md @@ -98,6 +98,8 @@ Konvertera SVG till PDF i Java med Aspose.HTML. En sömlös lösning för högkv Lär dig hur du konverterar SVG till XPS med Aspose.HTML for Java. Enkel, steg‑för‑steg‑guide för smidiga konverteringar. ### [Konvertera HTML till PDF i Java – Steg‑för‑steg‑guide med sidstorleksinställningar](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) Lär dig konvertera HTML till PDF i Java med detaljerade steg och anpassa sidstorlek för optimal utskrift. +### [Hur du konverterar HTML‑fil till PDF i Java – Komplett guide](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) +Lär dig steg‑för‑steg hur du konverterar en HTML‑fil till PDF i Java med Aspose.HTML, inklusive kodexempel och bästa praxis. ## Vanliga frågor diff --git a/html/swedish/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/swedish/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..2f1353ee51 --- /dev/null +++ b/html/swedish/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,250 @@ +--- +category: general +date: 2026-07-21 +description: Hur man konverterar HTML‑fil till PDF med Aspose.HTML i Java. Lär dig + steg för steg att skapa PDF från HTML i Java och hantera lokala filer. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: sv +lastmod: 2026-07-21 +og_description: Hur man konverterar en HTML-fil till PDF med Aspose.HTML i Java. Följ + den här guiden för att skapa PDF från HTML i Java och hantera lokala filer utan + ansträngning. +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: Hur du konverterar en HTML‑fil till PDF i Java – Snabb, pålitlig metod +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: Hur man konverterar HTML‑fil till PDF i Java – Komplett guide +url: /sv/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Hur man konverterar HTML‑fil till PDF i Java – Komplett guide + +Har du någonsin undrat **hur man konverterar HTML‑fil till PDF** utan att kämpa med kommandoradsverktyg eller röriga lösningar? Du är inte ensam. I många webbcentrerade projekt – tänk automatiserad rapportering, fakturagenerering eller arkivering av statiska webbplatser – är det ett dagligt behov att omvandla en HTML‑sida till en skarp PDF. + +Den goda nyheten? Med Aspose.HTML för Java kan du göra det på bara några rader kod. Denna handledning guidar dig genom att skapa PDF från HTML i Java, och täcker allt från projektuppsättning till hantering av kantfall som saknade resurser. + +## Förutsättningar & Vad du kommer att bygga + +Innan vi dyker ner, se till att du har: + +- JDK 17 eller nyare (den senaste LTS‑versionen fungerar bäst) +- Maven 3.8+ (eller Gradle om du föredrar) +- En Aspose.HTML för Java‑licens (en gratis provversion fungerar för testning) +- En enkel `input.html`‑fil som ligger i en lokal katalog + +I slutet av den här guiden har du ett körbart Java‑program som **konverterar en lokal HTML‑fil till PDF**, redo att integreras i någon backend‑tjänst. + +--- + +## Steg 1: Ställ in Maven‑projektet (Skapa PDF från HTML i Java) + +Först, skapa ett nytt Maven‑projekt. Om du redan har en `pom.xml`, lägg bara till Aspose.HTML‑beroendet: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **Proffstips:** Håll din `pom.xml` prydlig; Maven hämtar de transitiva beroendena automatiskt, så du behöver inte leta efter extra JAR‑filer. + +## Steg 2: Skriv konverteringskoden (Hur man konverterar HTML‑fil till PDF) + +Skapa en klass med namnet `HtmlToPdfConverter`. Kärnan i konverteringen finns i ett enda statiskt anrop, men vi kommer att omsluta det för tydlighet och felhantering. + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### Varför detta fungerar + +- **`Converter.convert`** abstraherar bort parsning, CSS‑hantering och bildinbäddning. Du behöver inte hantera en renderingsmotor själv. +- Metoden kastar **`ConverterException`**, vilket ger dig ett rent sätt att reagera på saknade filer, felaktig HTML eller licensproblem. +- Genom att isolera logiken i `convert` kan du återanvända den över mikrotjänster, batch‑jobb eller till och med ett enkelt CLI‑verktyg. + +## Steg 3: Kör applikationen (Skapa PDF från HTML i Java) + +Kompilera och kör programmet: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +Om allt är korrekt konfigurerat kommer du att se: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +Öppna `output.pdf` – du bör se en trogen återgivning av `input.html`, inklusive CSS‑stilar, bilder och även JavaScript‑genererat innehåll (så länge det är statiskt vid konverteringstillfället). + +## Steg 4: Hantera lokala resurser (Konvertera lokal HTML‑fil till PDF) + +Ofta refererar din HTML till bilder, typsnitt eller CSS‑filer via relativa sökvägar. Aspose.HTML löser dem automatiskt **om** bas‑URI:n är korrekt inställd. Eftersom vi matar in en filsökväg behandlar biblioteket katalogen för `input.html` som bas. + +Om du behöver konvertera en HTML‑sträng istället för en fil, ange en bas‑URI manuellt: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **Varning:** Att glömma bas‑URI:n kommer att leda till saknade bilder eller trasiga stilar, ett vanligt fallgropp när du **konverterar html till pdf java** för första gången. + +## Steg 5: Avancerade alternativ (Finjustera konvertering av HTML till PDF i Java) + +Aspose.HTML låter dig justera sidstorlek, marginaler och till och med PDF‑metadata: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +Dessa inställningar är praktiska när du behöver **konvertera html‑fil till pdf** för utskrift eller efterlevnad (t.ex. ISO‑216 A4‑sidor). + +--- + +![Illustration av hur man konverterar html‑fil till pdf](image.png){.center alt="Illustration av hur man konverterar html‑fil till pdf"} + +*Diagrammet ovan visualiserar flödet: Java‑kod → Aspose.HTML → PDF‑utdata.* + +## Vanliga frågor & kantfall + +- **Vad händer om HTML innehåller externa webbtypsnitt?** + Aspose.HTML kommer att ladda ner dem så länge maskinen har internetåtkomst. För offline‑byggnader, paketera typsnitten lokalt och referera dem med en relativ sökväg. + +- **Kan jag konvertera flera HTML‑filer i ett batch‑jobb?** + Absolut. Omslut `convert`‑anropet i en loop, kanske genom att läsa filnamn från en katalog. Kom ihåg att hantera undantag per fil så att en dålig inmatning inte avbryter hela batchen. + +- **Stöder biblioteket Java 11+?** + Ja, den nuvarande 23.12‑utgåvan riktar sig mot Java 8 och senare, så du är säker på moderna runtime‑miljöer. + +- **Licensproblem?** + Om du kör provversionen längre än 30 dagar kommer den genererade PDF‑filen att innehålla ett vattenstämpel. Applicera din licensfil tidigt i `main`: + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## Slutsats + +Du har nu en solid, produktionsklar lösning för **hur man konverterar HTML‑fil till PDF** med Aspose.HTML i Java. Från att sätta upp Maven‑projektet till att hantera lokala resurser och finjustera sidinställningar, har guiden täckt allt du behöver för att **skapa PDF från HTML i Java** och **konvertera lokal HTML‑fil till PDF** utan tredjeparts‑kommandoradsverktyg. + +Vad blir nästa steg? Prova att lägga till sidhuvuden/sidfötter, kryptera PDF‑filen, eller integrera denna konverterare i en Spring Boot‑REST‑endpoint så att klienter kan ladda upp HTML och få en PDF direkt. Möjligheterna är oändliga, och huvudmönstret förblir detsamma. + +Har du frågor eller vill dela med dig av ett smart knep? Lämna en kommentar nedan – lycka till med kodningen! + +## Vad bör du lära dig härnäst? + +Följande handledningar täcker närbesläktade ämnen som bygger på teknikerna som demonstrerats i den här guiden. Varje resurs innehåller kompletta fungerande kodexempel med steg‑för‑steg‑förklaringar för att hjälpa dig bemästra ytterligare API‑funktioner och utforska alternativa implementationsmetoder i dina egna projekt. + +- [Konvertera HTML till PDF Java – Konfigurera miljö i Aspose.HTML](/html/english/java/configuring-environment/) +- [Skapa PDF från HTML – Ange användar‑stilmall i Aspose.HTML för Java](/html/english/java/configuring-environment/set-user-style-sheet/) +- [Ställ in PDF‑sidstorlek – Konvertera HTML till PDF i Java](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/thai/java/conversion-html-to-other-formats/_index.md b/html/thai/java/conversion-html-to-other-formats/_index.md index aa3e49be5d..a3d00cec11 100644 --- a/html/thai/java/conversion-html-to-other-formats/_index.md +++ b/html/thai/java/conversion-html-to-other-formats/_index.md @@ -107,6 +107,7 @@ Aspose.HTML for Java ทำให้กระบวนการแปลง HTML แปลง SVG เป็น PDF ใน Java ด้วย Aspose.HTML โซลูชันที่ไร้รอยต่อสำหรับการแปลงเอกสารคุณภาพสูง ### [Converting SVG to XPS](./convert-svg-to-xps/) เรียนรู้วิธีแปลง SVG เป็น XPS ด้วย Aspose.HTML for Java คู่มือขั้นตอน‑ต่อ‑ขั้นตอนที่ง่ายสำหรับการแปลงที่ไร้รอยต่อ +### [วิธีแปลงไฟล์ HTML เป็น PDF ใน Java – คู่มือครบถ้วน](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) ## คำถามที่พบบ่อย diff --git a/html/thai/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/thai/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..251a73c8ed --- /dev/null +++ b/html/thai/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,249 @@ +--- +category: general +date: 2026-07-21 +description: วิธีแปลงไฟล์ HTML เป็น PDF ด้วย Aspose.HTML ใน Java เรียนรู้ขั้นตอนการสร้าง + PDF จาก HTML ใน Java และจัดการไฟล์ในเครื่อง +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: th +lastmod: 2026-07-21 +og_description: วิธีแปลงไฟล์ HTML เป็น PDF ด้วย Aspose.HTML ใน Java. ปฏิบัติตามคำแนะนำนี้เพื่อสร้าง + PDF จาก HTML ใน Java โดยจัดการไฟล์ในเครื่องได้อย่างง่ายดาย. +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: วิธีแปลงไฟล์ HTML เป็น PDF ใน Java – วิธีที่เร็วและเชื่อถือได้ +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: วิธีแปลงไฟล์ HTML เป็น PDF ใน Java – คู่มือครบถ้วน +url: /th/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# วิธีแปลงไฟล์ HTML เป็น PDF ใน Java – คู่มือฉบับสมบูรณ์ + +เคยสงสัย **วิธีแปลงไฟล์ HTML เป็น PDF** โดยไม่ต้องต่อสู้กับเครื่องมือบรรทัดคำสั่งหรือวิธีแก้ปัญหาที่ยุ่งยากหรือไม่? คุณไม่ได้เป็นคนเดียว ในหลายโครงการที่เน้นเว็บ – เช่น การสร้างรายงานอัตโนมัติ, การสร้างใบแจ้งหนี้, หรือการเก็บสำเนาเว็บไซต์แบบคงที่ – การแปลงหน้า HTML ให้เป็น PDF ที่คมชัดเป็นความต้องการประจำวัน + +ข่าวดีคือ? ด้วย Aspose.HTML for Java คุณสามารถทำได้ด้วยเพียงไม่กี่บรรทัดของโค้ด บทเรียนนี้จะพาคุณผ่านการสร้าง PDF จาก HTML ใน Java ครอบคลุมทุกอย่างตั้งแต่การตั้งค่าโครงการจนถึงการจัดการกรณีขอบเช่นทรัพยากรที่หายไป + +## ข้อกำหนดเบื้องต้นและสิ่งที่คุณจะสร้าง + +ก่อนที่เราจะดำเนินการต่อ ให้ตรวจสอบว่าคุณมี: + +- JDK 17 หรือใหม่กว่า (เวอร์ชัน LTS ล่าสุดทำงานได้ดีที่สุด) +- Maven 3.8+ (หรือ Gradle หากคุณต้องการ) +- ไลเซนส์ Aspose.HTML for Java (รุ่นทดลองฟรีใช้สำหรับการทดสอบ) +- ไฟล์ `input.html` ง่าย ๆ ที่อยู่ในไดเรกทอรีท้องถิ่น + +เมื่อจบบทเรียนนี้ คุณจะมีโปรแกรม Java ที่สามารถรันได้ซึ่ง **แปลงไฟล์ HTML ท้องถิ่นเป็น PDF** พร้อมใช้งานในบริการแบ็กเอนด์ใด ๆ + +--- + +## ขั้นตอนที่ 1: ตั้งค่าโครงการ Maven (สร้าง PDF จาก HTML ใน Java) + +แรกเริ่ม สร้างโครงการ Maven ใหม่ หากคุณมีไฟล์ `pom.xml` อยู่แล้ว เพียงเพิ่ม dependency ของ Aspose.HTML: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **เคล็ดลับ:** รักษาไฟล์ `pom.xml` ของคุณให้เป็นระเบียบ; Maven จะดึง dependencies ที่เป็น transitive โดยอัตโนมัติ ดังนั้นคุณไม่จำเป็นต้องค้นหา JAR เพิ่มเติม + +## ขั้นตอนที่ 2: เขียนโค้ดการแปลง (วิธีแปลงไฟล์ HTML เป็น PDF) + +สร้างคลาสชื่อ `HtmlToPdfConverter` ส่วนหลักของการแปลงอยู่ในการเรียกแบบ static เพียงหนึ่งครั้ง แต่เราจะห่อหุ้มเพื่อความชัดเจนและการจัดการข้อผิดพลาด + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### ทำไมวิธีนี้ถึงได้ผล + +- **`Converter.convert`** แยกการทำงานของการพาร์ส, การจัดการ CSS, และการฝังรูปภาพออก คุณไม่ต้องจัดการ engine การเรนเดอร์ด้วยตนเอง +- เมธอดนี้จะโยน **`ConverterException`**, ให้วิธีที่สะอาดในการตอบสนองต่อไฟล์ที่หายไป, HTML ที่ผิดรูปแบบ, หรือปัญหาไลเซนส์ +- โดยการแยกตรรกะใน `convert` คุณสามารถนำกลับมาใช้ใหม่ได้ใน micro‑services, งาน batch, หรือแม้แต่เครื่องมือ CLI ง่าย ๆ + +## ขั้นตอนที่ 3: รันแอปพลิเคชัน (สร้าง PDF จาก HTML ใน Java) + +Compile and execute the program: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +If everything is set up correctly, you’ll see: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +เปิด `output.pdf` – คุณควรเห็นการเรนเดอร์ที่ตรงกับ `input.html` อย่างครบถ้วน รวมถึงสไตล์ CSS, รูปภาพ, และแม้แต่เนื้อหาที่สร้างโดย JavaScript (ตราบใดที่เป็นสถิตในขณะแปลง) + +## ขั้นตอนที่ 4: จัดการทรัพยากรในเครื่อง (แปลงไฟล์ HTML ในเครื่องเป็น PDF) + +บ่อยครั้ง HTML ของคุณอ้างอิงรูปภาพ, ฟอนต์, หรือไฟล์ CSS ผ่านเส้นทางสัมพันธ์ Aspose.HTML จะแก้ไขเหล่านั้นโดยอัตโนมัติ **ถ้า** base URI ถูกตั้งค่าอย่างถูกต้อง เนื่องจากเราจัดหาไฟล์พาธ ไลบรารีจะถือไดเรกทอรีของ `input.html` เป็นฐาน + +หากคุณต้องการแปลงสตริง HTML แทนไฟล์ ให้ระบุ base URI ด้วยตนเอง: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **ระวัง:** การลืมตั้งค่า base URI จะทำให้รูปภาพหายหรือสไตล์เสียหาย ซึ่งเป็นข้อผิดพลาดทั่วไปเมื่อ **convert html to pdf java** ครั้งแรก + +## ขั้นตอนที่ 5: ตัวเลือกขั้นสูง (ปรับแต่งการแปลง HTML เป็น PDF ใน Java) + +Aspose.HTML ให้คุณปรับขนาดหน้า, ระยะขอบ, และแม้แต่เมตาดาต้า PDF: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +การตั้งค่าเหล่านี้มีประโยชน์เมื่อคุณต้อง **convert html file to pdf** เพื่อการพิมพ์หรือการปฏิบัติตามมาตรฐาน (เช่น หน้า A4 ของ ISO‑216) + +--- + +![วิธีแปลงไฟล์ html เป็น pdf illustration](image.png){.center alt="วิธีแปลงไฟล์ html เป็น pdf illustration"} + +*แผนภาพด้านบนแสดงกระบวนการ: โค้ด Java → Aspose.HTML → ผลลัพธ์ PDF.* + +## คำถามทั่วไปและกรณีขอบ + +- **ถ้า HTML มีฟอนต์เว็บภายนอกจะเป็นอย่างไร?** + Aspose.HTML จะดาวน์โหลดฟอนต์เหล่านั้นตราบใดที่เครื่องมีการเชื่อมต่ออินเทอร์เน็ต สำหรับการสร้างแบบออฟไลน์ ให้รวมฟอนต์ไว้ในเครื่องและอ้างอิงด้วยเส้นทางสัมพันธ์ + +- **ฉันสามารถแปลงไฟล์ HTML หลายไฟล์เป็นชุดได้หรือไม่?** + ได้เลย. ห่อการเรียก `convert` ไว้ในลูป, อาจอ่านชื่อไฟล์จากไดเรกทอรี. อย่าลืมจัดการข้อยกเว้นสำหรับแต่ละไฟล์เพื่อไม่ให้ไฟล์ที่มีปัญหาหนึ่งไฟล์ทำให้การประมวลผลทั้งหมดหยุด + +- **ไลบรารีนี้รองรับ Java 11+ หรือไม่?** + ใช่, รุ่น 23.12 ปัจจุบันมุ่งเป้าไปที่ Java 8 ขึ้นไป, ดังนั้นคุณปลอดภัยบนรันไทม์สมัยใหม่ + +- **ปัญหาไลเซนส์?** + หากคุณใช้รุ่นทดลองเกิน 30 วัน, PDF ที่ได้จะมีลายน้ำ. ใส่ไฟล์ไลเซนส์ของคุณใน `main` ตั้งแต่ต้น: + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## สรุป + +ตอนนี้คุณมีโซลูชันที่มั่นคงและพร้อมใช้งานในระดับ production สำหรับ **วิธีแปลงไฟล์ HTML เป็น PDF** ด้วย Aspose.HTML ใน Java ตั้งแต่การตั้งค่าโครงการ Maven จนถึงการจัดการทรัพยากรในเครื่องและการปรับตัวเลือกของหน้า คู่มือนี้ครอบคลุมทุกอย่างที่คุณต้องการเพื่อ **สร้าง PDF จาก HTML ใน Java** และ **แปลงไฟล์ HTML ในเครื่องเป็น PDF** โดยไม่ต้องใช้เครื่องมือบรรทัดคำสั่งของบุคคลที่สาม + +ต่อไปคุณจะทำอะไร? ลองเพิ่มส่วนหัว/ส่วนท้าย, เข้ารหัส PDF, หรือผสานตัวแปลงนี้เข้ากับ endpoint REST ของ Spring Boot เพื่อให้ลูกค้าสามารถอัปโหลด HTML และรับ PDF ได้ทันที ความเป็นไปได้ไม่มีที่สิ้นสุดและรูปแบบหลักยังคงเหมือนเดิม + +มีคำถามหรืออยากแชร์เคล็ดลับ? ฝากคอมเมนต์ด้านล่าง – โค้ดอย่างสนุก! + +## คุณควรเรียนรู้อะไรต่อไป? + +บทเรียนต่อไปนี้ครอบคลุมหัวข้อที่เกี่ยวข้องอย่างใกล้ชิดซึ่งต่อยอดจากเทคนิคที่แสดงในคู่มือนี้ แต่ละแหล่งข้อมูลมีตัวอย่างโค้ดทำงานเต็มรูปแบบพร้อมคำอธิบายทีละขั้นตอนเพื่อช่วยให้คุณเชี่ยวชาญฟีเจอร์ API เพิ่มเติมและสำรวจแนวทางการทำงานทางเลือกในโครงการของคุณ + +- [แปลง HTML เป็น PDF Java – การกำหนดสภาพแวดล้อมใน Aspose.HTML](/html/english/java/configuring-environment/) +- [สร้าง PDF จาก HTML – ตั้งค่า User Style Sheet ใน Aspose.HTML สำหรับ Java](/html/english/java/configuring-environment/set-user-style-sheet/) +- [ตั้งค่าขนาดหน้ PDF - แปลง HTML เป็น PDF ใน Java](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/turkish/java/conversion-html-to-other-formats/_index.md b/html/turkish/java/conversion-html-to-other-formats/_index.md index b9af7690c4..a970c9fe99 100644 --- a/html/turkish/java/conversion-html-to-other-formats/_index.md +++ b/html/turkish/java/conversion-html-to-other-formats/_index.md @@ -99,6 +99,8 @@ Aspose.HTML ile Java'da SVG'yi görüntülere dönüştürmeyi öğrenin. Yükse Aspose.HTML ile Java'da SVG'yi PDF'ye dönüştürün. Yüksek kaliteli belge dönüşümü için sorunsuz bir çözüm. ### [SVG'yi XPS'ye Dönüştürme](./convert-svg-to-xps/) Aspose.HTML for Java ile SVG'yi XPS'ye dönüştürmeyi öğrenin. Sorunsuz dönüşümler için basit, adım adım rehber. +### [Java’da HTML Dosyasını PDF'ye Dönüştürme – Tam Kılavuz](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) +Java uygulamanızda HTML dosyalarını yüksek kaliteli PDF'lere dönüştürmek için adım adım rehber. ## Sıkça Sorulan Sorular diff --git a/html/turkish/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/turkish/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..49f2dee573 --- /dev/null +++ b/html/turkish/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,248 @@ +--- +category: general +date: 2026-07-21 +description: Java'da Aspose.HTML kullanarak HTML dosyasını PDF'ye nasıl dönüştürülür. + Java'da HTML'den PDF oluşturmayı adım adım öğrenin ve yerel dosyaları yönetin. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: tr +lastmod: 2026-07-21 +og_description: Java'da Aspose.HTML ile HTML dosyasını PDF'ye nasıl dönüştüreceğinizi + öğrenin. Java'da HTML'den PDF oluşturmak ve yerel dosyaları sorunsuz bir şekilde + işlemek için bu rehberi izleyin. +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: Java'da HTML Dosyasını PDF'e Dönüştürme – Hızlı, Güvenilir Yöntem +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: Java'da HTML Dosyasını PDF'e Dönüştürme – Tam Kılavuz +url: /tr/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Java’da HTML Dosyasını PDF’e Dönüştürme – Tam Kılavuz + +Komut satırı araçlarıyla uğraşmadan ya da karışık çözümlerle **HTML dosyasını PDF’e nasıl dönüştüreceğinizi** hiç merak ettiniz mi? Tek başınıza değilsiniz. Otomatik raporlama, fatura oluşturma ya da statik site arşivleme gibi web‑odaklı birçok projede, bir HTML sayfasını net bir PDF’e dönüştürmek günlük bir ihtiyaçtır. + +İyi haber? Aspose.HTML for Java ile bunu sadece birkaç satır kodla yapabilirsiniz. Bu öğretici, Java’da HTML’den PDF oluşturmayı, proje kurulumundan eksik kaynaklar gibi uç durumların ele alınmasına kadar her adımda size rehberlik ediyor. + +## Önkoşullar ve Oluşturacağınız Şey + +- JDK 17 veya daha yeni (en son LTS sürümü en iyisidir) +- Maven 3.8+ (ya da tercih ederseniz Gradle) +- Aspose.HTML for Java lisansı (test için ücretsiz deneme sürümü yeterli) +- Yerel bir dizinde bulunan basit bir `input.html` dosyası + +Bu rehberin sonunda, **yerel bir HTML dosyasını PDF’e dönüştüren** çalıştırılabilir bir Java programına sahip olacaksınız ve bu programı herhangi bir backend servisine kolayca ekleyebilirsiniz. + +--- + +## Adım 1: Maven Projesini Kurun (Java’da HTML’den PDF Oluşturma) + +İlk olarak, yeni bir Maven projesi oluşturun. Zaten bir `pom.xml` dosyanız varsa, sadece Aspose.HTML bağımlılığını ekleyin: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **Pro ipucu:** `pom.xml` dosyanızı düzenli tutun; Maven, geçişli bağımlılıkları otomatik olarak çekecek, bu yüzden ekstra JAR’ları aramanıza gerek kalmayacak. + +## Adım 2: Dönüştürme Kodunu Yazın (HTML Dosyasını PDF’e Nasıl Dönüştürürsünüz) + +`HtmlToPdfConverter` adlı bir sınıf oluşturun. Dönüştürmenin çekirdeği tek bir statik çağrıda yer alır, ancak açıklık ve hata yönetimi için bunu bir sarmalayıcı içine alacağız. + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### Bunun Neden Çalıştığı + +- **`Converter.convert`** ayrıştırma, CSS işleme ve resim gömme işlemlerini soyutlar. Kendiniz bir render motoru yönetmek zorunda kalmazsınız. +- Metod **`ConverterException`** fırlatır; bu sayede eksik dosyalar, hatalı HTML ya da lisans sorunlarına temiz bir şekilde yanıt verebilirsiniz. +- `convert` içinde mantığı izole ederek, mikro‑servisler, toplu işler ya da basit bir CLI aracı içinde yeniden kullanabilirsiniz. + +## Adım 3: Uygulamayı Çalıştırın (Java’da HTML’den PDF Oluşturma) + +Programı derleyin ve çalıştırın: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +Her şey doğru şekilde ayarlandıysa, şunu göreceksiniz: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +`output.pdf` dosyasını açın – `input.html` dosyasının CSS stilleri, resimler ve hatta JavaScript tarafından oluşturulan içerik (dönüştürme anında statik olduğu sürece) dahil olmak üzere eksiksiz bir renderını görmelisiniz. + +## Adım 4: Yerel Kaynakları Yönetme (Yerel HTML Dosyasını PDF’e Dönüştürme) + +HTML’niz genellikle resimleri, yazı tiplerini veya CSS dosyalarını göreli yollarla referans verir. Aspose.HTML, temel URI doğru ayarlandığında bunları otomatik olarak çözer. Dosya yolu sağladığımız için kütüphane, `input.html` dosyasının bulunduğu dizini temel olarak kabul eder. + +Eğer bir dosya yerine HTML dizesini dönüştürmeniz gerekiyorsa, temel URI’yi manuel olarak belirtin: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **Dikkat:** Temel URI’yi unutmak, eksik resimler veya bozuk stillere yol açar; bu, **convert html to pdf java** yaparken ilk kez karşılaşılan yaygın bir tuzaktır. + +## Adım 5: İleri Seçenekler (Java’da HTML’den PDF Dönüştürmeyi İnce Ayar Yapma) + +Aspose.HTML, sayfa boyutu, kenar boşlukları ve hatta PDF meta verilerini ayarlamanıza izin verir: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +Bu ayarlar, **convert html file to pdf** işlemini yazdırma veya uyumluluk (ör. ISO‑216 A4 sayfaları) amaçlarıyla yapmanız gerektiğinde kullanışlıdır. + +--- + +![HTML dosyasını PDF'e nasıl dönüştürülür illüstrasyonu](image.png){.center alt="HTML dosyasını PDF'e nasıl dönüştürülür illüstrasyonu"} + +*Yukarıdaki diyagram akışı görselleştirir: Java kodu → Aspose.HTML → PDF çıktısı.* + +## Yaygın Sorular ve Uç Durumlar + +- **HTML dış web fontları içeriyorsa ne olur?** + Aspose.HTML, makinenin internet erişimi olduğu sürece fontları indirir. Çevrim dışı derlemeler için fontları yerel olarak paketleyin ve göreli bir yol ile referans verin. + +- **Birden fazla HTML dosyasını toplu olarak dönüştürebilir miyim?** + Kesinlikle. `convert` çağrısını bir döngü içinde sarın, belki dosya adlarını bir dizinden okuyarak. Her dosya için istisnaları yakalamayı unutmayın; böylece tek bir hatalı girdi tüm toplu işlemi durdurmaz. + +- **Kütüphane Java 11+’ı destekliyor mu?** + Evet, mevcut 23.12 sürümü Java 8 ve üzerini hedefliyor, bu yüzden modern çalışma zamanlarında güvenle kullanabilirsiniz. + +- **Lisans sorunları?** + Deneme sürümünü 30 günden uzun süre çalıştırırsanız, çıktı PDF su işareti içerir. Lisans dosyanızı `main` içinde erken bir aşamada uygulayın: + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## Sonuç + +Artık Aspose.HTML kullanarak Java’da **HTML dosyasını PDF’e nasıl dönüştüreceğinizi** gösteren sağlam, üretim‑hazır bir çözümünüz var. Maven projesini kurmaktan yerel kaynakları yönetmeye ve sayfa seçeneklerini ince ayarlamaya kadar, bu kılavuz **Java’da HTML’den PDF oluşturma** ve **yerel HTML dosyasını PDF’e dönüştürme** için ihtiyacınız olan her şeyi kapsadı, üçüncü‑taraf komut‑satırı araçlarına ihtiyaç duymadan. + +Sırada ne var? Başlık/alt bilgi eklemeyi, PDF’i şifrelemeyi deneyin ya da bu dönüştürücüyü bir Spring Boot REST uç noktasına entegre edin; böylece istemciler HTML yükleyip anında PDF alabilir. Olasılıklar sonsuzdur ve temel desen aynı kalır. + +Sorularınız mı var ya da akıllı bir ayarlama paylaşmak mı istiyorsunuz? Aşağıya yorum bırakın – kodlamanız keyifli olsun! + +## Sonra Ne Öğrenmelisiniz? + +Aşağıdaki öğreticiler, bu rehberde gösterilen tekniklere dayanan ve yakından ilgili konuları kapsar. Her kaynak, ek API özelliklerini öğrenmenize ve kendi projelerinizde alternatif uygulama yaklaşımlarını keşfetmenize yardımcı olacak adım‑adım açıklamalarla tam çalışan kod örnekleri içerir. + +- [HTML’yi PDF’e Dönüştürme Java – Aspose.HTML’de Ortamı Yapılandırma](/html/english/java/configuring-environment/) +- [HTML’den PDF Oluştur – Aspose.HTML for Java’da Kullanıcı Stil Sayfası Ayarlama](/html/english/java/configuring-environment/set-user-style-sheet/) +- [PDF Sayfa Boyutunu Ayarla - Java’da HTML’yi PDF’e Dönüştürme](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/vietnamese/java/conversion-html-to-other-formats/_index.md b/html/vietnamese/java/conversion-html-to-other-formats/_index.md index ec6e7a78c1..36c80c7174 100644 --- a/html/vietnamese/java/conversion-html-to-other-formats/_index.md +++ b/html/vietnamese/java/conversion-html-to-other-formats/_index.md @@ -91,6 +91,9 @@ Tìm hiểu cách chuyển đổi HTML sang PDF trong Java bằng Aspose.HTML. T ### [Chuyển đổi HTML sang PDF trong Java – Hướng dẫn chi tiết với cài đặt kích thước trang](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) Hướng dẫn từng bước chuyển HTML sang PDF trong Java, bao gồm cách thiết lập kích thước trang cho PDF. +### [Cách chuyển đổi tệp HTML sang PDF trong Java – Hướng dẫn đầy đủ](./how-to-convert-html-file-to-pdf-in-java-complete-guide/) +Hướng dẫn chi tiết cách chuyển đổi tệp HTML sang PDF trong Java bằng Aspose.HTML, bao gồm các tùy chọn cấu hình và ví dụ thực tế. + ### [Chuyển đổi HTML sang MHTML](./convert-html-to-mhtml/) Chuyển đổi HTML sang MHTML một cách dễ dàng bằng Aspose.HTML for Java. Thực hiện theo hướng dẫn từng bước để chuyển đổi HTML‑to‑MHTML hiệu quả. diff --git a/html/vietnamese/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md b/html/vietnamese/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md new file mode 100644 index 0000000000..0ad7ab0f80 --- /dev/null +++ b/html/vietnamese/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/_index.md @@ -0,0 +1,247 @@ +--- +category: general +date: 2026-07-21 +description: Cách chuyển đổi tệp HTML sang PDF bằng Aspose.HTML trong Java. Học từng + bước để tạo PDF từ HTML trong Java và xử lý các tệp cục bộ. +draft: false +images: +- PLACEHOLDER_URL/og-image.png +keywords: +- how to convert html file to pdf +- create pdf from html in java +- convert html to pdf java +- convert local html file to pdf +language: vi +lastmod: 2026-07-21 +og_description: Cách chuyển đổi tệp HTML sang PDF với Aspose.HTML trong Java. Hãy + làm theo hướng dẫn này để tạo PDF từ HTML trong Java, xử lý các tệp cục bộ một cách + dễ dàng. +og_image_alt: Screenshot showing Java code that converts an HTML file to a PDF +og_title: Cách Chuyển Đổi Tệp HTML Sang PDF trong Java – Phương Pháp Nhanh, Đáng Tin + Cậy +schemas: +- author: Aspose + dateModified: '2026-07-21' + description: How to convert HTML file to PDF using Aspose.HTML in Java. Learn step‑by‑step + to create PDF from HTML in Java and handle local files. + headline: How to Convert HTML File to PDF in Java – Complete Guide + type: TechArticle +- questions: + - answer: Aspose.HTML will download them as long as the machine has internet access. + For offline builds, bundle the fonts locally and reference them with a relative + path. + question: What if the HTML contains external web fonts? + - answer: Absolutely. Wrap the `convert` call inside a loop, perhaps reading file + names from a directory. Remember to handle exceptions per file so one bad input + doesn’t abort the whole batch. + question: Can I convert multiple HTML files in a batch? + - answer: Yes, the current 23.12 release targets Java 8 and above, so you’re safe + on modern runtimes. + question: Does the library support Java 11+? + - answer: 'If you run the trial longer than 30 days, the output PDF will contain + a watermark. Apply your license file early in `main`:' + question: License issues? + type: FAQPage +tags: +- Java +- PDF conversion +- Aspose.HTML +title: Cách Chuyển Đổi Tệp HTML Sang PDF Trong Java – Hướng Dẫn Toàn Diện +url: /vi/java/conversion-html-to-other-formats/how-to-convert-html-file-to-pdf-in-java-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Cách Chuyển Đổi Tệp HTML Sang PDF trong Java – Hướng Dẫn Đầy Đủ + +Bạn đã bao giờ tự hỏi **cách chuyển đổi tệp HTML sang PDF** mà không phải vật lộn với các công cụ dòng lệnh hay các giải pháp rắc rối chưa? Bạn không phải là người duy nhất. Trong nhiều dự án tập trung vào web – nghĩ đến báo cáo tự động, tạo hoá đơn, hoặc lưu trữ trang tĩnh – việc chuyển một trang HTML thành một PDF sắc nét là nhu cầu hàng ngày. + +Tin tốt? Với Aspose.HTML cho Java, bạn có thể thực hiện chỉ trong vài dòng mã. Bài hướng dẫn này sẽ dẫn bạn qua quá trình tạo PDF từ HTML trong Java, bao gồm mọi thứ từ thiết lập dự án đến xử lý các trường hợp đặc biệt như tài nguyên bị thiếu. + +## Yêu Cầu Trước & Những Gì Bạn Sẽ Xây Dựng + +- JDK 17 hoặc mới hơn (phiên bản LTS mới nhất hoạt động tốt nhất) +- Maven 3.8+ (hoặc Gradle nếu bạn thích) +- Giấy phép Aspose.HTML cho Java (bản dùng thử miễn phí đủ cho việc thử nghiệm) +- Một tệp `input.html` đơn giản nằm trong thư mục cục bộ + +Kết thúc hướng dẫn này, bạn sẽ có một chương trình Java có thể chạy được mà **chuyển đổi tệp HTML cục bộ sang PDF**, sẵn sàng để tích hợp vào bất kỳ dịch vụ backend nào. + +--- + +## Bước 1: Thiết Lập Dự Án Maven (Tạo PDF từ HTML trong Java) + +Đầu tiên, tạo một dự án Maven mới. Nếu bạn đã có tệp `pom.xml`, chỉ cần thêm phụ thuộc Aspose.HTML: + +```xml + + + 4.0.0 + com.example + html-to-pdf + 1.0.0 + + + + + com.aspose + aspose-html + 23.12 + + + +``` + +> **Mẹo chuyên nghiệp:** Giữ tệp `pom.xml` của bạn gọn gàng; Maven sẽ tự động tải các phụ thuộc truyền thống, vì vậy bạn không cần phải tìm kiếm các JAR bổ sung. + +## Bước 2: Viết Mã Chuyển Đổi (Cách Chuyển Đổi Tệp HTML Sang PDF) + +Tạo một lớp có tên `HtmlToPdfConverter`. Phần cốt lõi của quá trình chuyển đổi nằm trong một lời gọi tĩnh duy nhất, nhưng chúng ta sẽ bao bọc nó để tăng tính rõ ràng và xử lý lỗi. + +```java +package com.example; + +import com.aspose.html.converters.Converter; +import com.aspose.html.converters.ConverterException; + +public class HtmlToPdfConverter { + + /** + * Converts a local HTML file to a PDF document. + * + * @param sourceHtmlPath absolute or relative path to the input HTML file + * @param targetPdfPath absolute or relative path where the PDF will be saved + * @throws ConverterException if the conversion fails + */ + public static void convert(String sourceHtmlPath, String targetPdfPath) throws ConverterException { + // The Aspose.HTML Converter does all the heavy lifting. + Converter.convert(sourceHtmlPath, targetPdfPath); + } + + public static void main(String[] args) { + // Example usage – replace with your actual file locations. + String sourceHtml = "YOUR_DIRECTORY/input.html"; + String targetPdf = "YOUR_DIRECTORY/output.pdf"; + + try { + convert(sourceHtml, targetPdf); + System.out.println("✅ Conversion succeeded! PDF saved to " + targetPdf); + } catch (ConverterException e) { + System.err.println("❌ Conversion failed: " + e.getMessage()); + e.printStackTrace(); + } + } +} +``` + +### Tại Sao Điều Này Hoạt Động + +- **`Converter.convert`** trừu tượng hoá việc phân tích, xử lý CSS và nhúng hình ảnh. Bạn không cần tự quản lý engine render. +- Phương thức này ném ra **`ConverterException`**, cung cấp cách sạch sẽ để phản hồi các tệp bị thiếu, HTML sai định dạng, hoặc các vấn đề về giấy phép. +- Bằng cách tách logic ra trong `convert`, bạn có thể tái sử dụng nó trong các micro‑service, công việc batch, hoặc thậm chí một công cụ CLI đơn giản. + +## Bước 3: Chạy Ứng Dụng (Tạo PDF từ HTML trong Java) + +Compile and execute the program: + +```bash +mvn clean compile exec:java -Dexec.mainClass="com.example.HtmlToPdfConverter" +``` + +If everything is set up correctly, you’ll see: + +``` +✅ Conversion succeeded! PDF saved to YOUR_DIRECTORY/output.pdf +``` + +Mở `output.pdf` – bạn sẽ thấy một bản render trung thực của `input.html`, bao gồm các kiểu CSS, hình ảnh, và thậm chí nội dung được tạo bởi JavaScript (miễn là nó tĩnh tại thời điểm chuyển đổi). + +## Bước 4: Xử Lý Tài Nguyên Cục Bộ (Chuyển Đổi Tệp HTML Cục Bộ Sang PDF) + +Thường thì HTML của bạn tham chiếu tới hình ảnh, phông chữ, hoặc tệp CSS thông qua các đường dẫn tương đối. Aspose.HTML sẽ tự động giải quyết chúng **nếu** base URI được đặt đúng. Vì chúng ta cung cấp một đường dẫn tệp, thư viện sẽ coi thư mục của `input.html` là base. + +Nếu bạn cần chuyển đổi một chuỗi HTML thay vì tệp, hãy chỉ định base URI một cách thủ công: + +```java +import com.aspose.html.HTMLDocument; +import com.aspose.html.load.LoadOptions; + +String htmlContent = "..."; +String baseUri = "file:///YOUR_DIRECTORY/"; // ensures relative links resolve + +HTMLDocument document = new HTMLDocument(htmlContent, new LoadOptions(baseUri)); +Converter.convert(document, targetPdf); +``` + +> **Cảnh báo:** Quên thiết lập base URI sẽ gây ra việc thiếu hình ảnh hoặc kiểu bị hỏng, một lỗi thường gặp khi **convert html to pdf java** lần đầu. + +## Bước 5: Tùy Chọn Nâng Cao (Tinh Chỉnh Chuyển Đổi HTML Sang PDF trong Java) + +Aspose.HTML cho phép bạn tinh chỉnh kích thước trang, lề, và thậm chí metadata của PDF: + +```java +import com.aspose.html.rendering.pdf.PdfDevice; +import com.aspose.html.rendering.pdf.PdfDeviceOptions; +import com.aspose.html.rendering.pdf.PdfPageSize; + +PdfDeviceOptions options = new PdfDeviceOptions(); +options.setPageSize(PdfPageSize.A4); +options.setMarginTop(20); +options.setMarginBottom(20); +options.setMarginLeft(15); +options.setMarginRight(15); + +// Render with custom options +PdfDevice device = new PdfDevice(targetPdf, options); +Converter.convert(sourceHtml, device); +``` + +Các cài đặt này hữu ích khi bạn cần **convert html file to pdf** để in ấn hoặc tuân thủ (ví dụ, các trang ISO‑216 A4). + +![Minh hoạ cách chuyển đổi tệp html sang pdf](image.png){.center alt="Minh hoạ cách chuyển đổi tệp html sang pdf"} + +*Sơ đồ trên minh họa luồng: mã Java → Aspose.HTML → đầu ra PDF.* + +## Câu Hỏi Thường Gặp & Trường Hợp Đặc Biệt + +- **Nếu HTML chứa phông chữ web bên ngoài thì sao?** + Aspose.HTML sẽ tải chúng về miễn là máy có kết nối internet. Đối với các bản dựng offline, hãy đóng gói phông chữ cục bộ và tham chiếu chúng bằng đường dẫn tương đối. + +- **Tôi có thể chuyển đổi nhiều tệp HTML cùng lúc trong một batch không?** + Chắc chắn. Bao quanh lời gọi `convert` trong một vòng lặp, có thể đọc tên tệp từ một thư mục. Hãy nhớ xử lý ngoại lệ cho từng tệp để một tệp lỗi không làm dừng toàn bộ batch. + +- **Thư viện có hỗ trợ Java 11+ không?** + Có, bản phát hành 23.12 hiện tại nhắm tới Java 8 trở lên, vì vậy bạn sẽ an toàn trên các môi trường hiện đại. + +- **Vấn đề giấy phép?** + Nếu bạn chạy bản dùng thử lâu hơn 30 ngày, PDF đầu ra sẽ chứa watermark. Áp dụng tệp giấy phép của bạn sớm trong `main`: + + ```java + com.aspose.html.License license = new com.aspose.html.License(); + license.setLicense("Aspose.HTML.Java.lic"); + ``` + +--- + +## Kết Luận + +Bây giờ bạn đã có một giải pháp vững chắc, sẵn sàng cho sản xuất để **cách chuyển đổi tệp HTML sang PDF** bằng cách sử dụng Aspose.HTML trong Java. Từ việc thiết lập dự án Maven đến xử lý tài nguyên cục bộ và tinh chỉnh các tùy chọn trang, hướng dẫn đã bao phủ mọi thứ bạn cần để **tạo PDF từ HTML trong Java** và **chuyển đổi tệp HTML cục bộ sang PDF** mà không cần các công cụ dòng lệnh của bên thứ ba. + +Tiếp theo? Hãy thử thêm header/footer, mã hoá PDF, hoặc tích hợp bộ chuyển đổi này vào một endpoint REST Spring Boot để khách hàng có thể tải lên HTML và nhận PDF ngay lập tức. Các khả năng là vô hạn, và mẫu cốt lõi vẫn giữ nguyên. + +Có câu hỏi hoặc muốn chia sẻ một mẹo thông minh? Để lại bình luận bên dưới – chúc lập trình vui! + +## Bạn Nên Học Gì Tiếp Theo? + +Các hướng dẫn sau đây bao phủ các chủ đề liên quan chặt chẽ, xây dựng trên các kỹ thuật được trình bày trong hướng dẫn này. Mỗi tài nguyên bao gồm các ví dụ mã hoàn chỉnh với giải thích từng bước để giúp bạn làm chủ các tính năng API bổ sung và khám phá các cách triển khai thay thế trong dự án của mình. + +- [Chuyển Đổi HTML Sang PDF Java – Cấu Hình Môi Trường trong Aspose.HTML](/html/english/java/configuring-environment/) +- [Tạo PDF từ HTML – Đặt Bảng Kiểu Người Dùng trong Aspose.HTML cho Java](/html/english/java/configuring-environment/set-user-style-sheet/) +- [Đặt Kích Thước Trang PDF - Chuyển Đổi HTML Sang PDF trong Java](/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file