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 7c53c6411..f0e7271ef 100644 --- a/html/arabic/java/conversion-html-to-other-formats/_index.md +++ b/html/arabic/java/conversion-html-to-other-formats/_index.md @@ -84,6 +84,8 @@ XPS هو صيغة الطباعة الخاصة بمايكروسوفت. باستخ ## التحويل - دروس تحويل HTML إلى صيغ أخرى ### [تحويل HTML إلى PDF](./convert-html-to-pdf/) تعلم كيفية تحويل HTML إلى PDF في Java باستخدام Aspose.HTML. أنشئ ملفات PDF عالية الجودة من محتوى HTML بسهولة. +### [تحويل HTML إلى PDF مع Java – دليل خطوة بخطوة](./convert-html-to-pdf-with-java-step-by-step-guide/) +دليل خطوة بخطوة لتحويل HTML إلى PDF في Java باستخدام Aspose.HTML، مع إعدادات مفصلة لضمان جودة النتيجة. ### [تحويل HTML إلى MHTML](./convert-html-to-mhtml/) حوّل HTML إلى MHTML بسهولة باستخدام Aspose.HTML for Java. اتبع دليلنا خطوة بخطوة لتحويل HTML إلى MHTML بكفاءة. ### [تحويل HTML إلى XPS](./convert-html-to-xps/) diff --git a/html/arabic/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/arabic/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..3b070c0b0 --- /dev/null +++ b/html/arabic/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,170 @@ +--- +category: general +date: 2026-03-17 +description: تحويل HTML إلى PDF باستخدام Aspose HTML للغة Java. تعلّم كيفية ضبط حجم + صفحة PDF، وإنشاء PDF من HTML، وتصدير HTML كملف PDF في دليل واحد. +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: ar +og_description: تحويل HTML إلى PDF بسرعة. يوضح هذا الدليل كيفية تعيين حجم صفحة PDF، + وإنشاء PDF من HTML، وتصدير HTML كملف PDF باستخدام Aspose HTML for Java. +og_title: تحويل HTML إلى PDF باستخدام Java – دليل برمجة كامل +tags: +- Aspose +- Java +- PDF generation +title: تحويل HTML إلى PDF باستخدام Java – دليل خطوة بخطوة +url: /ar/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# تحويل HTML إلى PDF باستخدام Java – دليل خطوة بخطوة + +هل احتجت يوماً إلى **تحويل HTML إلى PDF** لكن لم تكن متأكدًا أي مكتبة تمنحك التحكم الكامل في النتيجة؟ لست وحدك. في العديد من المشاريع—مثل مولدات الفواتير، ومصدّري التقارير، أو منصات التعلم الإلكتروني—ستجد نفسك بحاجة إلى طريقة موثوقة لتحويل صفحات الويب إلى ملفات PDF قابلة للطباعة. + +في هذا الدرس سنستعرض حلاً كاملاً جاهزًا للتنفيذ **يحوّل HTML إلى PDF**، يتيح لك **تحديد حجم صفحة PDF**، ويظهر لك كيفية **إنشاء PDF من HTML** مع الحفاظ على نظافة الكود وقابليته للصيانة. بنهاية الدرس ستحصل على مقتطف قابل لإعادة الاستخدام يمكنك إدراجه في أي تطبيق Java. لا مراجع غامضة، فقط كود واضح وتفسيرات صريحة. + +## ما ستتعلمه + +- كيفية تكوين **PdfSaveOptions** لتحديد أبعاد الصفحة وهوامشها. +- الاستدعاء الدقيق الذي تحتاجه **لتصدير HTML كـ PDF** باستخدام Aspose.HTML for Java. +- نصائح للتعامل مع توافق PDF/A‑1b، وهو أمر أساسي للأرشفة. +- مثال كامل قابل للتنفيذ يمكنك نسخه وتعديله. + +**المتطلبات المسبقة** – ستحتاج إلى Java 8 أو أحدث، Maven أو Gradle لجلب مكتبة Aspose.HTML، وملف HTML بسيط تريد تحويله إلى PDF. هذا كل ما تحتاجه؛ لا أطر إضافية أو خوادم ويب مطلوبة. + +--- + +## الخطوة 1: ضبط حجم صفحة PDF والهامش + +أول شيء عادةً ما تريد التحكم فيه هو حجم المستند الناتج. سواء كنت تحتاج A4 للمعايير الأوروبية أو Letter للولايات المتحدة، يتيح لك Aspose تحديد ذلك بكائن واحد. + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**لماذا هذا مهم** – بدون ضبط صريح لحجم الصفحة، قد تُعيد المكتبة الافتراضية إلى US Letter، مما قد يفسد التخطيطات للمستخدمين الدوليين. قيم الهوامش أيضًا بالمليمتر، مما يسهل مطابقة التصاميم الجاهزة للطباعة. + +> **نصيحة احترافية:** إذا كنت تحتاج حجمًا مخصصًا، استبدل `PdfPageSize.A4` بـ `new com.aspose.html.saving.PdfPageSize(width, height)` حيث يكون العرض والارتفاع بالنقاط. + +--- + +## الخطوة 2: إنشاء PDF من HTML + +الآن بعد أن تم تعريف تنسيق الإخراج، التحويل الفعلي هو سطر واحد. طريقة `Converter.convert` تتعامل مع تحليل HTML، وتطبيق CSS، ورسم الصفحة إلى PDF. + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**كيف يعمل** – في الخلفية، يقرأ Aspose ملف HTML، يبني DOM، يحل الموارد الخارجية (الصور، الخطوط، CSS)، ثم يكتب كل صفحة مُعالجة إلى تدفق PDF. لأننا مررنا كائن `pdfSaveOptions`، يحترم المحرك حجم الصفحة، الهوامش، وإعدادات التوافق التي حددناها مسبقًا. + +> **سؤال شائع:** *ماذا لو كان HTML الخاص بي يشير إلى صور بمسارات نسبية؟* +> تأكد فقط أن دليل العمل لعملية Java يطابق موقع ملف HTML، أو استخدم عناوين URL مطلقة. سيجلب Aspose الموارد تلقائيًا. + +--- + +## الخطوة 3: تصدير HTML كـ PDF – مثال عملي كامل + +بدمج الأجزاء معًا، إليك فئة Java مستقلة يمكنك تجميعها وتشغيلها. تتضمن الاستيرادات اللازمة، معالجة الاستثناءات، وتعليقات توضح كل جزء. + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### النتيجة المتوقعة + +بعد تشغيل البرنامج، ستجد `output.pdf` في نفس المجلد الذي أشرت إليه. افتحه بأي عارض PDF—Adobe Reader، Foxit، أو حتى المتصفح—وسوف ترى تمثيلًا دقيقًا لـ `input.html`، مع حجم صفحة A4 وهوامش 20 مم التي ضبطتها. إذا فعلت PDF/A‑1b، سيحتوي الملف أيضًا على البيانات الوصفية اللازمة للحفظ طويل الأمد. + +--- + +## الأسئلة المتكررة وحالات الحافة + +| السؤال | الجواب | +|----------|--------| +| **هل يمكنني تحويل عنوان URL بدلاً من ملف محلي؟** | نعم. استبدل الوسيط الأول بسلسلة URL، مثل `"https://example.com/report.html"`. | +| **ماذا لو احتجت إلى اتجاه صفحة مختلف؟** | استخدم `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` قبل التحويل. | +| **هل يمكن تضمين خط مخصص؟** | بالتأكيد. ضع ملف الخط في نفس دليل HTML أو أشر إليه عبر `@font-face` في CSS؛ سيقوم Aspose بتضمينه تلقائيًا. | +| **كيف أتعامل مع ملفات HTML الكبيرة التي تسبب مشاكل في الذاكرة؟** | فكر في بث HTML أو تقسيمه إلى أقسام وتحويل كل جزء على حدة، ثم دمج ملفات PDF باستخدام Aspose.PDF. | +| **هل أحتاج إلى ترخيص لـ Aspose.HTML؟** | ترخيص تجريبي مجاني يكفي للاختبار، لكن للإنتاج ستحتاج إلى ترخيص مدفوع لإزالة علامة التقييم. | + +--- + +## توضيح الصورة + +فيما يلي لقطة سريعة للـ PDF المُولَّد (صورة بديلة). سمة **alt** تستخدم الكلمة المفتاحية الأساسية، مما يساعد كلًا من تحسين محركات البحث وإمكانية الوصول. + +مثال تحويل html إلى pdf يظهر صفحة A4 مع هوامش + +--- + +## الخلاصة + +لقد غطينا للتو كيفية **تحويل HTML إلى PDF** باستخدام Aspose.HTML for Java، كيفية **تحديد حجم صفحة PDF**، والخطوات الدقيقة **لإنشاء PDF من HTML** مع الحفاظ على بساطة العملية للمبتدئين ومرونتها للمطورين ذوي الخبرة. + +إذا كنت مستعدًا للتعمق أكثر، جرّب التجربة مع: + +- أحجام صفحات مختلفة (`PdfPageSize.LETTER`، أبعاد مخصصة). +- إضافة علامات مائية أو رؤوس/تذييلات عبر `PdfSaveOptions`. +- تحويل عدة ملفات HTML في حلقة ودمجها في ملف PDF واحد. + +هذه الإضافات تبني على المفاهيم الأساسية التي استعرضناها، لذا ستشعر بالراحة في تعديل الكود ليتناسب مع أي سير عمل. + +**برمجة سعيدة!** إذا واجهت أي صعوبات، اترك تعليقًا أدناه أو راجع وثائق Aspose للحصول على تفاصيل أعمق حول الميزات المتقدمة. + +{{< /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/arabic/java/conversion-html-to-various-image-formats/_index.md b/html/arabic/java/conversion-html-to-various-image-formats/_index.md index fdf215c5f..7d205c2c3 100644 --- a/html/arabic/java/conversion-html-to-various-image-formats/_index.md +++ b/html/arabic/java/conversion-html-to-various-image-formats/_index.md @@ -99,6 +99,8 @@ Learn how to convert HTML to PNG images in Java with Aspose.HTML. A comprehensiv Learn how to easily convert HTML to TIFF using Aspose.HTML for Java. Step-by-step guide for efficient document handling. ### [تحويل HTML إلى WebP](./convert-html-to-webp-complete-java-guide-with-aspose-html/) تحويل HTML إلى WebP باستخدام Aspose.HTML for Java. دليل شامل لتحويل مستندات HTML إلى صور WebP بسهولة. +### [حفظ صفحة HTML كصورة PNG في Java – دليل كامل](./save-html-page-as-png-in-java-complete-tutorial/) +تعلم كيفية حفظ صفحة HTML كملف PNG في Java باستخدام Aspose.HTML. دليل شامل خطوة بخطوة. ## الأسئلة المتكررة diff --git a/html/arabic/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/arabic/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..c70b75656 --- /dev/null +++ b/html/arabic/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,230 @@ +--- +category: general +date: 2026-03-17 +description: تعلم كيفية حفظ صفحة HTML كصورة PNG بسرعة. يوضح هذا الدليل كيفية تحويل + HTML إلى PNG وتحديد حجم نافذة العرض في Java باستخدام Aspose.HTML. +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: ar +og_description: احفظ صفحة HTML كصورة PNG باستخدام Java. اتبع هذا الدليل لتعلم كيفية + تحويل HTML إلى PNG وتحديد حجم نافذة العرض في Java باستخدام Aspose.HTML. +og_title: حفظ صفحة HTML كصورة PNG في Java – دليل خطوة بخطوة +tags: +- Java +- AsposeHTML +- Image Rendering +title: حفظ صفحة HTML كصورة PNG في Java – دليل كامل +url: /ar/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# حفظ صفحة HTML كصورة PNG في Java – دليل كامل + +هل احتجت يومًا إلى **save HTML page as PNG** لكنك لم تكن متأكدًا من أين تبدأ؟ لست وحدك—العديد من المطورين يواجهون هذه المشكلة عندما يحتاجون إلى لقطة سريعة لصفحة ويب للتقارير أو الصور المصغرة أو الاختبار. في هذا الدليل سنستعرض **how to render HTML to PNG** باستخدام Aspose.HTML for Java، وسنظهر لك أيضًا كيفية **set viewport size Java** حتى يبدو الناتج بالضبط كما تتوقع. + +سنغطي كل شيء من تثبيت المكتبة إلى تعديل نسبة بكسل الجهاز، وبنهاية الدليل ستحصل على برنامج جاهز للتنفيذ ينتج ملف PNG واضح من أي URL. لا مراجع غامضة، فقط حل كامل ومستقل. + +## ما ستحتاجه + +- Java 11 أو أحدث (إصدار LTS الحالي يعمل بشكل ممتاز) +- Maven أو Gradle لإدارة التبعيات (سنظهر مقتطف Maven) +- اتصال إنترنت لعنوان URL التجريبي (`https://example.com`) أو أي صفحة تريد التقاطها +- دليل قابل للكتابة على القرص حيث سيتم حفظ PNG + +هذا كل شيء—لا حاجة إلى SDKs إضافية، ولا ملفات ثنائية أصلية. Aspose.HTML يتولى العملية الثقيلة داخليًا. + +## الخطوة 1: إضافة تبعية Aspose.HTML + +أولاً، استورد مكتبة Aspose.HTML إلى مشروعك. إذا كنت تستخدم Maven، أضف التالي إلى ملف `pom.xml` الخاص بك: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +يمكن لمستخدمي Gradle وضع هذا في `build.gradle`: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **نصيحة احترافية:** تحقق من [ملاحظات إصدار Aspose.HTML](https://docs.aspose.com/html/java/) للحصول على أحدث نسخة؛ الإصدارات الأحدث غالبًا ما تتضمن تحسينات أداء في عملية العرض. + +## الخطوة 2: تحميل مستند HTML من URL + +الآن سننشئ كائن `HTMLDocument` يشير إلى الصفحة التي تريد التقاطها. هذه الخطوة هي جوهر **how to render HTML to PNG** لأن المكتبة تقوم بتحليل العلامات وتبني DOM داخليًا. + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +إذا كنت تفضل ملفًا محليًا، استبدل سلسلة URL بمسار ملف مثل `"file:///C:/mypage.html"`. + +## الخطوة 3: تكوين الـ Sandbox وتحديد حجم الـ Viewport + +الـ sandbox يعزل عملية العرض عن خيط التطبيق الرئيسي ويسمح لك بتحديد خصائص الجهاز الافتراضي. هنا نستخدم **set viewport size Java** للتحكم بأبعاد البت ماب المُصدرة. + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +لماذا نحتاج الـ sandbox؟ يمنع الآثار الجانبية مثل طلبات الشبكة التي قد تتسرب خارج سياق العرض، ويعطيك نتائج حتمية—وهذا مهم خاصةً عند تشغيل الكود على خادم CI. + +## الخطوة 4: إعداد خيارات حفظ الصورة + +Aspose.HTML يمكنه التصدير إلى العديد من الصيغ (PNG، JPEG، BMP، إلخ). سنقوم بإعداد `ImageSaveOptions` لاستهداف الصفحة الأولى من المستند وتحديد PNG كصيغة إخراج. + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +يمكنك تغيير `setPageNumber` إلى `2` أو `-1` (جميع الصفحات) إذا كنت تحتاج إلى تسلسل صور متعدد الصفحات. + +## الخطوة 5: عرض وحفظ ملف PNG + +أخيرًا، استدعِ `save` على `HTMLDocument`. الطريقة تحترم جميع إعدادات الـ sandbox التي طبقناها مسبقًا، وتنتج لقطة شاشة بدقة بكسل مثالية. + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +عند تشغيل البرنامج، يجب أن ترى رسالة في وحدة التحكم تؤكد موقع الملف. افتح ملف PNG—سترى التمثيل البصري الدقيق لـ `https://example.com` بأبعاد 1280 × 800 بكسل، مع عرض بنسبة بكسل الجهاز 2.0 (لذلك تبدو الصورة حادة على شاشات Retina). + +### النتيجة المتوقعة + +``` +✅ PNG saved to: rendered_page.png +``` + +الملف الناتج `rendered_page.png` سيكون صورة عالية الجودة، جاهزة لتضمينها في التقارير أو الرسائل الإلكترونية أو معاينات الواجهة. + +## كيفية تحويل HTML إلى PNG – تنويعات شائعة + +### عرض بحجم صفحة مختلف + +إذا كنت تحتاج إلى أبعاد مختلفة، ببساطة غيّر قيم `Size`: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### تغيير نسبة بكسل الجهاز + +نسبة DPR بقيمة `1.0` تعطيك صورة بدقة قياسية، بينما `3.0` تحاكي شاشات عالية الكثافة جدًا. اضبط حسب الحاجة: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### إضافة رؤوس أو ملفات تعريف الارتباط مخصصة + +أحيانًا تتطلب الصفحة المستهدفة مصادقة. يمكنك حقن رؤوس قبل التحميل: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### عرض صفحات متعددة + +لتصدير كل صفحة كملف PNG منفصل، قم بالتكرار عبر عدد الصفحات: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## نصائح استكشاف الأخطاء وإصلاحها + +- **Blank Image:** تأكد من أن URL قابل للوصول وأن الـ sandbox لديه اتصال بالإنترنت. إذا كنت خلف بروكسي، اضبط خصائص بروكسي JVM (`-Dhttp.proxyHost=…`). +- **Out‑of‑Memory Errors:** عرض viewports كبيرة جدًا قد يستهلك الكثير من الذاكرة RAM. قلل حجم الـ viewport أو خفّض قيمة DPR. +- **Missing Fonts:** Aspose.HTML يستخدم خطوط النظام بشكل افتراضي. إذا كانت صفحتك تعتمد على خطوط ويب، تأكد من أنها قابلة للوصول أو دمجها عبر CSS `@font-face`. + +## مثال كامل يعمل (كل الشيفرة في مكان واحد) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +انسخ‑الصق هذا إلى بيئة التطوير IDE الخاصة بك، عدّل URL أو مسار الإخراج، واضغط **Run**. إذا تم إعداد كل شيء بشكل صحيح، ستحصل على PNG خلال ثوانٍ. + +## الخاتمة + +في هذا الدليل أظهرنا لك **how to save HTML page as PNG** باستخدام Java، وغطينا تفاصيل **how to render HTML to PNG**، وأظهرنا الخطوات الدقيقة لـ **set viewport size Java** للتحكم الدقيق في الناتج. الآن لديك مقتطف قابل لإعادة الاستخدام يمكن إدراجه في أي مشروع Java—سواء كان خدمة خلفية تولد صورًا مصغرة أو إطار اختبار يتحقق من التخطيطات البصرية. + +### ما التالي؟ + +- جرّب قيم مختلفة لـ `DevicePixelRatio` للحصول على أصول جاهزة لشاشات Retina. +- اجمع هذه الطريقة مع متصفح headless لالتقاط صفحات ديناميكية ثقيلة على JavaScript. +- استكشف صيغ تصدير أخرى مثل JPEG أو PDF عبر استبدال `SaveFormat.PNG` بـ `SaveFormat.JPEG` أو `SaveFormat.PDF`. + +لا تتردد في تعديل الشيفرة، مشاركة نتائجك، أو طرح أسئلة في التعليقات. نتمنى لك عرضًا سعيدًا! + +![Screenshot of rendered HTML saved as PNG](https://example.com/placeholder.png "save html page as png example") + +{{< /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 17440bc9f..4e77a59f3 100644 --- a/html/chinese/java/conversion-html-to-other-formats/_index.md +++ b/html/chinese/java/conversion-html-to-other-formats/_index.md @@ -95,6 +95,8 @@ Aspose.HTML for Java 简化了 HTML 转 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-with-java-step-by-step-guide/) +提供详细的步骤，帮助您在 Java 环境中使用 Aspose.HTML 将 HTML 文件转换为高质量 PDF 文档。 ### [在 Java 中将 HTML 转换为 PDF – 带页面尺寸设置的分步指南](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) 详细步骤演示如何在 Java 使用 Aspose.HTML 将 HTML 转换为 PDF，并自定义页面尺寸。 diff --git a/html/chinese/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/chinese/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..34cc8a50d --- /dev/null +++ b/html/chinese/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,170 @@ +--- +category: general +date: 2026-03-17 +description: 使用 Aspose HTML for Java 将 HTML 转换为 PDF。学习如何设置 PDF 页面大小、从 HTML 生成 PDF，以及在单个教程中将 + HTML 导出为 PDF。 +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: zh +og_description: 快速将HTML转换为PDF。本指南展示了如何设置PDF页面大小、从HTML生成PDF，以及使用 Aspose HTML for Java + 将HTML导出为PDF。 +og_title: 使用 Java 将 HTML 转换为 PDF – 完整编程指南 +tags: +- Aspose +- Java +- PDF generation +title: 使用 Java 将 HTML 转换为 PDF – 步骤指南 +url: /zh/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 使用 Java 将 HTML 转换为 PDF – 步骤指南 + +是否曾经需要**将 HTML 转换为 PDF**，却不确定哪个库能够让你对输出拥有完整控制？你并不孤单。在许多项目中——比如发票生成器、报告导出器或在线学习平台——你都会需要一种可靠的方式将网页转换为可打印的 PDF。 + +在本教程中，我们将逐步演示一个完整、可直接运行的解决方案，**将 HTML 转换为 PDF**，让你**设置 PDF 页面尺寸**，并展示如何**从 HTML 生成 PDF**，同时保持代码简洁易维护。完成后，你将拥有一个可在任何 Java 应用中直接使用的可复用代码片段。没有模糊的引用，只有具体的代码和清晰的解释。 + +## 你将学到的内容 + +- 如何配置 **PdfSaveOptions** 来定义页面尺寸和边距。 +- 使用 Aspose.HTML for Java **导出 HTML 为 PDF** 的确切调用方式。 +- 处理 PDF/A‑1b 合规性的技巧，这对归档至关重要。 +- 一个完整、可运行的示例，直接复制粘贴并进行适配。 + +**先决条件** – 需要 Java 8 或更高版本，使用 Maven 或 Gradle 引入 Aspose.HTML 库，以及一个你想转换为 PDF 的简单 HTML 文件。仅此即可；不需要额外的框架或 Web 服务器。 + +--- + +## 第一步：设置 PDF 页面尺寸和边距 + +通常你首先想要控制的是生成文档的尺寸。无论是欧洲标准的 A4 还是美国的 Letter，Aspose 都可以通过一个对象来指定。 + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**为什么重要** – 如果不显式设置页面尺寸，库可能默认使用 US Letter，这会导致国际用户的布局出现问题。边距值采用毫米单位，便于匹配打印就绪的设计。 + +> **专业提示：** 如果需要自定义尺寸，请将 `PdfPageSize.A4` 替换为 `new com.aspose.html.saving.PdfPageSize(width, height)`，其中 width 和 height 使用点（points）为单位。 + +--- + +## 第二步：从 HTML 生成 PDF + +现在输出格式已经确定，实际的转换只需一行代码。`Converter.convert` 方法负责解析 HTML、应用 CSS 并将页面光栅化为 PDF。 + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**工作原理** – 在内部，Aspose 读取 HTML，构建 DOM，解析外部资源（图片、字体、CSS），然后将每个渲染后的页面写入 PDF 流。因为我们传入了 `pdfSaveOptions` 对象，渲染引擎会遵循我们之前定义的页面尺寸、边距和合规性设置。 + +> **常见问题：** *如果我的 HTML 使用相对路径引用图片怎么办？* +> 确保 Java 进程的工作目录与 HTML 文件所在位置一致，或使用绝对 URL。Aspose 会自动获取这些资源。 + +--- + +## 第三步：导出 HTML 为 PDF – 完整可运行示例 + +将上述代码片段组合在一起，下面是一个可自行编译运行的 Java 类。它包含必要的导入、异常处理以及解释每一步的注释。 + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### 预期结果 + +运行程序后，你会在指定的同一文件夹中看到 `output.pdf`。使用任意 PDF 阅读器——Adobe Reader、Foxit，甚至浏览器——打开它，你应该能看到 `input.html` 的忠实渲染，页面尺寸为 A4，边距为 20 mm。如果启用了 PDF/A‑1b，文件还会包含长期保存所需的元数据。 + +--- + +## 常见问题与边缘案例 + +| 问题 | 答案 | +|----------|--------| +| **可以转换 URL 而不是本地文件吗？** | 可以。将第一个参数替换为 URL 字符串，例如 `"https://example.com/report.html"`。 | +| **如果需要不同的页面方向怎么办？** | 在转换前调用 `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);`。 | +| **能嵌入自定义字体吗？** | 完全可以。将字体文件放在与 HTML 相同的目录，或在 CSS 中通过 `@font-face` 引用；Aspose 会自动嵌入。 | +| **如何处理导致内存问题的大型 HTML 文件？** | 考虑对 HTML 进行流式处理或拆分为多个部分分别转换，然后使用 Aspose.PDF 合并为一个 PDF。 | +| **使用 Aspose.HTML 是否需要许可证？** | 免费评估许可证可用于测试，但生产环境需要付费许可证以去除评估水印。 | + +--- + +## 图片示例 + +下面是一张生成的 PDF 的快速截图（占位图）。**alt** 属性使用了主要关键词，有助于 SEO 与可访问性。 + +convert html to pdf example showing A4 page with margins + +--- + +## 小结 + +我们已经介绍了如何使用 Aspose.HTML for Java **将 HTML 转换为 PDF**，以及如何 **设置 PDF 页面尺寸**，并提供了 **从 HTML 生成 PDF** 的完整步骤，整个过程既适合初学者，也足够灵活满足资深开发者的需求。 + +如果你想进一步探索，可以尝试以下方向： + +- 不同的页面尺寸（`PdfPageSize.LETTER`、自定义尺寸）。 +- 通过 `PdfSaveOptions` 添加水印或页眉/页脚。 +- 在循环中转换多个 HTML 文件并合并为单个 PDF。 + +这些扩展都基于我们刚才讨论的核心概念，你可以轻松地将代码适配到任何工作流中。 + +**祝编码愉快！** 如遇到问题，欢迎在下方留言或查阅 Aspose 文档，深入了解高级功能。 + +{{< /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-various-image-formats/_index.md b/html/chinese/java/conversion-html-to-various-image-formats/_index.md index c52c7a2ca..0c4a1dfc9 100644 --- a/html/chinese/java/conversion-html-to-various-image-formats/_index.md +++ b/html/chinese/java/conversion-html-to-various-image-formats/_index.md @@ -98,6 +98,9 @@ weight: 24 ### [Converting HTML to PNG](./convert-html-to-png/) 了解如何使用 Aspose.HTML 在 Java 中将 HTML 转换为 PNG 图像。一个全面的指南，提供详细的步骤说明。 +### [在 Java 中将 HTML 页面保存为 PNG – 完整教程](./save-html-page-as-png-in-java-complete-tutorial/) +完整教程，演示如何在 Java 中使用 Aspose.HTML 将 HTML 页面保存为 PNG 图像，步骤详尽，可直接复制使用。 + ### [Converting HTML to TIFF](./convert-html-to-tiff/) 学习如何使用 Aspose.HTML for Java 轻松将 HTML 转换为 TIFF。一步步指南，帮助您高效处理文档。 diff --git a/html/chinese/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/chinese/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..63d8d9a4f --- /dev/null +++ b/html/chinese/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,231 @@ +--- +category: general +date: 2026-03-17 +description: 学习如何快速将HTML页面保存为PNG。本指南展示了如何使用 Aspose.HTML 在 Java 中将 HTML 渲染为 PNG 并设置视口大小。 +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: zh +og_description: 使用 Java 将 HTML 页面保存为 PNG。通过本教程学习如何使用 Aspose.HTML 将 HTML 渲染为 PNG 并在 + Java 中设置视口大小。 +og_title: 在 Java 中将 HTML 页面保存为 PNG – 步骤指南 +tags: +- Java +- AsposeHTML +- Image Rendering +title: 在 Java 中将 HTML 页面保存为 PNG – 完整教程 +url: /zh/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 将 HTML 页面保存为 PNG（Java）——完整教程 + +是否曾经需要 **将 HTML 页面保存为 PNG**，却不知从何入手？你并不孤单——许多开发者在需要快速截取网页用于报告、缩略图或测试时都会遇到这个难题。在本指南中，我们将演示如何使用 Aspose.HTML for Java **将 HTML 渲染为 PNG**，并展示 **如何在 Java 中设置视口大小**，让输出效果完全符合预期。 + +我们将覆盖从安装库到调整设备像素比的全部步骤，最终你将拥有一个可直接运行的程序，能够从任意 URL 生成清晰的 PNG 文件。没有模糊的引用，只有完整、独立的解决方案。 + +## 你需要准备的环境 + +在开始之前，请确保你具备以下条件： + +- Java 11 或更高版本（当前 LTS 版本完全兼容） +- Maven 或 Gradle 用于管理依赖（我们将展示 Maven 示例） +- 能够访问示例 URL（`https://example.com`）或任意你想捕获的页面的网络连接 +- 磁盘上有可写入的目录，用于保存 PNG 文件 + +就这些——无需额外的 SDK，也不需要本地二进制文件。Aspose.HTML 在内部完成所有繁重工作。 + +## 第一步：添加 Aspose.HTML 依赖 + +首先，将 Aspose.HTML 库引入项目。如果使用 Maven，在 `pom.xml` 中加入以下内容： + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Gradle 用户可以将下面的代码放入 `build.gradle`： + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **小贴士：** 请查看 [Aspose.HTML 发布说明](https://docs.aspose.com/html/java/)获取最新版本；新版通常包含渲染性能优化。 + +## 第二步：从 URL 加载 HTML 文档 + +接下来，我们创建一个指向目标页面的 `HTMLDocument` 对象。这一步是 **如何将 HTML 渲染为 PNG** 的核心，因为库会解析标记并在内部构建 DOM。 + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +如果你想使用本地文件，只需将 URL 字符串替换为类似 `"file:///C:/mypage.html"` 的文件路径。 + +## 第三步：配置沙箱并设置视口大小 + +沙箱将渲染过程与主应用线程隔离，并允许你定义虚拟设备特性。这正是我们 **在 Java 中设置视口大小** 以控制渲染位图尺寸的地方。 + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +为什么要使用沙箱？它可以防止网络请求泄漏到渲染上下文之外，并提供确定性的结果——在 CI 服务器上运行代码时尤为重要。 + +## 第四步：准备图像保存选项 + +Aspose.HTML 支持导出多种格式（PNG、JPEG、BMP 等）。我们将配置 `ImageSaveOptions`，指定文档的第一页并将输出格式设为 PNG。 + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +如果需要多页图像序列，可将 `setPageNumber` 改为 `2` 或 `-1`（全部页面）。 + +## 第五步：渲染并保存 PNG 文件 + +最后，对 `HTMLDocument` 调用 `save`。该方法会遵循之前设置的所有沙箱参数，生成像素完美的截图。 + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +运行程序后，你应在控制台看到确认文件位置的消息。打开生成的 PNG——你将看到 `https://example.com` 在 1280 × 800 像素下的完整视觉呈现，设备像素比为 2.0（因此在 Retina 显示屏上图像非常锐利）。 + +### 预期输出 + +``` +✅ PNG saved to: rendered_page.png +``` + +生成的 `rendered_page.png` 将是一张高质量的图像文件，可直接嵌入报告、邮件或 UI 预览中。 + +## 如何将 HTML 渲染为 PNG —— 常见变体 + +### 渲染不同的页面尺寸 + +若需其他尺寸，只需修改 `Size` 参数： + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### 更改设备像素比 + +`1.0` 的 DPR 生成标准分辨率图像，`3.0` 则模拟超高密度屏幕。根据需要自行调整： + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### 添加自定义请求头或 Cookie + +有时目标页面需要身份验证。你可以在加载前注入请求头： + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### 渲染多页 + +若要将每页导出为单独的 PNG，可遍历页面计数： + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## 故障排查技巧 + +- **空白图像：** 确认 URL 可访问且沙箱拥有网络权限。如果处于代理环境，请设置 JVM 代理属性（`-Dhttp.proxyHost=…`）。 +- **内存不足错误：** 渲染超大视口会消耗大量 RAM。请减小视口尺寸或降低 DPR。 +- **缺少字体：** Aspose.HTML 默认使用系统字体。如果页面依赖 Web 字体，请确保其可访问，或通过 CSS `@font-face` 嵌入。 + +## 完整可运行示例（所有代码集中在一起） + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +将上述代码复制粘贴到 IDE 中，修改 URL 或输出路径后点击 **Run**。如果一切配置正确，几秒钟内即可得到 PNG 文件。 + +## 结论 + +本教程展示了如何使用 Java **将 HTML 页面保存为 PNG**，详细讲解了 **如何将 HTML 渲染为 PNG** 的要点，并演示了 **在 Java 中设置视口大小** 的完整步骤。现在，你拥有了一个可复用的代码片段，能够轻松嵌入任何 Java 项目——无论是生成缩略图的后端服务，还是用于验证视觉布局的测试工具。 + +### 接下来可以做什么？ + +- 尝试不同的 `DevicePixelRatio` 值，以生成适配 Retina 的资源。 +- 将此方法与无头浏览器结合，捕获动态、JavaScript 密集的页面。 +- 通过将 `SaveFormat.PNG` 替换为 `SaveFormat.JPEG` 或 `SaveFormat.PDF`，探索 JPEG、PDF 等其他导出格式。 + +欢迎自行调整代码，分享你的成果，或在评论区提问。祝渲染愉快！ + +![Screenshot of rendered HTML saved as PNG](https://example.com/placeholder.png "save html page as png example") + +{{< /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-various-image-formats/_index.md b/html/czech/java/conversion-html-to-various-image-formats/_index.md index c7993f5b3..e4e6667e7 100644 --- a/html/czech/java/conversion-html-to-various-image-formats/_index.md +++ b/html/czech/java/conversion-html-to-various-image-formats/_index.md @@ -65,6 +65,9 @@ Pokud potřebujete **convert HTML to JPEG** pro fotografické reprezentace nebo ## Převod HTML do PNG Převod HTML na PNG obrázky je ideální pro bezztrátovou grafiku, snímky obrazovky nebo když potřebujete průhlednost. Náš komplexní průvodce poskytuje jasné instrukce pro plynulý převod. +### [Uložení HTML stránky jako PNG v Javě – kompletní tutoriál](./save-html-page-as-png-in-java-complete-tutorial/) +Naučte se, jak pomocí Aspose.HTML for Java uložit HTML stránku jako PNG obrázek s podrobným krok‑za‑krokem návodem. + ## Převod HTML do TIFF Převod HTML do TIFF je ideální pro tisk ve vysokém rozlišení nebo archivní ukládání. Tento tutoriál popisuje přesné kroky k efektivnímu vytvoření TIFF souborů pomocí Aspose.HTML for Java. diff --git a/html/czech/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/czech/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..2272296a5 --- /dev/null +++ b/html/czech/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,231 @@ +--- +category: general +date: 2026-03-17 +description: Naučte se rychle uložit HTML stránku jako PNG. Tento průvodce ukazuje, + jak pomocí Aspose.HTML v Javě převést HTML na PNG a nastavit velikost viewportu. +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: cs +og_description: Uložte HTML stránku jako PNG pomocí Javy. Sledujte tento tutoriál + a naučte se, jak renderovat HTML do PNG a nastavit velikost viewportu v Javě pomocí + Aspose.HTML. +og_title: Uložte HTML stránku jako PNG v Javě – průvodce krok za krokem +tags: +- Java +- AsposeHTML +- Image Rendering +title: Uložení HTML stránky jako PNG v Javě – kompletní tutoriál +url: /cs/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Uložení HTML stránky jako PNG v Javě – Kompletní tutoriál + +Už jste někdy potřebovali **uložit HTML stránku jako PNG**, ale nevedeli jste, kde začít? Nejste v tom sami — mnoho vývojářů narazí na tento problém, když potřebují rychlý snímek webové stránky pro zprávy, náhledy nebo testování. V tomto průvodci vás provedeme **jak renderovat HTML do PNG** pomocí Aspose.HTML pro Java a také vám ukážeme, jak **nastavit velikost viewportu v Javě**, aby výstup vypadal přesně tak, jak očekáváte. + +Probereme vše od instalace knihovny až po ladění poměru pixelů zařízení a na konci budete mít připravený program, který během několika sekund vytvoří ostrý PNG soubor z libovolné URL. Žádné vágní odkazy, jen kompletní, samostatné řešení. + +## Co budete potřebovat + +- Java 11 nebo novější (aktuální LTS verze funguje perfektně) +- Maven nebo Gradle pro správu závislostí (ukážeme Maven ukázku) +- Internetové připojení pro ukázkovou URL (`https://example.com`) nebo jakoukoli stránku, kterou chcete zachytit +- Zapisovatelný adresář na disku, kam bude PNG uloženo + +To je vše — žádné extra SDK, žádné nativní binárky. Aspose.HTML se postará o těžkou práci interně. + +## Krok 1: Přidání závislosti Aspose.HTML + +Nejprve přidejte knihovnu Aspose.HTML do svého projektu. Pokud používáte Maven, přidejte následující do souboru `pom.xml`: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Uživatelé Gradlu mohou vložit toto do `build.gradle`: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Tip:** Zkontrolujte [poznámky k vydání Aspose.HTML](https://docs.aspose.com/html/java/) pro nejnovější verzi; novější sestavy často obsahují optimalizace výkonu pro renderování. + +## Krok 2: Načtení HTML dokumentu z URL + +Nyní vytvoříme objekt `HTMLDocument`, který ukazuje na stránku, kterou chcete zachytit. Tento krok je jádrem **jak renderovat HTML do PNG**, protože knihovna parsuje značky a interně vytvoří DOM. + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +Pokud dáváte přednost lokálnímu souboru, stačí nahradit řetězec URL cestou jako `"file:///C:/mypage.html"`. + +## Krok 3: Konfigurace sandboxu a nastavení velikosti viewportu + +Sandbox izoluje renderování od hlavního vlákna aplikace a umožňuje definovat virtuální charakteristiky zařízení. Zde **nastavujeme velikost viewportu v Javě**, abychom kontrolovali rozměry renderovaného bitmapu. + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +Proč používat sandbox? Zabraňuje vedlejším efektům, jako jsou síťové požadavky unikající mimo kontext renderování, a poskytuje deterministické výsledky — což je zvláště důležité při běhu kódu na CI serveru. + +## Krok 4: Příprava možností uložení obrázku + +Aspose.HTML může exportovat do mnoha formátů (PNG, JPEG, BMP atd.). Nakonfigurujeme `ImageSaveOptions`, aby cílily na první stránku dokumentu a specifikovaly PNG jako výstupní formát. + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +Můžete změnit `setPageNumber` na `2` nebo `-1` (všechny stránky), pokud potřebujete sekvenci obrázků více stránek. + +## Krok 5: Renderování a uložení PNG souboru + +Nakonec zavolejte `save` na objektu `HTMLDocument`. Metoda respektuje všechna nastavení sandboxu, která jsme aplikovali dříve, a vytvoří pixel‑perfektní snímek. + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +Když spustíte program, měli byste v konzoli vidět zprávu potvrzující umístění souboru. Otevřete PNG — uvidíte přesnou vizuální reprezentaci `https://example.com` při 1280 × 800 pixelech, renderovanou s poměrem pixelů zařízení 2.0 (takže obrázek vypadá ostrý na Retina displejích). + +### Očekávaný výstup + +``` +✅ PNG saved to: rendered_page.png +``` + +Výsledný soubor `rendered_page.png` bude vysoce kvalitní obrázek, připravený k vložení do zpráv, e‑mailů nebo UI náhledů. + +## Jak renderovat HTML do PNG – Běžné varianty + +### Renderování jiné velikosti stránky + +Pokud potřebujete jiný rozměr, jednoduše změňte hodnoty `Size`: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### Změna poměru pixelů zařízení + +DPR `1.0` vám poskytne obrázek standardního rozlišení, zatímco `3.0` napodobuje velmi husté obrazovky. Nastavte podle potřeby: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Přidání vlastních hlaviček nebo cookies + +Někdy cílová stránka vyžaduje autentizaci. Můžete injektovat hlavičky před načtením: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Renderování více stránek + +Pro export každé stránky jako samostatného PNG projděte počet stránek ve smyčce: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Tipy pro řešení problémů + +- **Prázdný obrázek:** Ujistěte se, že URL je dosažitelná a sandbox má přístup k internetu. Pokud jste za proxy, nastavte JVM proxy vlastnosti (`-Dhttp.proxyHost=…`). +- **Chyby nedostatku paměti:** Renderování velmi velkých viewportů může spotřebovat hodně RAM. Zmenšete velikost viewportu nebo snižte DPR. +- **Chybějící fonty:** Aspose.HTML používá výchozí systémové fonty. Pokud vaše stránka spoléhá na webové fonty, ujistěte se, že jsou dostupné, nebo je vložte pomocí CSS `@font-face`. + +## Kompletní funkční příklad (veškerý kód na jednom místě) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +Zkopírujte a vložte tento kód do svého IDE, upravte URL nebo výstupní cestu a stiskněte **Run**. Pokud je vše správně nastaveno, během několika sekund budete mít PNG. + +## Závěr + +V tomto tutoriálu jsme vám ukázali **jak uložit HTML stránku jako PNG** pomocí Javy, probírali nuance **jak renderovat HTML do PNG** a demonstrovali přesné kroky **nastavit velikost viewportu v Javě** pro precizní kontrolu výstupu. Nyní máte znovupoužitelný úryvek, který můžete vložit do libovolného Java projektu — ať už jde o backendovou službu generující náhledy nebo testovací hák ověřující vizuální rozvržení. + +### Co dál? + +- Experimentujte s různými hodnotami `DevicePixelRatio` pro assety připravené na Retina displeje. +- Kombinujte tento přístup s headless prohlížečem pro zachycení dynamických, JavaScript‑těžkých stránek. +- Prozkoumejte další exportní formáty jako JPEG nebo PDF výměnou `SaveFormat.PNG` za `SaveFormat.JPEG` nebo `SaveFormat.PDF`. + +Neváhejte kód upravit, sdílet své výsledky nebo klást otázky v komentářích. Šťastné renderování! + +![Snímek renderovaného HTML uloženého jako PNG](https://example.com/placeholder.png "ukázka uložení html stránky jako png") + +{{< /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 88aaf0247..20a9d9e62 100644 --- a/html/dutch/java/conversion-html-to-other-formats/_index.md +++ b/html/dutch/java/conversion-html-to-other-formats/_index.md @@ -86,6 +86,8 @@ Kortom, het beheersen van **html to pdf java** en de bredere reeks conversies on Leer hoe u HTML naar PDF kunt converteren in Java met Aspose.HTML. Maak moeiteloos hoogwaardige PDF's van uw HTML‑inhoud. ### [HTML naar PDF converteren in Java – Stapsgewijze gids met paginagrootte‑instellingen](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) Leer stap voor stap hoe u HTML naar PDF converteert in Java en paginagrootte‑instellingen configureert voor optimale resultaten. +### [HTML naar PDF converteren met Java – Stapsgewijze gids](./convert-html-to-pdf-with-java-step-by-step-guide/) +Leer stap voor stap hoe u HTML naar PDF converteert met Java, inclusief configuratie‑opties en best practices. ### [HTML naar MHTML converteren](./convert-html-to-mhtml/) Converteer HTML moeiteloos naar MHTML met Aspose.HTML for Java. Volg onze stap‑voor‑stap gids voor efficiënte HTML‑naar‑MHTML conversie. ### [HTML naar XPS converteren](./convert-html-to-xps/) diff --git a/html/dutch/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/dutch/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..f02a97a5d --- /dev/null +++ b/html/dutch/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,179 @@ +--- +category: general +date: 2026-03-17 +description: Converteer HTML naar PDF met Aspose HTML voor Java. Leer hoe je de PDF-paginagrootte + instelt, PDF genereert vanuit HTML en HTML exporteert als PDF in één tutorial. +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: nl +og_description: Converteer HTML snel naar PDF. Deze gids laat zien hoe je de PDF-paginaformaat + instelt, PDF genereert vanuit HTML en HTML exporteert als PDF met Aspose HTML voor + Java. +og_title: HTML naar PDF converteren met Java – Complete programmeergids +tags: +- Aspose +- Java +- PDF generation +title: HTML naar PDF converteren met Java – Stapsgewijze gids +url: /nl/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +naturally to Dutch, but keep technical terms. Alt attribute is text, so translate. But need to keep URL unchanged. So alt becomes Dutch. + +Similarly table entries: translate question and answer. + +Let's do translation. + +Proceed. + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML naar PDF converteren met Java – Stapsgewijze gids + +Heb je ooit **HTML naar PDF moeten converteren** maar wist je niet welke bibliotheek je volledige controle over de output geeft? Je bent niet de enige. In veel projecten—denk aan factuurgeneratoren, rapportexporteurs of e‑learningplatforms—kom je een betrouwbare manier tegen om webpagina's om te zetten naar afdrukbare PDF's. + +In deze tutorial lopen we een complete, kant‑klaar werkende oplossing door die **HTML naar PDF converteert**, je **PDF-paginaformaat laat instellen**, en laat zien hoe je **PDF genereert vanuit HTML** terwijl de code schoon en onderhoudbaar blijft. Aan het einde heb je een herbruikbare snippet die je in elke Java‑applicatie kunt plaatsen. Geen vage verwijzingen, alleen concrete code en duidelijke uitleg. + +## Wat je gaat leren + +- Hoe je **PdfSaveOptions** configureert om paginadimensies en marges te definiëren. +- De exacte aanroep die je nodig hebt om **HTML te exporteren als PDF** met Aspose.HTML for Java. +- Tips voor het omgaan met PDF/A‑1b‑conformiteit, wat essentieel is voor archivering. +- Een volledig, uitvoerbaar voorbeeld dat je kunt kopiëren‑plakken en aanpassen. + +**Prerequisites** – je hebt Java 8 of hoger nodig, Maven of Gradle om de Aspose.HTML‑bibliotheek te downloaden, en een eenvoudig HTML‑bestand dat je wilt omzetten naar een PDF. Dat is alles; geen extra frameworks of webservers vereist. + +--- + +## Stap 1: PDF‑paginaformaat en marges instellen + +Het eerste wat je meestal wilt controleren is de grootte van het resulterende document. Of je nu A4 nodig hebt voor Europese standaarden of Letter voor de VS, Aspose laat je dit met één object specificeren. + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**Waarom dit belangrijk is** – Zonder expliciet het paginagrootte in te stellen, kan de bibliotheek standaard op US Letter terugvallen, wat lay‑outs voor internationale gebruikers kan verstoren. De marge‑waarden staan ook in millimeters, waardoor het eenvoudig is om print‑klare ontwerpen te matchen. + +> **Pro tip:** Als je een aangepaste grootte nodig hebt, vervang je `PdfPageSize.A4` door `new com.aspose.html.saving.PdfPageSize(width, height)` waarbij breedte en hoogte in points worden opgegeven. + +--- + +## Stap 2: PDF genereren vanuit HTML + +Nu het uitvoerformaat is gedefinieerd, is de daadwerkelijke conversie een één‑regelige opdracht. De `Converter.convert`‑methode verwerkt het parsen van de HTML, het toepassen van CSS, en het rasteren van de pagina naar een PDF. + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**Hoe het werkt** – In de achtergrond leest Aspose de HTML, bouwt een DOM, lost externe bronnen (afbeeldingen, lettertypen, CSS) op, en schrijft vervolgens elke gerenderde pagina naar de PDF‑stream. Omdat we het `pdfSaveOptions`‑object hebben doorgegeven, respecteert de engine de paginagrootte, marges en conformiteitsinstellingen die we eerder hebben gedefinieerd. + +> **Veelgestelde vraag:** *Wat als mijn HTML afbeeldingen met relatieve paden bevat?* +> Zorg er dan voor dat de werkmap van je Java‑proces overeenkomt met de locatie van het HTML‑bestand, of gebruik absolute URL's. Aspose haalt de bronnen automatisch op. + +--- + +## Stap 3: HTML exporteren als PDF – Volledig werkend voorbeeld + +Door de onderdelen samen te voegen, vind je hier een zelfstandige Java‑klasse die je kunt compileren en uitvoeren. Hij bevat de benodigde imports, foutafhandeling en commentaren die elk deel uitleggen. + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### Verwacht resultaat + +Na het uitvoeren van het programma vind je `output.pdf` in dezelfde map die je hebt opgegeven. Open het met een PDF‑viewer—Adobe Reader, Foxit, of zelfs een browser—en je ziet een getrouwe weergave van `input.html`, compleet met het A4‑paginaformaat en 20 mm marges die je hebt ingesteld. Als je PDF/A‑1b hebt ingeschakeld, bevat het bestand ook de benodigde metadata voor langdurige bewaring. + +--- + +## Veelgestelde vragen & randgevallen + +| Vraag | Antwoord | +|----------|--------| +| **Kan ik een URL converteren in plaats van een lokaal bestand?** | Ja. Vervang het eerste argument door de URL‑string, bijvoorbeeld `"https://example.com/report.html"`. | +| **Wat als ik een andere paginarichting nodig heb?** | Gebruik `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` vóór de conversie. | +| **Is het mogelijk een aangepast lettertype in te sluiten?** | Absoluut. Plaats het lettertypebestand in dezelfde map als de HTML of verwijs ernaar via `@font-face` in je CSS; Aspose zal het automatisch insluiten. | +| **Hoe ga ik om met grote HTML‑bestanden die geheugenproblemen veroorzaken?** | Overweeg de HTML te streamen of op te splitsen in secties en elk deel apart te converteren, waarna je de PDF's samenvoegt met Aspose.PDF. | +| **Heb ik een licentie nodig voor Aspose.HTML?** | Een gratis evaluatielicentie werkt voor testen, maar voor productie heb je een betaalde licentie nodig om het evaluatiewatermerk te verwijderen. | + +--- + +## Illustratie + +Hieronder een snelle screenshot van de gegenereerde PDF (placeholder‑afbeelding). Het **alt**‑attribuut gebruikt het primaire trefwoord, wat zowel SEO als toegankelijkheid ten goede komt. + +voorbeeld van html naar pdf met A4-pagina en marges + +--- + +## Afsluiting + +We hebben net behandeld hoe je **HTML naar PDF** converteert met Aspose.HTML for Java, hoe je **PDF-paginaformaat** instelt, en de exacte stappen om **PDF te genereren vanuit HTML** terwijl het proces eenvoudig genoeg blijft voor beginners en flexibel genoeg voor ervaren ontwikkelaars. + +Als je klaar bent om verder te gaan, experimenteer dan met: + +- Verschillende paginagroottes (`PdfPageSize.LETTER`, aangepaste afmetingen). +- Het toevoegen van watermerken of kop‑/voetteksten via `PdfSaveOptions`. +- Meerdere HTML‑bestanden in een lus converteren en ze samenvoegen tot één PDF. + +Deze uitbreidingen bouwen voort op dezelfde kernconcepten die we hebben besproken, zodat je je gemakkelijk kunt aanpassen aan elke workflow. + +**Happy coding!** Als je ergens vastloopt, laat dan een reactie achter of raadpleeg de Aspose‑documentatie voor diepere duiken in geavanceerde functies. + +{{< /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-various-image-formats/_index.md b/html/dutch/java/conversion-html-to-various-image-formats/_index.md index 396d43363..ea2e64e5c 100644 --- a/html/dutch/java/conversion-html-to-various-image-formats/_index.md +++ b/html/dutch/java/conversion-html-to-various-image-formats/_index.md @@ -95,6 +95,8 @@ Leer hoe je HTML naar GIF kunt converteren in Java met Aspose.HTML. Een uitgebre Leer HTML naar JPEG te converteren met Aspose.HTML for Java. Stap‑voor‑stap gids voor naadloze documentverwerking. ### [HTML naar PNG converteren](./convert-html-to-png/) Leer hoe je HTML naar PNG‑afbeeldingen kunt converteren in Java met Aspose.HTML. Een uitgebreide gids met stap‑voor‑stap instructies. +### [HTML-pagina opslaan als PNG in Java – Complete tutorial](./save-html-page-as-png-in-java-complete-tutorial/) +Leer hoe je met Aspose.HTML for Java een HTML‑pagina volledig kunt opslaan als PNG‑afbeelding met voorbeeldcode. ### [HTML naar TIFF converteren](./convert-html-to-tiff/) Leer hoe je HTML eenvoudig naar TIFF kunt converteren met Aspose.HTML for Java. Stap‑voor‑stap gids voor efficiënte documentafhandeling. ### [HTML naar WebP – Complete Java-gids met Aspose.HTML](./convert-html-to-webp-complete-java-guide-with-aspose-html/) diff --git a/html/dutch/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/dutch/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..6f48c3719 --- /dev/null +++ b/html/dutch/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,245 @@ +--- +category: general +date: 2026-03-17 +description: Leer hoe je een HTML‑pagina snel als PNG kunt opslaan. Deze gids laat + zien hoe je HTML naar PNG rendert en de viewportgrootte instelt in Java met Aspose.HTML. +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: nl +og_description: Sla HTML-pagina op als PNG met Java. Volg deze tutorial om te leren + hoe je HTML naar PNG rendert en de viewportgrootte instelt in Java met behulp van + Aspose.HTML. +og_title: HTML-pagina opslaan als PNG in Java – Stapsgewijze handleiding +tags: +- Java +- AsposeHTML +- Image Rendering +title: HTML-pagina opslaan als PNG in Java – Complete handleiding +url: /nl/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +level. + +Proceed. + +Will translate bullet points, etc. + +Make sure code block placeholders remain unchanged. + +Also keep blockquotes etc. + +Let's craft. + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML-pagina opslaan als PNG in Java – Complete tutorial + +Heb je ooit **een HTML-pagina als PNG willen opslaan** maar wist je niet waar te beginnen? Je bent niet de enige—veel ontwikkelaars lopen tegen dit probleem aan wanneer ze snel een screenshot van een webpagina nodig hebben voor rapporten, thumbnails of tests. In deze gids lopen we stap voor stap door **hoe HTML te renderen naar PNG** met Aspose.HTML voor Java, en laten we ook zien hoe je **viewport‑grootte in Java** kunt instellen zodat de output er precies uitziet zoals je verwacht. + +We behandelen alles, van het installeren van de bibliotheek tot het afstemmen van de device pixel ratio, en aan het einde heb je een kant‑klaar programma dat een scherpe PNG‑file maakt van elke URL. Geen vage verwijzingen, alleen een volledige, zelf‑containende oplossing. + +## Wat je nodig hebt + +Voordat we beginnen, zorg dat je het volgende hebt: + +- Java 11 of nieuwer (de huidige LTS‑versie werkt perfect) +- Maven of Gradle om afhankelijkheden te beheren (we laten het Maven‑fragment zien) +- Een internetverbinding voor de voorbeeld‑URL (`https://example.com`) of elke pagina die je wilt vastleggen +- Een beschrijfbare map op schijf waar de PNG wordt opgeslagen + +Dat is alles—geen extra SDK’s, geen native binaries. Aspose.HTML doet het zware werk intern. + +## Stap 1: Voeg Aspose.HTML‑dependency toe + +Eerst haal je de Aspose.HTML‑bibliotheek in je project. Als je Maven gebruikt, voeg dan het volgende toe aan je `pom.xml`: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Gradle‑gebruikers kunnen dit in `build.gradle` plaatsen: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Pro tip:** Bekijk de [Aspose.HTML release notes](https://docs.aspose.com/html/java/) voor de meest recente versie; nieuwere builds bevatten vaak prestatie‑verbeteringen voor rendering. + +## Stap 2: Laad het HTML‑document van een URL + +Nu maken we een `HTMLDocument`‑object dat verwijst naar de pagina die je wilt vastleggen. Deze stap is de kern van **hoe HTML te renderen naar PNG** omdat de bibliotheek de markup parseert en intern een DOM opbouwt. + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +Als je een lokaal bestand wilt gebruiken, vervang dan de URL‑string door een pad zoals `"file:///C:/mypage.html"`. + +## Stap 3: Configureer de sandbox en stel viewport‑grootte in + +De sandbox isoleert het renderen van je hoofd‑applicatiedraad en laat je de virtuele apparaateigenschappen definiëren. Hier **stel je viewport‑grootte in Java** in om de afmetingen van de gerenderde bitmap te bepalen. + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +Waarom een sandbox? Het voorkomt neveneffecten zoals netwerk‑verzoeken die buiten de render‑context lekken, en het geeft je deterministische resultaten—especially belangrijk wanneer je de code op een CI‑server draait. + +## Stap 4: Bereid Image Save Options voor + +Aspose.HTML kan exporteren naar vele formaten (PNG, JPEG, BMP, enz.). We configureren `ImageSaveOptions` om de eerste pagina van het document te targeten en PNG als output‑formaat op te geven. + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +Je kunt `setPageNumber` wijzigen naar `2` of `-1` (alle pagina’s) als je een multi‑page afbeeldingsreeks nodig hebt. + +## Stap 5: Renderen en de PNG‑file opslaan + +Tot slot roep je `save` aan op het `HTMLDocument`. De methode respecteert alle sandbox‑instellingen die we eerder hebben toegepast, en produceert een pixel‑perfect screenshot. + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +Wanneer je het programma uitvoert, zie je een console‑bericht dat de bestandslocatie bevestigt. Open de PNG— je ziet de exacte visuele weergave van `https://example.com` op 1280 × 800 pixels, gerenderd met een device pixel ratio van 2.0 (zodat de afbeelding scherp is op Retina‑schermen). + +### Verwachte output + +``` +✅ PNG saved to: rendered_page.png +``` + +Het resulterende `rendered_page.png` is een hoogwaardige afbeeldings‑file, klaar om in rapporten, e‑mails of UI‑previews te worden ingebed. + +## Hoe HTML te renderen naar PNG – Veelvoorkomende variaties + +### Een andere paginagrootte renderen + +Als je een andere afmeting nodig hebt, wijzig dan simpelweg de `Size`‑waarden: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### De Device Pixel Ratio aanpassen + +Een DPR van `1.0` geeft je een standaard‑resolutie afbeelding, terwijl `3.0` zeer hoge‑dichtheid schermen nabootst. Pas aan naar behoefte: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Aangepaste headers of cookies toevoegen + +Soms vereist de doelpagina authenticatie. Je kunt headers injecteren vóór het laden: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Meerdere pagina’s renderen + +Om elke pagina als een aparte PNG te exporteren, loop je over het paginacount: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Tips voor probleemoplossing + +- **Lege afbeelding:** Zorg dat de URL bereikbaar is en dat de sandbox internettoegang heeft. Als je achter een proxy zit, stel dan de JVM‑proxy‑eigenschappen in (`-Dhttp.proxyHost=…`). +- **Out‑of‑Memory‑fouten:** Het renderen van zeer grote viewports kan veel RAM verbruiken. Verklein de viewport‑grootte of verlaag de DPR. +- **Ontbrekende fonts:** Aspose.HTML gebruikt standaard systeemfonts. Als je pagina webfonts nodig heeft, zorg dan dat ze bereikbaar zijn of embed ze via CSS `@font-face`. + +## Volledig werkend voorbeeld (Alle code op één plek) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +Kopieer‑en‑plak dit in je IDE, pas de URL of het output‑pad aan, en klik op **Run**. Als alles correct is ingesteld, heb je binnen enkele seconden een PNG. + +## Conclusie + +In deze tutorial hebben we je laten zien **hoe je een HTML‑pagina als PNG kunt opslaan** met Java, de nuances van **hoe HTML te renderen naar PNG** behandeld, en de exacte stappen om **viewport‑grootte in Java** in te stellen voor precieze controle over de output. Je beschikt nu over een herbruikbare snippet die je in elk Java‑project kunt plaatsen—of het nu een backend‑service is die thumbnails genereert of een test‑harnas dat visuele lay‑outs valideert. + +### Wat nu? + +- Experimenteer met verschillende `DevicePixelRatio`‑waarden voor retina‑ready assets. +- Combineer deze aanpak met een headless browser om dynamische, JavaScript‑zware pagina’s vast te leggen. +- Ontdek andere exportformaten zoals JPEG of PDF door `SaveFormat.PNG` te vervangen door `SaveFormat.JPEG` of `SaveFormat.PDF`. + +Voel je vrij om de code aan te passen, je resultaten te delen, of vragen te stellen in de reacties. Veel renderplezier! + +![Screenshot of rendered HTML saved as PNG](https://example.com/placeholder.png "save html page as png example") + +{{< /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 f3a76a424..79f6650a6 100644 --- a/html/english/java/conversion-html-to-other-formats/_index.md +++ b/html/english/java/conversion-html-to-other-formats/_index.md @@ -85,6 +85,8 @@ In conclusion, mastering **html to pdf java** and the broader set of conversions Learn how to convert HTML to PDF in Java using Aspose.HTML. Create high-quality PDFs from your HTML content effortlessly. ### [Convert HTML to PDF in Java – Step‑by‑Step Guide with Page Size Settings](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) Step-by-step guide to convert HTML to PDF in Java, including how to set custom page sizes using Aspose.HTML. +### [Convert HTML to PDF with Java – Step‑by‑Step Guide](./convert-html-to-pdf-with-java-step-by-step-guide/) +Learn how to convert HTML to PDF with Java using Aspose.HTML in a detailed step‑by‑step guide. ### [Converting HTML to MHTML](./convert-html-to-mhtml/) Effortlessly convert HTML to MHTML using Aspose.HTML for Java. Follow our step-by-step guide for efficient HTML-to-MHTML conversion. ### [Converting HTML to XPS](./convert-html-to-xps/) diff --git a/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..4686c7ccf --- /dev/null +++ b/html/english/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,170 @@ +--- +category: general +date: 2026-03-17 +description: Convert HTML to PDF using Aspose HTML for Java. Learn how to set PDF + page size, generate PDF from HTML and export HTML as PDF in a single tutorial. +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: en +og_description: Convert HTML to PDF quickly. This guide shows how to set PDF page + size, generate PDF from HTML, and export HTML as PDF using Aspose HTML for Java. +og_title: Convert HTML to PDF with Java – Complete Programming Guide +tags: +- Aspose +- Java +- PDF generation +title: Convert HTML to PDF with Java – Step‑by‑Step Guide +url: /java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Convert HTML to PDF with Java – Step‑by‑Step Guide + +Ever needed to **convert HTML to PDF** but weren't sure which library would give you full control over the output? You're not alone. In many projects—think invoice generators, report exporters, or e‑learning platforms—you’ll find yourself needing a reliable way to turn web pages into printable PDFs. + +In this tutorial we'll walk through a complete, ready‑to‑run solution that **converts HTML to PDF**, lets you **set PDF page size**, and shows you how to **generate PDF from HTML** while keeping the code clean and maintainable. By the end you’ll have a reusable snippet you can drop into any Java application. No vague references, just concrete code and clear explanations. + +## What You’ll Learn + +- How to configure **PdfSaveOptions** to define page dimensions and margins. +- The exact call you need to **export HTML as PDF** using Aspose.HTML for Java. +- Tips for handling PDF/A‑1b compliance, which is essential for archiving. +- A full, runnable example that you can copy‑paste and adapt. + +**Prerequisites** – you’ll need Java 8 or newer, Maven or Gradle to pull the Aspose.HTML library, and a simple HTML file you want to turn into a PDF. That’s it; no extra frameworks or web servers required. + +--- + +## Step 1: Set PDF Page Size and Margins + +The first thing you usually want to control is the size of the resulting document. Whether you need A4 for European standards or Letter for the US, Aspose lets you specify it with a single object. + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**Why this matters** – Without explicitly setting the page size, the library might default to US Letter, which could mess up layouts for international users. The margin values are also in millimeters, making it easy to match print‑ready designs. + +> **Pro tip:** If you need a custom size, replace `PdfPageSize.A4` with `new com.aspose.html.saving.PdfPageSize(width, height)` where width and height are in points. + +--- + +## Step 2: Generate PDF from HTML + +Now that the output format is defined, the actual conversion is a one‑liner. The `Converter.convert` method handles parsing the HTML, applying CSS, and rasterizing the page into a PDF. + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**How it works** – Under the hood, Aspose reads the HTML, builds a DOM, resolves external resources (images, fonts, CSS), and then writes each rendered page to the PDF stream. Because we passed the `pdfSaveOptions` object, the engine respects the page size, margins, and compliance settings we defined earlier. + +> **Common question:** *What if my HTML references images with relative paths?* +> Just make sure the working directory of your Java process matches the location of the HTML file, or use absolute URLs. Aspose will fetch the resources automatically. + +--- + +## Step 3: Export HTML as PDF – Full Working Example + +Putting the pieces together, here’s a self‑contained Java class you can compile and run. It includes the necessary imports, exception handling, and comments that explain each part. + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### Expected Result + +After running the program, you’ll find `output.pdf` in the same folder you pointed to. Open it with any PDF viewer—Adobe Reader, Foxit, or even a browser—and you should see a faithful rendering of `input.html`, complete with the A4 page size and 20 mm margins you set. If you enabled PDF/A‑1b, the file will also contain the necessary metadata for long‑term preservation. + +--- + +## Frequently Asked Questions & Edge Cases + +| Question | Answer | +|----------|--------| +| **Can I convert a URL instead of a local file?** | Yes. Replace the first argument with the URL string, e.g., `"https://example.com/report.html"`. | +| **What if I need a different page orientation?** | Use `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` before conversion. | +| **Is it possible to embed a custom font?** | Absolutely. Place the font file in the same directory as the HTML or reference it via `@font-face` in your CSS; Aspose will embed it automatically. | +| **How do I handle large HTML files that cause memory issues?** | Consider streaming the HTML or splitting it into sections and converting each part separately, then merging the PDFs with Aspose.PDF. | +| **Do I need a license for Aspose.HTML?** | A free evaluation license works for testing, but for production you’ll need a paid license to remove the evaluation watermark. | + +--- + +## Image Illustration + +Below is a quick screenshot of the generated PDF (placeholder image). The **alt** attribute uses the primary keyword, helping both SEO and accessibility. + +convert html to pdf example showing A4 page with margins + +--- + +## Wrap‑Up + +We’ve just covered how to **convert HTML to PDF** using Aspose.HTML for Java, how to **set PDF page size**, and the exact steps to **generate PDF from HTML** while keeping the process simple enough for beginners and flexible enough for seasoned developers. + +If you’re ready to go further, try experimenting with: + +- Different page sizes (`PdfPageSize.LETTER`, custom dimensions). +- Adding watermarks or headers/footers via `PdfSaveOptions`. +- Converting multiple HTML files in a loop and merging them into a single PDF. + +These extensions build on the same core concepts we explored, so you’ll feel comfortable adapting the code to fit any workflow. + +**Happy coding!** If you hit any snags, drop a comment below or check the Aspose documentation for deeper dives into advanced features. + +{{< /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-various-image-formats/_index.md b/html/english/java/conversion-html-to-various-image-formats/_index.md index 931d443cc..e076968f2 100644 --- a/html/english/java/conversion-html-to-various-image-formats/_index.md +++ b/html/english/java/conversion-html-to-various-image-formats/_index.md @@ -94,6 +94,8 @@ Learn how to convert HTML to GIF in Java using Aspose.HTML. A comprehensive step Learn to convert HTML to JPEG with Aspose.HTML for Java. Step-by-step guide for seamless document processing. ### [Converting HTML to PNG](./convert-html-to-png/) Learn how to convert HTML to PNG images in Java with Aspose.HTML. A comprehensive guide with step-by-step instructions. +### [Save HTML Page as PNG in Java – Complete Tutorial](./save-html-page-as-png-in-java-complete-tutorial/) +Save HTML page as PNG in Java using Aspose.HTML. A complete step‑by‑step tutorial. ### [Converting HTML to TIFF](./convert-html-to-tiff/) Learn how to easily convert HTML to TIFF using Aspose.HTML for Java. Step-by-step guide for efficient document handling. ### [Convert HTML to WebP – Complete Java Guide with Aspose.HTML](./convert-html-to-webp-complete-java-guide-with-aspose-html/) diff --git a/html/english/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/english/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..4c5a08fa7 --- /dev/null +++ b/html/english/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,232 @@ +--- +category: general +date: 2026-03-17 +description: Learn how to save HTML page as PNG quickly. This guide shows how to render + HTML to PNG and set viewport size Java using Aspose.HTML. +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: en +og_description: Save HTML page as PNG with Java. Follow this tutorial to learn how + to render HTML to PNG and set viewport size Java using Aspose.HTML. +og_title: Save HTML Page as PNG in Java – Step‑by‑Step Guide +tags: +- Java +- AsposeHTML +- Image Rendering +title: Save HTML Page as PNG in Java – Complete Tutorial +url: /java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Save HTML Page as PNG in Java – Complete Tutorial + +Ever needed to **save HTML page as PNG** but weren't sure where to start? You're not alone—many developers hit this snag when they need a quick screenshot of a web page for reports, thumbnails, or testing. In this guide we'll walk through **how to render HTML to PNG** using Aspose.HTML for Java, and we’ll also show you how to **set viewport size Java** so the output looks exactly like you expect. + +We'll cover everything from installing the library to tweaking the device pixel ratio, and by the end you’ll have a ready‑to‑run program that produces a crisp PNG file from any URL. No vague references, just a complete, self‑contained solution. + +## What You’ll Need + +Before we dive in, make sure you have: + +- Java 11 or newer (the current LTS version works perfectly) +- Maven or Gradle to manage dependencies (we’ll show the Maven snippet) +- An internet connection for the sample URL (`https://example.com`) or any page you want to capture +- A writable directory on disk where the PNG will be saved + +That’s it—no extra SDKs, no native binaries. Aspose.HTML handles the heavy lifting internally. + +## Step 1: Add Aspose.HTML Dependency + +First, pull the Aspose.HTML library into your project. If you use Maven, add the following to your `pom.xml`: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Gradle users can drop this into `build.gradle`: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Pro tip:** Check the [Aspose.HTML release notes](https://docs.aspose.com/html/java/) for the most recent version; newer builds often include performance tweaks for rendering. + +## Step 2: Load the HTML Document from a URL + +Now we’ll create an `HTMLDocument` object that points to the page you want to capture. This step is the core of **how to render HTML to PNG** because the library parses the markup and builds a DOM internally. + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +If you prefer a local file, just replace the URL string with a file path like `"file:///C:/mypage.html"`. + +## Step 3: Configure the Sandbox and Set Viewport Size + +The sandbox isolates rendering from your main application thread and lets you define the virtual device characteristics. This is where we **set viewport size Java** to control the dimensions of the rendered bitmap. + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +Why bother with a sandbox? It prevents side‑effects like network requests leaking outside the rendering context, and it gives you deterministic results—especially important when you run the code on a CI server. + +## Step 4: Prepare Image Save Options + +Aspose.HTML can export to many formats (PNG, JPEG, BMP, etc.). We’ll configure `ImageSaveOptions` to target the first page of the document and specify PNG as the output format. + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +You can change `setPageNumber` to `2` or `-1` (all pages) if you need a multi‑page image sequence. + +## Step 5: Render and Save the PNG File + +Finally, call `save` on the `HTMLDocument`. The method respects all the sandbox settings we applied earlier, producing a pixel‑perfect screenshot. + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +When you run the program, you should see a console message confirming the file location. Open the PNG— you’ll see the exact visual representation of `https://example.com` at 1280 × 800 pixels, rendered at a device pixel ratio of 2.0 (so the image looks sharp on Retina displays). + +### Expected Output + +``` +✅ PNG saved to: rendered_page.png +``` + +The resulting `rendered_page.png` will be a high‑quality image file, ready for embedding in reports, emails, or UI previews. + +## How to Render HTML to PNG – Common Variations + +### Rendering a Different Page Size + +If you need a different dimension, simply change the `Size` values: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### Changing the Device Pixel Ratio + +A DPR of `1.0` gives you a standard‑resolution image, while `3.0` mimics very high‑density screens. Adjust as needed: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Adding Custom Headers or Cookies + +Sometimes the target page requires authentication. You can inject headers before loading: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Rendering Multiple Pages + +To export every page as a separate PNG, loop over the page count: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Troubleshooting Tips + +- **Blank Image:** Ensure the URL is reachable and the sandbox has internet access. If you’re behind a proxy, set the JVM proxy properties (`-Dhttp.proxyHost=…`). +- **Out‑of‑Memory Errors:** Rendering very large viewports can consume a lot of RAM. Reduce the viewport size or lower the DPR. +- **Missing Fonts:** Aspose.HTML uses system fonts by default. If your page relies on web fonts, make sure they’re reachable or embed them via CSS `@font-face`. + +## Full Working Example (All Code in One Place) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +Copy‑paste this into your IDE, adjust the URL or output path, and hit **Run**. If everything is set up correctly, you’ll have a PNG in seconds. + +## Conclusion + +In this tutorial we showed you **how to save HTML page as PNG** using Java, covered the nuances of **how to render HTML to PNG**, and demonstrated the exact steps to **set viewport size Java** for precise control over the output. You now have a reusable snippet that can be dropped into any Java project—whether it’s a backend service generating thumbnails or a test harness validating visual layouts. + +### What’s Next? + +- Experiment with different `DevicePixelRatio` values for retina‑ready assets. +- Combine this approach with a headless browser to capture dynamic, JavaScript‑heavy pages. +- Explore other export formats like JPEG or PDF by swapping `SaveFormat.PNG` with `SaveFormat.JPEG` or `SaveFormat.PDF`. + +Feel free to tweak the code, share your results, or ask questions in the comments. Happy rendering! + +![Screenshot of rendered HTML saved as PNG](https://example.com/placeholder.png "save html page as png example") + +{{< /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/french/java/conversion-html-to-other-formats/_index.md b/html/french/java/conversion-html-to-other-formats/_index.md index c50968e02..eb5812e1d 100644 --- a/html/french/java/conversion-html-to-other-formats/_index.md +++ b/html/french/java/conversion-html-to-other-formats/_index.md @@ -98,28 +98,14 @@ En conclusion, maîtriser **html to pdf java** et l'ensemble plus large de conve ## Conversion - Tutoriels HTML vers d'autres formats ### [Converting HTML to PDF](./convert-html-to-pdf/) -Apprenez à convertir HTML en PDF en Java avec Aspose.HTML. Créez des PDF de haute qualité à partir de votre contenu HTML sans effort. - ### [Convertir HTML en PDF en Java – Guide étape par étape avec réglages de taille de page](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) -Apprenez à convertir HTML en PDF en Java en suivant chaque étape, incluant la configuration de la taille de page pour des documents précis. - ### [Converting HTML to MHTML](./convert-html-to-mhtml/) -Convertissez facilement HTML en MHTML avec Aspose.HTML for Java. Suivez notre guide étape par étape pour une conversion HTML‑vers‑MHTML efficace. - ### [Converting HTML to XPS](./convert-html-to-xps/) -Apprenez à convertir facilement HTML en XPS avec Aspose.HTML for Java. Créez des documents multiplateformes en toute simplicité. - ### [Converting Markdown to HTML](./convert-markdown-to-html/) -Convertissez Markdown en HTML en Java de manière fluide avec Aspose.HTML for Java. Suivez notre guide étape par étape pour rationaliser vos besoins de conversion de documents. - ### [Converting SVG to Image](./convert-svg-to-image/) -Apprenez à convertir SVG en images en Java avec Aspose.HTML. Guide complet pour une sortie de haute qualité. - ### [Converting SVG to PDF](./convert-svg-to-pdf/) -Convertissez SVG en PDF en Java avec Aspose.HTML. Une solution fluide pour une conversion de documents de haute qualité. - ### [Converting SVG to XPS](./convert-svg-to-xps/) -Apprenez à convertir SVG en XPS avec Aspose.HTML for Java. Guide simple et étape par étape pour des conversions fluides. +### [Convertir HTML en PDF avec Java – Guide étape par étape](./convert-html-to-pdf-with-java-step-by-step-guide/) ## Foire aux questions diff --git a/html/french/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/french/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..34f74101e --- /dev/null +++ b/html/french/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,172 @@ +--- +category: general +date: 2026-03-17 +description: Convertissez le HTML en PDF avec Aspose HTML pour Java. Apprenez à définir + la taille de la page PDF, à générer un PDF à partir du HTML et à exporter le HTML + en PDF dans un seul tutoriel. +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: fr +og_description: Convertissez rapidement du HTML en PDF. Ce guide montre comment définir + la taille de la page PDF, générer un PDF à partir du HTML et exporter le HTML en + PDF en utilisant Aspose HTML pour Java. +og_title: Convertir le HTML en PDF avec Java – Guide complet de programmation +tags: +- Aspose +- Java +- PDF generation +title: Convertir le HTML en PDF avec Java – Guide étape par étape +url: /fr/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Convertir HTML en PDF avec Java – Guide étape par étape + +Vous avez déjà eu besoin de **convertir HTML en PDF** mais vous n'étiez pas sûr quelle bibliothèque vous offrirait un contrôle total sur le résultat ? Vous n'êtes pas seul. Dans de nombreux projets—pensez aux générateurs de factures, aux exportateurs de rapports ou aux plateformes d'e‑learning—vous vous retrouverez à avoir besoin d'une méthode fiable pour transformer des pages web en PDF imprimables. + +Dans ce tutoriel, nous parcourrons une solution complète, prête à l’emploi, qui **convertit HTML en PDF**, vous permet de **définir la taille de page PDF**, et vous montre comment **générer un PDF à partir de HTML** tout en gardant le code propre et maintenable. À la fin, vous disposerez d’un extrait réutilisable que vous pourrez intégrer dans n’importe quelle application Java. Pas de références vagues, seulement du code concret et des explications claires. + +## Ce que vous allez apprendre + +- Comment configurer **PdfSaveOptions** pour définir les dimensions de la page et les marges. +- L’appel exact dont vous avez besoin pour **exporter HTML en PDF** en utilisant Aspose.HTML for Java. +- Des astuces pour gérer la conformité PDF/A‑1b, essentielle pour l’archivage. +- Un exemple complet et exécutable que vous pouvez copier‑coller et adapter. + +**Prérequis** – vous aurez besoin de Java 8 ou supérieur, Maven ou Gradle pour récupérer la bibliothèque Aspose.HTML, et d’un fichier HTML simple que vous souhaitez transformer en PDF. C’est tout ; aucun framework supplémentaire ou serveur web n’est requis. + +--- + +## Étape 1 : Définir la taille de page PDF et les marges + +La première chose que vous voulez généralement contrôler est la taille du document résultant. Que vous ayez besoin du format A4 pour les normes européennes ou Letter pour les États‑Unis, Aspose vous permet de le spécifier avec un seul objet. + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**Pourquoi c’est important** – Sans définir explicitement la taille de la page, la bibliothèque pourrait choisir par défaut le format US Letter, ce qui pourrait perturber la mise en page pour les utilisateurs internationaux. Les valeurs de marge sont également exprimées en millimètres, ce qui facilite l’adaptation aux conceptions prêtes à imprimer. + +> **Astuce pro :** Si vous avez besoin d’une taille personnalisée, remplacez `PdfPageSize.A4` par `new com.aspose.html.saving.PdfPageSize(width, height)` où *width* et *height* sont en points. + +--- + +## Étape 2 : Générer un PDF à partir de HTML + +Maintenant que le format de sortie est défini, la conversion réelle se résume à une seule ligne. La méthode `Converter.convert` gère l’analyse du HTML, l’application du CSS et la rasterisation de la page en PDF. + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**Comment ça fonctionne** – En interne, Aspose lit le HTML, construit un DOM, résout les ressources externes (images, polices, CSS), puis écrit chaque page rendue dans le flux PDF. Comme nous avons passé l’objet `pdfSaveOptions`, le moteur respecte la taille de page, les marges et les paramètres de conformité que nous avons définis précédemment. + +> **Question fréquente :** *Et si mon HTML référence des images avec des chemins relatifs ?* +> Assurez‑vous simplement que le répertoire de travail de votre processus Java correspond à l’emplacement du fichier HTML, ou utilisez des URL absolues. Aspose récupérera les ressources automatiquement. + +--- + +## Étape 3 : Exporter HTML en PDF – Exemple complet fonctionnel + +En assemblant les éléments, voici une classe Java autonome que vous pouvez compiler et exécuter. Elle inclut les importations nécessaires, la gestion des exceptions et des commentaires expliquant chaque partie. + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### Résultat attendu + +Après avoir exécuté le programme, vous trouverez `output.pdf` dans le même dossier que vous avez indiqué. Ouvrez‑le avec n’importe quel lecteur PDF — Adobe Reader, Foxit ou même un navigateur — et vous devriez voir un rendu fidèle de `input.html`, avec le format de page A4 et les marges de 20 mm que vous avez définies. Si vous avez activé PDF/A‑1b, le fichier contiendra également les métadonnées nécessaires à une conservation à long terme. + +--- + +## Questions fréquentes & cas particuliers + +| Question | Réponse | +|----------|--------| +| **Puis‑je convertir une URL au lieu d’un fichier local ?** | Oui. Remplacez le premier argument par la chaîne d’URL, par exemple `"https://example.com/report.html"`. | +| **Et si j’ai besoin d’une orientation de page différente ?** | Utilisez `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` avant la conversion. | +| **Est‑il possible d’intégrer une police personnalisée ?** | Absolument. Placez le fichier de police dans le même répertoire que le HTML ou référencez‑le via `@font-face` dans votre CSS ; Aspose l’intégrera automatiquement. | +| **Comment gérer de gros fichiers HTML qui provoquent des problèmes de mémoire ?** | Envisagez de diffuser le HTML ou de le diviser en sections et de convertir chaque partie séparément, puis de fusionner les PDF avec Aspose.PDF. | +| **Ai‑je besoin d’une licence pour Aspose.HTML ?** | Une licence d’évaluation gratuite suffit pour les tests, mais pour la production vous devrez acquérir une licence payante afin de supprimer le filigrane d’évaluation. | + +--- + +## Illustration d'image + +Voici une capture d’écran rapide du PDF généré (image factice). L’attribut **alt** utilise le mot‑clé principal, aidant à la fois le SEO et l’accessibilité. + +exemple de conversion html en pdf montrant une page A4 avec marges + +--- + +## Conclusion + +Nous venons de couvrir comment **convertir HTML en PDF** avec Aspose.HTML for Java, comment **définir la taille de page PDF**, et les étapes exactes pour **générer un PDF à partir de HTML** tout en gardant le processus suffisamment simple pour les débutants et assez flexible pour les développeurs expérimentés. + +Si vous êtes prêt à aller plus loin, essayez d’expérimenter avec : + +- Différentes tailles de page (`PdfPageSize.LETTER`, dimensions personnalisées). +- L’ajout de filigranes ou d’en‑têtes/pieds de page via `PdfSaveOptions`. +- La conversion de plusieurs fichiers HTML dans une boucle et leur fusion en un seul PDF. + +Ces extensions s’appuient sur les mêmes concepts de base que nous avons explorés, vous permettant d’adapter le code à n’importe quel flux de travail. + +**Bon codage !** Si vous rencontrez des difficultés, laissez un commentaire ci‑dessous ou consultez la documentation Aspose pour approfondir les fonctionnalités avancées. + +{{< /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/french/java/conversion-html-to-various-image-formats/_index.md b/html/french/java/conversion-html-to-various-image-formats/_index.md index 0ebefa3bd..5d83115e7 100644 --- a/html/french/java/conversion-html-to-various-image-formats/_index.md +++ b/html/french/java/conversion-html-to-various-image-formats/_index.md @@ -90,6 +90,8 @@ Apprenez à convertir HTML en GIF en Java avec Aspose.HTML. Un guide complet ét Apprenez à convertir HTML en JPEG avec Aspose.HTML for Java. Guide étape par étape pour un traitement de documents fluide. ### [Conversion d'HTML en PNG](./convert-html-to-png/) Apprenez à convertir HTML en images PNG en Java avec Aspose.HTML. Un guide complet avec des instructions étape par étape. +### [Enregistrer une page HTML au format PNG en Java – Tutoriel complet](./save-html-page-as-png-in-java-complete-tutorial/) +Apprenez à enregistrer une page HTML au format PNG en Java avec Aspose.HTML. Guide complet étape par étape. ### [Conversion d'HTML en TIFF](./convert-html-to-tiff/) Apprenez à convertir facilement HTML en TIFF avec Aspose.HTML for Java. Guide étape par étape pour une gestion efficace des documents. ### [Conversion d'HTML en WebP](./convert-html-to-webp-complete-java-guide-with-aspose-html/) diff --git a/html/french/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/french/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..a2af72735 --- /dev/null +++ b/html/french/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,240 @@ +--- +category: general +date: 2026-03-17 +description: Apprenez à enregistrer rapidement une page HTML au format PNG. Ce guide + montre comment rendre le HTML en PNG et définir la taille du viewport en Java en + utilisant Aspose.HTML. +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: fr +og_description: Enregistrez une page HTML au format PNG avec Java. Suivez ce tutoriel + pour apprendre comment rendre du HTML en PNG et définir la taille du viewport en + Java à l’aide d’Aspose.HTML. +og_title: Enregistrer une page HTML en PNG en Java – Guide étape par étape +tags: +- Java +- AsposeHTML +- Image Rendering +title: Enregistrer une page HTML en PNG avec Java – Tutoriel complet +url: /fr/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +sure to keep code block placeholders. + +Also keep blockquote >. + +Now produce final output. + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Enregistrer une page HTML en PNG avec Java – Tutoriel complet + +Vous avez déjà eu besoin d'**enregistrer une page HTML en PNG** mais vous ne saviez pas par où commencer ? Vous n'êtes pas seul — de nombreux développeurs rencontrent ce problème lorsqu'ils ont besoin d'une capture d'écran rapide d'une page web pour des rapports, des miniatures ou des tests. Dans ce guide, nous allons parcourir **comment rendre du HTML en PNG** avec Aspose.HTML pour Java, et nous vous montrerons également comment **définir la taille du viewport Java** afin que le résultat corresponde exactement à vos attentes. + +Nous couvrirons tout, de l'installation de la bibliothèque à l'ajustement du ratio de pixels du dispositif, et à la fin vous disposerez d'un programme prêt à l'emploi qui génère un fichier PNG net à partir de n'importe quelle URL. Pas de références vagues, juste une solution complète et autonome. + +## Ce dont vous avez besoin + +Avant de commencer, assurez‑vous d'avoir : + +- Java 11 ou version ultérieure (la version LTS actuelle fonctionne parfaitement) +- Maven ou Gradle pour gérer les dépendances (nous montrerons l'extrait Maven) +- Une connexion Internet pour l'URL d'exemple (`https://example.com`) ou toute page que vous souhaitez capturer +- Un répertoire accessible en écriture où le PNG sera enregistré + +C'est tout — aucune SDK supplémentaire, aucun binaire natif. Aspose.HTML se charge du travail lourd en interne. + +## Étape 1 : Ajouter la dépendance Aspose.HTML + +Tout d'abord, importez la bibliothèque Aspose.HTML dans votre projet. Si vous utilisez Maven, ajoutez ce qui suit à votre `pom.xml` : + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Les utilisateurs de Gradle peuvent placer ceci dans `build.gradle` : + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Astuce :** Consultez les [notes de version d'Aspose.HTML](https://docs.aspose.com/html/java/) pour connaître la version la plus récente ; les nouvelles builds incluent souvent des améliorations de performance pour le rendu. + +## Étape 2 : Charger le document HTML depuis une URL + +Nous allons maintenant créer un objet `HTMLDocument` qui pointe vers la page que vous voulez capturer. Cette étape est le cœur de **comment rendre du HTML en PNG** car la bibliothèque analyse le balisage et construit un DOM en interne. + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +Si vous préférez un fichier local, remplacez simplement la chaîne d'URL par un chemin de fichier comme `"file:///C:/mypage.html"`. + +## Étape 3 : Configurer le sandbox et définir la taille du viewport + +Le sandbox isole le rendu de votre thread d'application principal et vous permet de définir les caractéristiques du dispositif virtuel. C'est ici que nous **définissons la taille du viewport Java** pour contrôler les dimensions du bitmap rendu. + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +Pourquoi utiliser un sandbox ? Il empêche les effets secondaires comme les requêtes réseau qui fuient hors du contexte de rendu, et il vous fournit des résultats déterministes — particulièrement important lorsque vous exécutez le code sur un serveur CI. + +## Étape 4 : Préparer les options d'enregistrement d'image + +Aspose.HTML peut exporter vers de nombreux formats (PNG, JPEG, BMP, etc.). Nous allons configurer `ImageSaveOptions` pour cibler la première page du document et spécifier le PNG comme format de sortie. + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +Vous pouvez changer `setPageNumber` à `2` ou `-1` (toutes les pages) si vous avez besoin d'une séquence d'images multi‑pages. + +## Étape 5 : Rendre et enregistrer le fichier PNG + +Enfin, appelez `save` sur le `HTMLDocument`. La méthode respecte toutes les configurations du sandbox appliquées précédemment, produisant une capture d'écran pixel‑parfait. + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +Lorsque vous exécuterez le programme, vous devriez voir un message dans la console confirmant l'emplacement du fichier. Ouvrez le PNG — vous verrez la représentation visuelle exacte de `https://example.com` à 1280 × 800 pixels, rendu avec un ratio de pixels du dispositif de 2.0 (donc l'image apparaît nette sur les écrans Retina). + +### Résultat attendu + +``` +✅ PNG saved to: rendered_page.png +``` + +Le fichier `rendered_page.png` résultant sera une image de haute qualité, prête à être intégrée dans des rapports, des e‑mails ou des aperçus d'interface utilisateur. + +## Comment rendre du HTML en PNG – Variantes courantes + +### Rendu avec une taille de page différente + +Si vous avez besoin d'une dimension différente, modifiez simplement les valeurs de `Size` : + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### Modification du Device Pixel Ratio + +Un DPR de `1.0` vous donne une image à résolution standard, tandis que `3.0` imite des écrans très denses. Ajustez selon vos besoins : + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Ajout d'en-têtes ou de cookies personnalisés + +Parfois, la page cible nécessite une authentification. Vous pouvez injecter des en‑têtes avant le chargement : + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Rendu de plusieurs pages + +Pour exporter chaque page en tant que PNG séparé, bouclez sur le nombre de pages : + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Conseils de dépannage + +- **Image blanche :** Vérifiez que l'URL est accessible et que le sandbox a accès à Internet. Si vous êtes derrière un proxy, définissez les propriétés du proxy JVM (`-Dhttp.proxyHost=…`). +- **Erreurs Out‑of‑Memory :** Rendre des viewports très grands peut consommer beaucoup de RAM. Réduisez la taille du viewport ou diminuez le DPR. +- **Polices manquantes :** Aspose.HTML utilise les polices système par défaut. Si votre page dépend de polices web, assurez‑vous qu'elles sont accessibles ou intégrez‑les via la règle CSS `@font-face`. + +## Exemple complet fonctionnel (tout le code en un seul endroit) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +Copiez‑collez ceci dans votre IDE, ajustez l'URL ou le chemin de sortie, puis cliquez sur **Run**. Si tout est correctement configuré, vous obtiendrez un PNG en quelques secondes. + +## Conclusion + +Dans ce tutoriel, nous vous avons montré **comment enregistrer une page HTML en PNG** avec Java, abordé les subtilités de **comment rendre du HTML en PNG**, et démontré les étapes exactes pour **définir la taille du viewport Java** afin de contrôler précisément le rendu. Vous disposez maintenant d'un extrait réutilisable que vous pouvez intégrer dans n'importe quel projet Java — que ce soit un service backend générant des miniatures ou un banc de test validant des mises en page visuelles. + +### Et après ? + +- Expérimentez avec différentes valeurs de `DevicePixelRatio` pour des actifs prêts pour Retina. +- Combinez cette approche avec un navigateur sans tête pour capturer des pages dynamiques riches en JavaScript. +- Explorez d'autres formats d'exportation comme JPEG ou PDF en remplaçant `SaveFormat.PNG` par `SaveFormat.JPEG` ou `SaveFormat.PDF`. + +N'hésitez pas à modifier le code, partager vos résultats ou poser des questions dans les commentaires. Bon rendu ! + +![Screenshot of rendered HTML saved as PNG](https://example.com/placeholder.png "save html page as png example") + +{{< /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 5645e79f7..9567808e3 100644 --- a/html/german/java/conversion-html-to-other-formats/_index.md +++ b/html/german/java/conversion-html-to-other-formats/_index.md @@ -86,6 +86,9 @@ Zusammenfassend eröffnet das Beherrschen von **html to pdf java** und der breit ### [Konvertierung von HTML zu PDF](./convert-html-to-pdf/) Erfahren Sie, wie Sie HTML in Java mit Aspose.HTML zu PDF konvertieren. Erstellen Sie mühelos hochwertige PDFs aus Ihrem HTML‑Inhalt. +### [HTML zu PDF mit Java – Schritt‑für‑Schritt‑Anleitung](./convert-html-to-pdf-with-java-step-by-step-guide/) +Erfahren Sie, wie Sie HTML in Java zu PDF konvertieren – eine detaillierte Schritt‑für‑Schritt‑Anleitung. + ### [HTML zu PDF in Java – Schritt‑für‑Schritt‑Anleitung mit Seitengrößeneinstellungen](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) Erfahren Sie, wie Sie HTML in Java zu PDF konvertieren und dabei die Seitengröße präzise festlegen. diff --git a/html/german/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/german/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..dc12d08bc --- /dev/null +++ b/html/german/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,172 @@ +--- +category: general +date: 2026-03-17 +description: Konvertieren Sie HTML mit Aspose HTML für Java in PDF. Erfahren Sie, + wie Sie die PDF‑Seitengröße festlegen, PDF aus HTML erzeugen und HTML als PDF exportieren + – alles in einem einzigen Tutorial. +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: de +og_description: HTML schnell in PDF konvertieren. Dieser Leitfaden zeigt, wie man + die PDF‑Seitengröße festlegt, PDF aus HTML erzeugt und HTML mit Aspose HTML für + Java als PDF exportiert. +og_title: HTML mit Java in PDF konvertieren – Vollständiger Programmierleitfaden +tags: +- Aspose +- Java +- PDF generation +title: HTML mit Java in PDF konvertieren – Schritt‑für‑Schritt‑Anleitung +url: /de/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML in PDF mit Java konvertieren – Schritt‑für‑Schritt‑Anleitung + +Haben Sie schon einmal **HTML in PDF konvertieren** müssen, waren sich aber nicht sicher, welche Bibliothek Ihnen die volle Kontrolle über das Ergebnis gibt? Sie sind nicht allein. In vielen Projekten – denken Sie an Rechnungsgeneratoren, Berichtsexporte oder E‑Learning‑Plattformen – benötigen Sie eine zuverlässige Methode, um Webseiten in druckbare PDFs zu verwandeln. + +In diesem Tutorial führen wir Sie durch eine komplette, sofort lauffähige Lösung, die **HTML in PDF konvertiert**, Ihnen ermöglicht **die PDF‑Seitengröße festzulegen**, und zeigt, wie man **PDF aus HTML erzeugt**, während der Code sauber und wartbar bleibt. Am Ende haben Sie ein wiederverwendbares Snippet, das Sie in jede Java‑Anwendung einbinden können. Keine vagen Verweise, nur konkreter Code und klare Erklärungen. + +## Was Sie lernen werden + +- Wie Sie **PdfSaveOptions** konfigurieren, um Seitenabmessungen und Ränder zu definieren. +- Den genauen Aufruf, den Sie benötigen, um **HTML als PDF zu exportieren** mit Aspose.HTML für Java. +- Tipps zum Umgang mit PDF/A‑1b‑Konformität, die für die Archivierung unerlässlich ist. +- Ein vollständiges, ausführbares Beispiel, das Sie kopieren und anpassen können. + +**Voraussetzungen** – Sie benötigen Java 8 oder neuer, Maven oder Gradle, um die Aspose.HTML‑Bibliothek zu beziehen, und eine einfache HTML‑Datei, die Sie in ein PDF umwandeln wollen. Das ist alles; keine zusätzlichen Frameworks oder Web‑Server nötig. + +--- + +## Schritt 1: PDF‑Seitengröße und Ränder festlegen + +Das erste, was Sie normalerweise kontrollieren wollen, ist die Größe des entstehenden Dokuments. Ob Sie A4 für europäische Standards oder Letter für die USA benötigen, Aspose lässt sich das mit einem einzigen Objekt festlegen. + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**Warum das wichtig ist** – Ohne explizite Festlegung der Seitengröße könnte die Bibliothek standardmäßig US Letter verwenden, was das Layout für internationale Nutzer durcheinanderbringen kann. Die Randwerte sind ebenfalls in Millimetern angegeben, sodass Sie leicht druckfertige Designs nachbilden können. + +> **Pro‑Tipp:** Wenn Sie eine benutzerdefinierte Größe benötigen, ersetzen Sie `PdfPageSize.A4` durch `new com.aspose.html.saving.PdfPageSize(width, height)`, wobei Breite und Höhe in Punkten angegeben werden. + +--- + +## Schritt 2: PDF aus HTML generieren + +Jetzt, wo das Ausgabeformat definiert ist, ist die eigentliche Konvertierung ein Einzeiler. Die Methode `Converter.convert` übernimmt das Parsen des HTML, das Anwenden von CSS und das Rendern der Seite in ein PDF. + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**Wie es funktioniert** – Im Hintergrund liest Aspose das HTML, baut ein DOM auf, löst externe Ressourcen (Bilder, Schriften, CSS) auf und schreibt dann jede gerenderte Seite in den PDF‑Stream. Da wir das Objekt `pdfSaveOptions` übergeben haben, beachtet die Engine die von uns zuvor festgelegten Seitengröße, Ränder und Konformitätseinstellungen. + +> **Häufige Frage:** *Was, wenn mein HTML Bilder mit relativen Pfaden referenziert?* +> Stellen Sie einfach sicher, dass das Arbeitsverzeichnis Ihres Java‑Prozesses dem Speicherort der HTML‑Datei entspricht, oder verwenden Sie absolute URLs. Aspose holt die Ressourcen automatisch. + +--- + +## Schritt 3: HTML als PDF exportieren – Voll funktionsfähiges Beispiel + +Alle Teile zusammengefügt, hier eine eigenständige Java‑Klasse, die Sie kompilieren und ausführen können. Sie enthält die notwendigen Importe, Fehlerbehandlung und Kommentare, die jeden Abschnitt erklären. + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### Erwartetes Ergebnis + +Nach dem Ausführen des Programms finden Sie `output.pdf` im selben Ordner, den Sie angegeben haben. Öffnen Sie die Datei mit einem beliebigen PDF‑Betrachter – Adobe Reader, Foxit oder sogar einem Browser – und Sie sollten eine getreue Darstellung von `input.html` sehen, komplett mit der von Ihnen gesetzten A4‑Seitengröße und 20 mm Rändern. Wenn Sie PDF/A‑1b aktiviert haben, enthält die Datei zudem die erforderlichen Metadaten für die Langzeitarchivierung. + +--- + +## Häufig gestellte Fragen & Sonderfälle + +| Frage | Antwort | +|----------|--------| +| **Kann ich eine URL statt einer lokalen Datei konvertieren?** | Ja. Ersetzen Sie das erste Argument durch den URL‑String, z. B. `"https://example.com/report.html"`. | +| **Was, wenn ich eine andere Seitenausrichtung brauche?** | Verwenden Sie `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` vor der Konvertierung. | +| **Ist es möglich, eine benutzerdefinierte Schrift einzubetten?** | Absolut. Platzieren Sie die Schriftdatei im selben Verzeichnis wie das HTML oder referenzieren Sie sie via `@font-face` in Ihrem CSS; Aspose bettet sie automatisch ein. | +| **Wie gehe ich mit großen HTML‑Dateien um, die Speicherprobleme verursachen?** | Ziehen Sie in Betracht, das HTML zu streamen oder in Abschnitte zu splitten und jeden Teil separat zu konvertieren, anschließend die PDFs mit Aspose.PDF zusammenzuführen. | +| **Benötige ich eine Lizenz für Aspose.HTML?** | Eine kostenlose Evaluierungslizenz reicht für Tests, aber für den Produktionseinsatz benötigen Sie eine kostenpflichtige Lizenz, um das Evaluations‑Wasserzeichen zu entfernen. | + +--- + +## Bildliche Darstellung + +Unten sehen Sie einen schnellen Screenshot des erzeugten PDFs (Platzhalter‑Bild). Das **alt**‑Attribut verwendet das Haupt‑Keyword und unterstützt sowohl SEO als auch Barrierefreiheit. + +convert html to pdf example showing A4 page with margins + +--- + +## Abschluss + +Wir haben gerade gezeigt, wie man **HTML in PDF** mit Aspose.HTML für Java **konvertiert**, wie man **die PDF‑Seitengröße festlegt** und die genauen Schritte, um **PDF aus HTML zu erzeugen**, wobei der Prozess einfach genug für Einsteiger und flexibel genug für erfahrene Entwickler bleibt. + +Wenn Sie weitergehen möchten, probieren Sie Folgendes aus: + +- Unterschiedliche Seitengrößen (`PdfPageSize.LETTER`, benutzerdefinierte Abmessungen). +- Wasserzeichen oder Kopf‑/Fußzeilen über `PdfSaveOptions` hinzufügen. +- Mehrere HTML‑Dateien in einer Schleife konvertieren und zu einem einzigen PDF zusammenführen. + +Diese Erweiterungen bauen auf denselben Kernkonzepten auf, die wir behandelt haben, sodass Sie sich sicher fühlen, den Code an jeden Workflow anzupassen. + +**Viel Spaß beim Coden!** Wenn Sie auf Probleme stoßen, hinterlassen Sie einen Kommentar unten oder schauen Sie in die Aspose‑Dokumentation für tiefere Einblicke in erweiterte Funktionen. + +{{< /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-various-image-formats/_index.md b/html/german/java/conversion-html-to-various-image-formats/_index.md index f78c48517..63baf0bd4 100644 --- a/html/german/java/conversion-html-to-various-image-formats/_index.md +++ b/html/german/java/conversion-html-to-various-image-formats/_index.md @@ -90,6 +90,8 @@ Erfahren Sie, wie Sie HTML in GIF mit Java und Aspose.HTML konvertieren. Ein umf Erfahren Sie, wie Sie HTML mit Aspose.HTML for Java in JPEG konvertieren. Schritt‑für‑Schritt‑Leitfaden für nahtlose Dokumentenverarbeitung. ### [HTML in PNG konvertieren](./convert-html-to-png/) Erfahren Sie, wie Sie HTML in PNG‑Bilder mit Java und Aspose.HTML konvertieren. Ein umfassender Leitfaden mit Schritt‑für‑Schritt‑Anweisungen. +### [HTML‑Seite als PNG speichern – Komplettes Tutorial für Java](./save-html-page-as-png-in-java-complete-tutorial/) +Erfahren Sie, wie Sie mit Aspose.HTML for Java eine HTML‑Seite vollständig als PNG‑Bild speichern – Schritt‑für‑Schritt‑Anleitung. ### [HTML in TIFF konvertieren](./convert-html-to-tiff/) Erfahren Sie, wie Sie HTML einfach mit Aspose.HTML for Java in TIFF konvertieren. Schritt‑für‑Schritt‑Leitfaden für effiziente Dokumentenverarbeitung. ### [HTML in WebP konvertieren](./convert-html-to-webp-complete-java-guide-with-aspose-html/) diff --git a/html/german/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/german/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..05f65f0f3 --- /dev/null +++ b/html/german/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,236 @@ +--- +category: general +date: 2026-03-17 +description: Erfahren Sie, wie Sie eine HTML‑Seite schnell als PNG speichern. Dieser + Leitfaden zeigt, wie man HTML zu PNG rendert und die Viewport‑Größe in Java mit + Aspose.HTML festlegt. +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: de +og_description: Speichern Sie eine HTML‑Seite als PNG mit Java. Folgen Sie diesem + Tutorial, um zu lernen, wie man HTML zu PNG rendert und die Viewport‑Größe in Java + mit Aspose.HTML festlegt. +og_title: HTML‑Seite als PNG in Java speichern – Schritt‑für‑Schritt‑Anleitung +tags: +- Java +- AsposeHTML +- Image Rendering +title: HTML‑Seite als PNG in Java speichern – komplettes Tutorial +url: /de/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +Let's produce final content. + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML‑Seite als PNG in Java speichern – Komplettes Tutorial + +Haben Sie schon einmal **eine HTML‑Seite als PNG speichern** müssen, wussten aber nicht, wo Sie anfangen sollen? Sie sind nicht allein – viele Entwickler stoßen auf dieses Problem, wenn sie schnell einen Screenshot einer Webseite für Berichte, Thumbnails oder Tests benötigen. In diesem Leitfaden zeigen wir Ihnen **wie man HTML zu PNG rendert** mit Aspose.HTML für Java und erklären, wie Sie **die Viewport‑Größe in Java setzen**, damit das Ergebnis exakt Ihren Erwartungen entspricht. + +Wir behandeln alles von der Installation der Bibliothek bis hin zur Anpassung des Device‑Pixel‑Ratio, und am Ende haben Sie ein lauffähiges Programm, das aus jeder URL eine scharfe PNG‑Datei erzeugt. Keine vagen Verweise, sondern eine vollständige, eigenständige Lösung. + +## Was Sie benötigen + +Bevor wir starten, stellen Sie sicher, dass Sie folgendes haben: + +- Java 11 oder neuer (die aktuelle LTS‑Version funktioniert perfekt) +- Maven oder Gradle zur Verwaltung der Abhängigkeiten (wir zeigen das Maven‑Snippet) +- Eine Internetverbindung für die Beispiel‑URL (`https://example.com`) oder jede andere Seite, die Sie erfassen möchten +- Ein beschreibbares Verzeichnis auf der Festplatte, in dem das PNG gespeichert wird + +Das war’s – keine zusätzlichen SDKs, keine nativen Binärdateien. Aspose.HTML übernimmt das schwere Heben intern. + +## Schritt 1: Aspose.HTML‑Abhängigkeit hinzufügen + +Zuerst binden Sie die Aspose.HTML‑Bibliothek in Ihr Projekt ein. Wenn Sie Maven verwenden, fügen Sie Folgendes zu Ihrer `pom.xml` hinzu: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Gradle‑Nutzer können das in `build.gradle` einfügen: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Pro‑Tipp:** Werfen Sie einen Blick in die [Aspose.HTML Release Notes](https://docs.aspose.com/html/java/), um die neueste Version zu finden; neuere Builds enthalten häufig Performance‑Optimierungen für das Rendering. + +## Schritt 2: HTML‑Dokument von einer URL laden + +Jetzt erstellen wir ein `HTMLDocument`‑Objekt, das auf die Seite zeigt, die Sie erfassen möchten. Dieser Schritt ist das Kernstück von **wie man HTML zu PNG rendert**, weil die Bibliothek das Markup analysiert und intern ein DOM aufbaut. + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +Wenn Sie lieber eine lokale Datei verwenden, ersetzen Sie den URL‑String einfach durch einen Dateipfad wie `"file:///C:/mypage.html"`. + +## Schritt 3: Sandbox konfigurieren und Viewport‑Größe setzen + +Die Sandbox isoliert das Rendering von Ihrem Haupt‑Anwendungsthread und ermöglicht Ihnen, die virtuellen Geräteparameter zu definieren. Hier setzen wir **die Viewport‑Größe in Java**, um die Abmessungen des gerenderten Bitmaps zu steuern. + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +Warum eine Sandbox? Sie verhindert Nebeneffekte wie Netzwerk‑Requests, die außerhalb des Rendering‑Kontexts auftreten, und liefert deterministische Ergebnisse – besonders wichtig, wenn Sie den Code auf einem CI‑Server ausführen. + +## Schritt 4: Bild‑Speicheroptionen vorbereiten + +Aspose.HTML kann in viele Formate exportieren (PNG, JPEG, BMP usw.). Wir konfigurieren `ImageSaveOptions`, um die erste Seite des Dokuments zu exportieren und PNG als Ausgabeformat festzulegen. + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +Sie können `setPageNumber` auf `2` oder `-1` (alle Seiten) ändern, falls Sie eine mehrseitige Bildsequenz benötigen. + +## Schritt 5: Rendern und PNG‑Datei speichern + +Zum Schluss rufen Sie `save` auf dem `HTMLDocument` auf. Die Methode berücksichtigt alle zuvor festgelegten Sandbox‑Einstellungen und erzeugt einen pixel‑perfekten Screenshot. + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +Wenn Sie das Programm ausführen, sollte eine Konsolennachricht den Speicherort der Datei bestätigen. Öffnen Sie das PNG – Sie sehen die exakte visuelle Darstellung von `https://example.com` mit 1280 × 800 Pixel, gerendert mit einem Device‑Pixel‑Ratio von 2.0 (damit das Bild auf Retina‑Displays scharf wirkt). + +### Erwartete Ausgabe + +``` +✅ PNG saved to: rendered_page.png +``` + +Die resultierende `rendered_page.png` ist eine hochqualitative Bilddatei, bereit zum Einbetten in Berichte, E‑Mails oder UI‑Vorschauen. + +## Wie man HTML zu PNG rendert – Häufige Variationen + +### Andere Seitenabmessungen rendern + +Wenn Sie andere Dimensionen benötigen, ändern Sie einfach die Werte von `Size`: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### Device‑Pixel‑Ratio ändern + +Ein DPR von `1.0` liefert ein Bild in Standardauflösung, während `3.0` sehr hochdichte Bildschirme simuliert. Passen Sie den Wert nach Bedarf an: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Eigene Header oder Cookies hinzufügen + +Manchmal erfordert die Zielseite Authentifizierung. Sie können Header vor dem Laden injizieren: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Mehrere Seiten rendern + +Um jede Seite als separates PNG zu exportieren, iterieren Sie über die Seitenanzahl: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Fehlersuche + +- **Leeres Bild:** Stellen Sie sicher, dass die URL erreichbar ist und die Sandbox Internetzugriff hat. Wenn Sie hinter einem Proxy sitzen, setzen Sie die JVM‑Proxy‑Eigenschaften (`-Dhttp.proxyHost=…`). +- **Out‑of‑Memory‑Fehler:** Das Rendern sehr großer Viewports kann viel RAM verbrauchen. Reduzieren Sie die Viewport‑Größe oder senken Sie das DPR. +- **Fehlende Schriftarten:** Aspose.HTML verwendet standardmäßig System‑Fonts. Wenn Ihre Seite Web‑Fonts nutzt, stellen Sie sicher, dass sie erreichbar sind oder betten Sie sie via CSS `@font-face` ein. + +## Vollständiges Beispiel (Gesamter Code an einem Ort) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +Kopieren Sie das in Ihre IDE, passen Sie die URL oder den Ausgabepfad an und klicken Sie auf **Run**. Wenn alles korrekt eingerichtet ist, erhalten Sie innerhalb weniger Sekunden ein PNG. + +## Fazit + +In diesem Tutorial haben wir Ihnen gezeigt, **wie man eine HTML‑Seite als PNG in Java speichert**, die Feinheiten von **wie man HTML zu PNG rendert** erläutert und die genauen Schritte zum **Setzen der Viewport‑Größe in Java** demonstriert, um die Ausgabe präzise zu steuern. Sie besitzen nun ein wiederverwendbares Snippet, das Sie in jedes Java‑Projekt einbinden können – sei es ein Backend‑Service, der Thumbnails erzeugt, oder ein Test‑Harness, der visuelle Layouts validiert. + +### Was kommt als Nächstes? + +- Experimentieren Sie mit verschiedenen `DevicePixelRatio`‑Werten für retina‑fertige Assets. +- Kombinieren Sie diesen Ansatz mit einem headless Browser, um dynamische, JavaScript‑intensive Seiten zu erfassen. +- Erkunden Sie weitere Exportformate wie JPEG oder PDF, indem Sie `SaveFormat.PNG` durch `SaveFormat.JPEG` bzw. `SaveFormat.PDF` ersetzen. + +Passen Sie den Code gern an, teilen Sie Ihre Ergebnisse oder stellen Sie Fragen in den Kommentaren. Viel Spaß beim Rendern! + +![Screenshot der gerenderten HTML, gespeichert als PNG](https://example.com/placeholder.png "Beispiel: HTML‑Seite als PNG speichern") + +{{< /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 f8b92d079..51d8cd4ef 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 – Οδηγός βήμα‑βήμα](./convert-html-to-pdf-with-java-step-by-step-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, με παραμετροποίηση μεγέθους σελίδας για ακριβή έγγραφα. ### [Μετατροπή HTML σε MHTML](./convert-html-to-mhtml/) diff --git a/html/greek/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/greek/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..b5224bb6a --- /dev/null +++ b/html/greek/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,176 @@ +--- +category: general +date: 2026-03-17 +description: Μετατρέψτε HTML σε PDF χρησιμοποιώντας το Aspose HTML για Java. Μάθετε + πώς να ορίζετε το μέγεθος σελίδας PDF, να δημιουργείτε PDF από HTML και να εξάγετε + HTML ως PDF σε ένα ενιαίο σεμινάριο. +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: el +og_description: Μετατρέψτε γρήγορα HTML σε PDF. Αυτός ο οδηγός δείχνει πώς να ορίσετε + το μέγεθος σελίδας PDF, να δημιουργήσετε PDF από HTML και να εξάγετε HTML ως PDF + χρησιμοποιώντας το Aspose HTML για Java. +og_title: Μετατροπή HTML σε PDF με Java – Πλήρης Οδηγός Προγραμματισμού +tags: +- Aspose +- Java +- PDF generation +title: Μετατροπή HTML σε PDF με Java – Οδηγός βήμα‑προς‑βήμα +url: /el/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +with margins". We'll translate to Greek: "παράδειγμα μετατροπής html σε pdf που δείχνει σελίδα A4 με περιθώρια". Keep same attribute format. + +Now produce final content. + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Μετατροπή HTML σε PDF με Java – Οδηγός Βήμα‑Βήμα + +Έχετε χρειαστεί ποτέ να **convert HTML to PDF** αλλά δεν ήσασταν σίγουροι ποια βιβλιοθήκη θα σας δώσει πλήρη έλεγχο πάνω στο αποτέλεσμα; Δεν είστε μόνοι. Σε πολλά έργα — σκεφτείτε γεννήτριες τιμολογίων, εξαγωγείς αναφορών ή πλατφόρμες e‑learning — θα βρείτε την ανάγκη για έναν αξιόπιστο τρόπο να μετατρέψετε ιστοσελίδες σε εκτυπώσιμα PDF. + +Σε αυτό το tutorial θα περάσουμε βήμα‑βήμα από μια πλήρη, έτοιμη προς εκτέλεση λύση που **convert HTML to PDF**, σας επιτρέπει να **set PDF page size**, και δείχνει πώς να **generate PDF from HTML** διατηρώντας τον κώδικα καθαρό και συντηρήσιμο. Στο τέλος θα έχετε ένα επαναχρησιμοποιήσιμο snippet που μπορείτε να ενσωματώσετε σε οποιαδήποτε εφαρμογή Java. Χωρίς ασαφείς αναφορές, μόνο συγκεκριμένος κώδικας και σαφείς εξηγήσεις. + +## What You’ll Learn + +- Πώς να ρυθμίσετε **PdfSaveOptions** για να ορίσετε διαστάσεις σελίδας και περιθώρια. +- Η ακριβής κλήση που χρειάζεστε για **export HTML as PDF** χρησιμοποιώντας το Aspose.HTML for Java. +- Συμβουλές για τη διαχείριση της συμμόρφωσης PDF/A‑1b, η οποία είναι απαραίτητη για αρχειοθέτηση. +- Ένα πλήρες, εκτελέσιμο παράδειγμα που μπορείτε να αντιγράψετε‑επικολλήσετε και να προσαρμόσετε. + +**Prerequisites** – Θα χρειαστείτε Java 8 ή νεότερη, Maven ή Gradle για να κατεβάσετε τη βιβλιοθήκη Aspose.HTML, και ένα απλό αρχείο HTML που θέλετε να μετατρέψετε σε PDF. Αυτό είναι όλο· δεν απαιτούνται επιπλέον frameworks ή web servers. + +--- + +## Step 1: Set PDF Page Size and Margins + +Το πρώτο πράγμα που συνήθως θέλετε να ελέγξετε είναι το μέγεθος του τελικού εγγράφου. Είτε χρειάζεστε A4 για τα ευρωπαϊκά πρότυπα είτε Letter για τις ΗΠΑ, το Aspose σας επιτρέπει να το ορίσετε με ένα μόνο αντικείμενο. + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**Why this matters** – Χωρίς ρητή ρύθμιση του μεγέθους σελίδας, η βιβλιοθήκη μπορεί να προεπιλέξει US Letter, κάτι που μπορεί να χαλάσει τις διατάξεις για διεθνείς χρήστες. Οι τιμές των περιθωρίων είναι επίσης σε χιλιοστά, καθιστώντας εύκολο το ταίριασμα με σχέδια έτοιμα για εκτύπωση. + +> **Pro tip:** Αν χρειάζεστε προσαρμοσμένο μέγεθος, αντικαταστήστε το `PdfPageSize.A4` με `new com.aspose.html.saving.PdfPageSize(width, height)` όπου το πλάτος και το ύψος είναι σε points. + +--- + +## Step 2: Generate PDF from HTML + +Τώρα που ορίστηκε η μορφή εξόδου, η πραγματική μετατροπή είναι μια γραμμή κώδικα. Η μέθοδος `Converter.convert` διαχειρίζεται την ανάλυση του HTML, την εφαρμογή του CSS και την rasterization της σελίδας σε PDF. + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**How it works** – Στο παρασκήνιο, το Aspose διαβάζει το HTML, δημιουργεί ένα DOM, επιλύει εξωτερικούς πόρους (εικόνες, γραμματοσειρές, CSS), και στη συνέχεια γράφει κάθε αποδομένη σελίδα στο PDF stream. Επειδή περάσαμε το αντικείμενο `pdfSaveOptions`, η μηχανή σέβεται το μέγεθος σελίδας, τα περιθώρια και τις ρυθμίσεις συμμόρφωσης που ορίσαμε νωρίτερα. + +> **Common question:** *What if my HTML references images with relative paths?* +> Απλώς βεβαιωθείτε ότι ο τρέχων φάκελος της διαδικασίας Java ταιριάζει με τη θέση του αρχείου HTML, ή χρησιμοποιήστε απόλυτα URLs. Το Aspose θα φορτώσει αυτόματα τους πόρους. + +--- + +## Step 3: Export HTML as PDF – Full Working Example + +Συνδυάζοντας όλα τα παραπάνω, εδώ είναι μια αυτόνομη κλάση Java που μπορείτε να μεταγλωττίσετε και να εκτελέσετε. Περιλαμβάνει τις απαραίτητες εισαγωγές, διαχείριση εξαιρέσεων και σχόλια που εξηγούν κάθε μέρος. + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### Expected Result + +Αφού τρέξετε το πρόγραμμα, θα βρείτε το `output.pdf` στον ίδιο φάκελο που υποδείξατε. Ανοίξτε το με οποιονδήποτε προβολέα PDF — Adobe Reader, Foxit ή ακόμη και έναν browser — και θα δείτε μια πιστή απόδοση του `input.html`, με το μέγεθος σελίδας A4 και περιθώρια 20 mm που ορίσατε. Αν ενεργοποιήσατε το PDF/A‑1b, το αρχείο θα περιέχει επίσης τα απαραίτητα μεταδεδομένα για μακροπρόθεσμη διατήρηση. + +--- + +## Frequently Asked Questions & Edge Cases + +| Question | Answer | +|----------|--------| +| **Can I convert a URL instead of a local file?** | Yes. Replace the first argument with the URL string, e.g., `"https://example.com/report.html"`. | +| **What if I need a different page orientation?** | Use `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` before conversion. | +| **Is it possible to embed a custom font?** | Absolutely. Place the font file in the same directory as the HTML or reference it via `@font-face` in your CSS; Aspose will embed it automatically. | +| **How do I handle large HTML files that cause memory issues?** | Consider streaming the HTML or splitting it into sections and converting each part separately, then merging the PDFs with Aspose.PDF. | +| **Do I need a license for Aspose.HTML?** | A free evaluation license works for testing, but for production you’ll need a paid license to remove the evaluation watermark. | + +--- + +## Image Illustration + +Below is a quick screenshot of the generated PDF (placeholder image). The **alt** attribute uses the primary keyword, helping both SEO and accessibility. + +παράδειγμα μετατροπής html σε pdf που δείχνει σελίδα A4 με περιθώρια + +--- + +## Wrap‑Up + +We’ve just covered how to **convert HTML to PDF** using Aspose.HTML for Java, how to **set PDF page size**, and the exact steps to **generate PDF from HTML** while keeping the process simple enough for beginners and flexible enough for seasoned developers. + +If you’re ready to go further, try experimenting with: + +- Different page sizes (`PdfPageSize.LETTER`, custom dimensions). +- Adding watermarks or headers/footers via `PdfSaveOptions`. +- Converting multiple HTML files in a loop and merging them into a single PDF. + +These extensions build on the same core concepts we explored, so you’ll feel comfortable adapting the code to fit any workflow. + +**Happy coding!** If you hit any snags, drop a comment below or check the Aspose documentation for deeper dives into advanced features. + +{{< /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-various-image-formats/_index.md b/html/greek/java/conversion-html-to-various-image-formats/_index.md index 1827545cc..2cb90048f 100644 --- a/html/greek/java/conversion-html-to-various-image-formats/_index.md +++ b/html/greek/java/conversion-html-to-various-image-formats/_index.md @@ -99,6 +99,7 @@ weight: 24 ### [Μετατροπή HTML σε TIFF](./convert-html-to-tiff/) Μάθετε πώς να μετατρέπετε εύκολα HTML σε TIFF χρησιμοποιώντας το Aspose.HTML για Java. Οδηγός βήμα‑βήμα για αποτελεσματική διαχείριση εγγράφων. ### [Μετατροπή HTML σε WebP – Πλήρης Οδηγός Java με Aspose.HTML](./convert-html-to-webp-complete-java-guide-with-aspose-html/) +### [Αποθήκευση σελίδας HTML ως PNG σε Java – Πλήρης Οδηγός](./save-html-page-as-png-in-java-complete-tutorial/) ## Συχνές Ερωτήσεις diff --git a/html/greek/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/greek/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..cff9b6830 --- /dev/null +++ b/html/greek/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,234 @@ +--- +category: general +date: 2026-03-17 +description: Μάθετε πώς να αποθηκεύετε μια σελίδα HTML ως PNG γρήγορα. Αυτός ο οδηγός + δείχνει πώς να αποδίδετε HTML σε PNG και να ορίζετε το μέγεθος του viewport σε Java + χρησιμοποιώντας το Aspose.HTML. +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: el +og_description: Αποθηκεύστε τη σελίδα HTML ως PNG με Java. Ακολουθήστε αυτό το σεμινάριο + για να μάθετε πώς να αποδίδετε HTML σε PNG και να ορίσετε το μέγεθος του viewport + με Java χρησιμοποιώντας το Aspose.HTML. +og_title: Αποθήκευση σελίδας HTML ως PNG σε Java – Οδηγός βήμα‑προς‑βήμα +tags: +- Java +- AsposeHTML +- Image Rendering +title: Αποθήκευση σελίδας HTML ως PNG σε Java – Πλήρης οδηγός +url: /el/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Αποθήκευση σελίδας HTML ως PNG σε Java – Πλήρης Οδηγός + +Έχετε χρειαστεί ποτέ να **αποθηκεύσετε σελίδα HTML ως PNG** αλλά δεν ήξερατε από πού να ξεκινήσετε; Δεν είστε μόνοι—πολλοί προγραμματιστές αντιμετωπίζουν αυτό το πρόβλημα όταν χρειάζονται ένα γρήγορο στιγμιότυπο μιας ιστοσελίδας για αναφορές, μικρογραφίες ή δοκιμές. Σε αυτόν τον οδηγό θα περάσουμε βήμα‑βήμα από το **πώς να αποδώσετε HTML σε PNG** χρησιμοποιώντας το Aspose.HTML for Java, και θα σας δείξουμε επίσης πώς να **ορίσετε το μέγεθος του viewport σε Java** ώστε το αποτέλεσμα να φαίνεται ακριβώς όπως το περιμένετε. + +Θα καλύψουμε τα πάντα, από την εγκατάσταση της βιβλιοθήκης μέχρι τη ρύθμιση του λόγου συσκευής (device pixel ratio), και στο τέλος θα έχετε ένα έτοιμο‑για‑εκτέλεση πρόγραμμα που παράγει ένα καθαρό αρχείο PNG από οποιοδήποτε URL. Χωρίς ασαφείς αναφορές, μόνο μια πλήρης, αυτόνομη λύση. + +## Τι Θα Χρειαστείτε + +Πριν ξεκινήσουμε, βεβαιωθείτε ότι έχετε: + +- Java 11 ή νεότερη (η τρέχουσα LTS έκδοση λειτουργεί τέλεια) +- Maven ή Gradle για διαχείριση εξαρτήσεων (θα δείξουμε το απόσπασμα για Maven) +- Σύνδεση στο διαδίκτυο για το δείγμα URL (`https://example.com`) ή οποιαδήποτε σελίδα θέλετε να καταγράψετε +- Έναν εγγράψιμο φάκελο στον δίσκο όπου θα αποθηκευτεί το PNG + +Αυτό είναι όλο—χωρίς επιπλέον SDKs, χωρίς εγγενή binaries. Το Aspose.HTML αναλαμβάνει τη βαριά δουλειά εσωτερικά. + +## Βήμα 1: Προσθήκη Εξάρτησης Aspose.HTML + +Πρώτα, προσθέστε τη βιβλιοθήκη Aspose.HTML στο έργο σας. Αν χρησιμοποιείτε Maven, προσθέστε το παρακάτω στο `pom.xml`: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Οι χρήστες Gradle μπορούν να τοποθετήσουν αυτό στο `build.gradle`: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Pro tip:** Ελέγξτε τις [σημειώσεις έκδοσης του Aspose.HTML](https://docs.aspose.com/html/java/) για την πιο πρόσφατη έκδοση· τα νεότερα builds συχνά περιλαμβάνουν βελτιώσεις απόδοσης για την απόδοση. + +## Βήμα 2: Φόρτωση του HTML Document από URL + +Τώρα θα δημιουργήσουμε ένα αντικείμενο `HTMLDocument` που δείχνει στη σελίδα που θέλετε να καταγράψετε. Αυτό το βήμα είναι η καρδιά του **πώς να αποδώσετε HTML σε PNG** επειδή η βιβλιοθήκη αναλύει το markup και δημιουργεί ένα DOM εσωτερικά. + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +Αν προτιμάτε τοπικό αρχείο, απλώς αντικαταστήστε τη συμβολοσειρά URL με μια διαδρομή αρχείου όπως `"file:///C:/mypage.html"`. + +## Βήμα 3: Διαμόρφωση του Sandbox και Ορισμός Μεγέθους Viewport + +Το sandbox απομονώνει την απόδοση από το κύριο νήμα της εφαρμογής σας και σας επιτρέπει να ορίσετε τις εικονικές χαρακτηριστικές της συσκευής. Εδώ είναι που **ορίζουμε το μέγεθος του viewport σε Java** για να ελέγξουμε τις διαστάσεις του παραγόμενου bitmap. + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +Γιατί να χρησιμοποιήσετε sandbox; Αποτρέπει παρενέργειες όπως αιτήματα δικτύου που διαρρέουν εκτός του πλαισίου απόδοσης και παρέχει ντετερμινιστικά αποτελέσματα—ιδιαίτερα σημαντικό όταν τρέχετε τον κώδικα σε CI server. + +## Βήμα 4: Προετοιμασία Επιλογών Αποθήκευσης Εικόνας + +Το Aspose.HTML μπορεί να εξάγει σε πολλές μορφές (PNG, JPEG, BMP κ.λπ.). Θα διαμορφώσουμε το `ImageSaveOptions` ώστε να στοχεύει την πρώτη σελίδα του εγγράφου και να ορίσουμε το PNG ως μορφή εξόδου. + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +Μπορείτε να αλλάξετε το `setPageNumber` σε `2` ή `-1` (όλες οι σελίδες) αν χρειάζεστε ακολουθία εικόνων πολλαπλών σελίδων. + +## Βήμα 5: Απόδοση και Αποθήκευση του Αρχείου PNG + +Τέλος, καλέστε `save` στο `HTMLDocument`. Η μέθοδος σέβεται όλες τις ρυθμίσεις sandbox που εφαρμόσαμε νωρίτερα, παράγοντας ένα pixel‑perfect στιγμιότυπο. + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +Όταν εκτελέσετε το πρόγραμμα, θα δείτε ένα μήνυμα στην κονσόλα που επιβεβαιώνει τη θέση του αρχείου. Ανοίξτε το PNG—θα δείτε την ακριβή οπτική αναπαράσταση του `https://example.com` σε 1280 × 800 pixels, αποδομένο με λόγο συσκευής 2.0 (οπότε η εικόνα φαίνεται οξεία σε οθόνες Retina). + +### Αναμενόμενο Αποτέλεσμα + +``` +✅ PNG saved to: rendered_page.png +``` + +Το παραγόμενο `rendered_page.png` θα είναι ένα αρχείο εικόνας υψηλής ποιότητας, έτοιμο για ενσωμάτωση σε αναφορές, email ή προεπισκοπήσεις UI. + +## Πώς να Αποδώσετε HTML σε PNG – Συνηθισμένες Παραλλαγές + +### Απόδοση με Διαφορετικό Μέγεθος Σελίδας + +Αν χρειάζεστε διαφορετική διάσταση, απλώς αλλάξτε τις τιμές του `Size`: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### Αλλαγή του Λόγου Συσκευής (Device Pixel Ratio) + +Ένας DPR `1.0` δίνει μια εικόνα τυπικής ανάλυσης, ενώ `3.0` μιμείται πολύ πυκνές οθόνες. Ρυθμίστε το όπως χρειάζεται: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Προσθήκη Προσαρμοσμένων Headers ή Cookies + +Μερικές φορές η στόχευση σελίδα απαιτεί έλεγχο ταυτότητας. Μπορείτε να εισάγετε headers πριν τη φόρτωση: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Απόδοση Πολλαπλών Σελίδων + +Για εξαγωγή κάθε σελίδας ως ξεχωριστό PNG, κάντε βρόχο πάνω στον αριθμό σελίδων: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Συμβουλές Επίλυσης Προβλημάτων + +- **Κενή Εικόνα:** Βεβαιωθείτε ότι το URL είναι προσβάσιμο και ότι το sandbox έχει πρόσβαση στο διαδίκτυο. Αν βρίσκεστε πίσω από proxy, ορίστε τις ιδιότητες proxy του JVM (`-Dhttp.proxyHost=…`). +- **Σφάλματα Out‑of‑Memory:** Η απόδοση πολύ μεγάλων viewport μπορεί να καταναλώσει πολύ RAM. Μειώστε το μέγεθος του viewport ή το DPR. +- **Λείπουν Γραμματοσειρές:** Το Aspose.HTML χρησιμοποιεί τις συστημικές γραμματοσειρές εξ ορισμού. Αν η σελίδα σας βασίζεται σε web fonts, βεβαιωθείτε ότι είναι προσβάσιμα ή ενσωματώστε τα μέσω CSS `@font-face`. + +## Πλήρες Παράδειγμα Εργασίας (Όλος ο Κώδικας σε Ένα Σημείο) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +Αντιγράψτε‑και‑επικολλήστε αυτό στο IDE σας, προσαρμόστε το URL ή τη διαδρομή εξόδου, και πατήστε **Run**. Αν όλα είναι ρυθμισμένα σωστά, θα έχετε ένα PNG σε δευτερόλεπτα. + +## Συμπέρασμα + +Σε αυτόν τον οδηγό σας δείξαμε **πώς να αποθηκεύσετε σελίδα HTML ως PNG** χρησιμοποιώντας Java, καλύψαμε τις λεπτομέρειες του **πώς να αποδώσετε HTML σε PNG**, και παρουσιάσαμε τα ακριβή βήματα για **ορισμό μεγέθους viewport σε Java** για ακριβή έλεγχο του αποτελέσματος. Τώρα έχετε ένα επαναχρησιμοποιήσιμο snippet που μπορεί να ενσωματωθεί σε οποιοδήποτε έργο Java—είτε πρόκειται για υπηρεσία backend που δημιουργεί μικρογραφίες είτε για δοκιμαστικό περιβάλλον που επαληθεύει οπτικές διατάξεις. + +### Τι Ακολουθεί; + +- Πειραματιστείτε με διαφορετικές τιμές `DevicePixelRatio` για assets έτοιμα για retina. +- Συνδυάστε αυτήν την προσέγγιση με έναν headless browser για καταγραφή δυναμικών, JavaScript‑βαριών σελίδων. +- Εξερευνήστε άλλες μορφές εξαγωγής όπως JPEG ή PDF αντικαθιστώντας το `SaveFormat.PNG` με `SaveFormat.JPEG` ή `SaveFormat.PDF`. + +Μη διστάσετε να τροποποιήσετε τον κώδικα, να μοιραστείτε τα αποτελέσματά σας ή να θέσετε ερωτήσεις στα σχόλια. Καλή απόδοση! + +![Στιγμιότυπο HTML αποθηκευμένο ως PNG](https://example.com/placeholder.png "παράδειγμα αποθήκευσης html σε png") + +{{< /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 1c90698de..00fc13b11 100644 --- a/html/hindi/java/conversion-html-to-other-formats/_index.md +++ b/html/hindi/java/conversion-html-to-other-formats/_index.md @@ -103,8 +103,10 @@ Aspose.HTML के साथ Java में SVG को PDF में बदल ### [SVG को XPS में बदलना](./convert-svg-to-xps/) Aspose.HTML for Java के साथ SVG को XPS में कैसे बदलें सीखें। सहज रूपांतरण के लिए सरल, चरण‑दर‑चरण गाइड। +### [Java के साथ HTML को PDF में बदलें – चरण‑दर‑चरण गाइड](./convert-html-to-pdf-with-java-step-by-step-guide/) +Aspose.HTML for Java का उपयोग करके HTML को PDF में चरण‑दर‑चरण रूप से बदलें। + ### [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/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/hindi/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..042eb4d5b --- /dev/null +++ b/html/hindi/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,162 @@ +--- +category: general +date: 2026-03-17 +description: Aspose HTML for Java का उपयोग करके HTML को PDF में बदलें। एक ही ट्यूटोरियल + में PDF पेज साइज सेट करना, HTML से PDF जनरेट करना और HTML को PDF के रूप में एक्सपोर्ट + करना सीखें। +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: hi +og_description: HTML को PDF में जल्दी बदलें। यह गाइड दिखाता है कि PDF पेज आकार कैसे + सेट करें, HTML से PDF बनाएं, और Aspose HTML for Java का उपयोग करके HTML को PDF के + रूप में निर्यात करें। +og_title: जावा के साथ HTML को PDF में बदलें – पूर्ण प्रोग्रामिंग गाइड +tags: +- Aspose +- Java +- PDF generation +title: जावा के साथ HTML को PDF में बदलें – चरण-दर-चरण गाइड +url: /hi/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Java के साथ HTML को PDF में बदलें – चरण‑दर‑चरण गाइड + +क्या आपको कभी **HTML को PDF में बदलने** की ज़रूरत पड़ी है लेकिन यह नहीं पता था कि कौन सी लाइब्रेरी आउटपुट पर पूर्ण नियंत्रण देगी? आप अकेले नहीं हैं। कई प्रोजेक्ट्स—जैसे इनवॉइस जेनरेटर, रिपोर्ट एक्सपोर्टर, या ई‑लर्निंग प्लेटफ़ॉर्म—में आपको वेब पेजों को प्रिंटेबल PDF में बदलने का भरोसेमंद तरीका चाहिए होगा। + +इस ट्यूटोरियल में हम एक पूर्ण, तैयार‑चलाने‑योग्य समाधान के माध्यम से चलेंगे जो **HTML को PDF में बदलता** है, आपको **PDF पेज साइज सेट करने** देता है, और दिखाता है कि **HTML से PDF कैसे जेनरेट करें** जबकि कोड को साफ़ और मेंटेनेबल रखें। अंत तक आपके पास एक पुन: उपयोग योग्य स्निपेट होगा जिसे आप किसी भी Java एप्लिकेशन में डाल सकते हैं। कोई अस्पष्ट रेफ़रेंस नहीं, सिर्फ ठोस कोड और स्पष्ट व्याख्याएँ। + +## आप क्या सीखेंगे + +- **PdfSaveOptions** को कॉन्फ़िगर करके पेज डायमेंशन और मार्जिन कैसे परिभाषित करें। +- Aspose.HTML for Java का उपयोग करके **HTML को PDF के रूप में एक्सपोर्ट** करने के लिए आवश्यक सटीक कॉल। +- PDF/A‑1b अनुपालन को संभालने के टिप्स, जो आर्काइविंग के लिए आवश्यक है। +- एक पूर्ण, चलाने योग्य उदाहरण जिसे आप कॉपी‑पेस्ट करके अनुकूलित कर सकते हैं। + +**Prerequisites** – आपको Java 8 या उससे नया, Maven या Gradle की आवश्यकता होगी ताकि Aspose.HTML लाइब्रेरी को पुल किया जा सके, और एक साधारण HTML फ़ाइल जो आप PDF में बदलना चाहते हैं। बस इतना ही; कोई अतिरिक्त फ्रेमवर्क या वेब सर्वर की जरूरत नहीं। + +--- + +## चरण 1: PDF पेज साइज और मार्जिन सेट करें + +आमतौर पर पहला चीज़ जिसे आप नियंत्रित करना चाहते हैं वह है परिणामी दस्तावेज़ का आकार। चाहे आपको यूरोपीय मानकों के लिए A4 चाहिए या US के लिए Letter, Aspose आपको एक ही ऑब्जेक्ट के साथ इसे निर्दिष्ट करने देता है। + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**Why this matters** – पेज साइज को स्पष्ट रूप से सेट नहीं करने पर लाइब्रेरी डिफ़ॉल्ट रूप से US Letter का उपयोग कर सकती है, जिससे अंतरराष्ट्रीय उपयोगकर्ताओं के लिए लेआउट बिगड़ सकता है। मार्जिन मान भी मिलीमीटर में होते हैं, जिससे प्रिंट‑रेडी डिज़ाइनों से मेल खाना आसान हो जाता है। + +> **Pro tip:** यदि आपको कस्टम साइज चाहिए, तो `PdfPageSize.A4` को `new com.aspose.html.saving.PdfPageSize(width, height)` से बदलें जहाँ width और height पॉइंट्स में हों। + +## चरण 2: HTML से PDF जेनरेट करें + +अब जब आउटपुट फ़ॉर्मेट परिभाषित हो गया है, वास्तविक रूपांतरण एक‑लाइनर है। `Converter.convert` मेथड HTML को पार्स करने, CSS लागू करने, और पेज को PDF में रास्टराइज़ करने का काम करता है। + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**How it works** – अंदरूनी तौर पर, Aspose HTML को पढ़ता है, एक DOM बनाता है, बाहरी रिसोर्सेज़ (इमेज़, फ़ॉन्ट, CSS) को रिज़ॉल्व करता है, और फिर प्रत्येक रेंडर किए गए पेज को PDF स्ट्रीम में लिखता है। क्योंकि हमने `pdfSaveOptions` ऑब्जेक्ट पास किया है, इंजन पेज साइज, मार्जिन, और कॉम्प्लायंस सेटिंग्स का सम्मान करता है जो हमने पहले परिभाषित किए थे। + +> **Common question:** *अगर मेरा HTML रिलेटिव पाथ वाले इमेज़ रेफ़र करता है तो क्या होगा?* +> बस यह सुनिश्चित करें कि आपके Java प्रोसेस की वर्किंग डायरेक्टरी HTML फ़ाइल के स्थान से मेल खाती हो, या एब्सोल्यूट URL उपयोग करें। Aspose स्वचालित रूप से रिसोर्सेज़ को फ़ेच कर लेगा। + +## चरण 3: HTML को PDF के रूप में एक्सपोर्ट करें – पूर्ण कार्यशील उदाहरण + +सभी भागों को जोड़ते हुए, यहाँ एक स्व-समाहित Java क्लास है जिसे आप कंपाइल और रन कर सकते हैं। इसमें आवश्यक इम्पोर्ट्स, एक्सेप्शन हैंडलिंग, और प्रत्येक भाग को समझाने वाले कमेंट्स शामिल हैं। + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### अपेक्षित परिणाम + +प्रोग्राम चलाने के बाद, आपको `output.pdf` उसी फ़ोल्डर में मिलेगा जहाँ आपने इसे पॉइंट किया था। इसे किसी भी PDF व्यूअर—Adobe Reader, Foxit, या यहाँ तक कि ब्राउज़र—से खोलें और आपको `input.html` का सटीक रेंडरिंग दिखेगा, जिसमें आपने सेट किया हुआ A4 पेज साइज और 20 mm मार्जिन शामिल है। यदि आपने PDF/A‑1b सक्षम किया है, तो फ़ाइल में दीर्घकालिक संरक्षण के लिए आवश्यक मेटाडेटा भी होगा। + +## अक्सर पूछे जाने वाले प्रश्न और किनारे के मामलों + +| प्रश्न | उत्तर | +|----------|--------| +| **क्या मैं स्थानीय फ़ाइल के बजाय URL को कनवर्ट कर सकता हूँ?** | हाँ। पहले आर्ग्यूमेंट को URL स्ट्रिंग से बदलें, जैसे `"https://example.com/report.html"`। | +| **अगर मुझे अलग पेज ओरिएंटेशन चाहिए तो?** | कनवर्ज़न से पहले `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` उपयोग करें। | +| **क्या कस्टम फ़ॉन्ट एम्बेड करना संभव है?** | बिल्कुल। फ़ॉन्ट फ़ाइल को HTML के समान डायरेक्टरी में रखें या अपने CSS में `@font-face` के माध्यम से रेफ़र करें; Aspose इसे स्वचालित रूप से एम्बेड कर देगा। | +| **बड़े HTML फ़ाइलों से मेमोरी इश्यू कैसे संभालें?** | HTML को स्ट्रीम करने या सेक्शन में विभाजित करके प्रत्येक भाग को अलग‑अलग कनवर्ट करने पर विचार करें, फिर Aspose.PDF के साथ PDFs को मर्ज करें। | +| **क्या Aspose.HTML के लिए लाइसेंस चाहिए?** | परीक्षण के लिए एक फ्री इवैल्यूएशन लाइसेंस काम करता है, लेकिन प्रोडक्शन में इवैल्यूएशन वॉटरमार्क हटाने के लिए आपको पेड लाइसेंस चाहिए। | + +## Image Illustration + +नीचे जेनरेट किए गए PDF की एक त्वरित स्क्रीनशॉट (प्लेसहोल्डर इमेज) है। **alt** एट्रिब्यूट मुख्य कीवर्ड का उपयोग करता है, जिससे SEO और एक्सेसेबिलिटी दोनों को मदद मिलती है। + +convert html to pdf example showing A4 page with margins + +## Wrap‑Up + +हमने अभी-अभी Aspose.HTML for Java का उपयोग करके **HTML को PDF में बदलना**, **PDF पेज साइज सेट करना**, और **HTML से PDF जेनरेट करने** के सटीक चरणों को कवर किया, जबकि प्रक्रिया को शुरुआती लोगों के लिए सरल और अनुभवी डेवलपर्स के लिए लचीला रखा। + +अगर आप आगे बढ़ने के लिए तैयार हैं, तो इन चीज़ों के साथ प्रयोग करें: + +- विभिन्न पेज साइज (`PdfPageSize.LETTER`, कस्टम डाइमेंशन)। +- `PdfSaveOptions` के माध्यम से वॉटरमार्क या हेडर/फ़ूटर जोड़ना। +- लूप में कई HTML फ़ाइलों को कनवर्ट करना और उन्हें एक ही PDF में मर्ज करना। + +ये एक्सटेंशन उसी कोर कॉन्सेप्ट्स पर आधारित हैं जिन्हें हमने खोजा, इसलिए आप किसी भी वर्कफ़्लो में कोड को अनुकूलित करने में सहज महसूस करेंगे। + +**Happy coding!** अगर आपको कोई समस्या आती है, तो नीचे कमेंट करें या उन्नत फीचर्स के लिए Aspose डॉक्यूमेंटेशन देखें। + +{{< /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-various-image-formats/_index.md b/html/hindi/java/conversion-html-to-various-image-formats/_index.md index 80e69492a..f048e64cf 100644 --- a/html/hindi/java/conversion-html-to-various-image-formats/_index.md +++ b/html/hindi/java/conversion-html-to-various-image-formats/_index.md @@ -110,6 +110,9 @@ Aspose.HTML for Java के साथ HTML को JPEG में कैसे ### [HTML को PNG में बदलना](./convert-html-to-png/) Aspose.HTML के साथ Java में HTML को PNG इमेज में कैसे बदलें सीखें। चरण‑दर‑चरण निर्देशों के साथ एक व्यापक गाइड। +### [HTML पेज को PNG के रूप में सहेजें Java में – पूर्ण ट्यूटोरियल](./save-html-page-as-png-in-java-complete-tutorial/) +Aspose.HTML for Java का उपयोग करके HTML पेज को PNG इमेज के रूप में सहेजने के पूर्ण चरण‑दर‑चरण गाइड। + ### [HTML को TIFF में बदलना](./convert-html-to-tiff/) Aspose.HTML for Java का उपयोग करके HTML को TIFF में आसानी से कैसे बदलें सीखें। प्रभावी दस्तावेज़ हैंडलिंग के लिए चरण‑दर‑चरण गाइड। diff --git a/html/hindi/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/hindi/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..b8a9a9d43 --- /dev/null +++ b/html/hindi/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,232 @@ +--- +category: general +date: 2026-03-17 +description: जानिए कैसे जल्दी से HTML पेज को PNG के रूप में सहेजा जाए। यह गाइड दिखाता + है कि Aspose.HTML का उपयोग करके Java में HTML को PNG में कैसे रेंडर किया जाए और + व्यूपोर्ट आकार कैसे सेट किया जाए। +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: hi +og_description: Java के साथ HTML पेज को PNG के रूप में सहेजें। इस ट्यूटोरियल का पालन + करके सीखें कि Aspose.HTML का उपयोग करके HTML को PNG में कैसे रेंडर करें और Java + में व्यूपोर्ट आकार कैसे सेट करें। +og_title: जावा में HTML पेज को PNG के रूप में सहेजें – चरण-दर-चरण गाइड +tags: +- Java +- AsposeHTML +- Image Rendering +title: जावा में HTML पेज को PNG के रूप में सहेजें – पूर्ण ट्यूटोरियल +url: /hi/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Java में HTML पेज को PNG के रूप में सहेजें – पूर्ण ट्यूटोरियल + +क्या आपको कभी **save HTML page as PNG** करने की ज़रूरत पड़ी लेकिन शुरुआत नहीं पता थी? आप अकेले नहीं हैं—कई डेवलपर्स को रिपोर्ट, थंबनेल या टेस्टिंग के लिए वेब पेज की जल्दी स्क्रीनशॉट चाहिए होती है और वे इस समस्या में फँस जाते हैं। इस गाइड में हम Aspose.HTML for Java का उपयोग करके **how to render HTML to PNG** की प्रक्रिया दिखाएंगे, और साथ ही **set viewport size Java** कैसे सेट करें ताकि आउटपुट बिल्कुल वैसा ही दिखे जैसा आप चाहते हैं। + +हम लाइब्रेरी को इंस्टॉल करने से लेकर डिवाइस पिक्सेल रेशियो को ट्यून करने तक सब कवर करेंगे, और अंत में आपके पास एक तैयार‑टू‑रन प्रोग्राम होगा जो किसी भी URL से एक स्पष्ट PNG फ़ाइल बनाता है। कोई अस्पष्ट रेफ़रेंस नहीं, सिर्फ एक पूर्ण, स्व-निहित समाधान। + +## आपको क्या चाहिए + +- Java 11 या नया (वर्तमान LTS संस्करण पूरी तरह काम करता है) +- Maven या Gradle निर्भरताओं को प्रबंधित करने के लिए (हम Maven स्निपेट दिखाएंगे) +- नमूना URL (`https://example.com`) या कोई भी पेज जिसे आप कैप्चर करना चाहते हैं, के लिए इंटरनेट कनेक्शन +- डिस्क पर एक लिखने योग्य डायरेक्टरी जहाँ PNG सहेजा जाएगा + +बस इतना ही—कोई अतिरिक्त SDKs नहीं, कोई नेटिव बाइनरी नहीं। Aspose.HTML अंदरूनी रूप से सभी भारी काम संभालता है। + +## चरण 1: Aspose.HTML निर्भरता जोड़ें + +सबसे पहले, Aspose.HTML लाइब्रेरी को अपने प्रोजेक्ट में जोड़ें। यदि आप Maven उपयोग करते हैं, तो अपने `pom.xml` में निम्नलिखित जोड़ें: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Gradle उपयोगकर्ता इसे `build.gradle` में डाल सकते हैं: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Pro tip:** नवीनतम संस्करण के लिए [Aspose.HTML रिलीज़ नोट्स](https://docs.aspose.com/html/java/) देखें; नए बिल्ड अक्सर रेंडरिंग के लिए प्रदर्शन सुधार शामिल करते हैं। + +## चरण 2: Load the HTML Document from a URL + +अब हम एक `HTMLDocument` ऑब्जेक्ट बनाएँगे जो उस पेज की ओर इशारा करता है जिसे आप कैप्चर करना चाहते हैं। यह चरण **how to render HTML to PNG** का मुख्य भाग है क्योंकि लाइब्रेरी मार्कअप को पार्स करती है और आंतरिक रूप से DOM बनाती है। + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +यदि आप स्थानीय फ़ाइल पसंद करते हैं, तो केवल URL स्ट्रिंग को `"file:///C:/mypage.html"` जैसी फ़ाइल पाथ से बदल दें। + +## चरण 3: Configure the Sandbox and Set Viewport Size + +सैंडबॉक्स रेंडरिंग को आपके मुख्य एप्लिकेशन थ्रेड से अलग करता है और आपको वर्चुअल डिवाइस की विशेषताएँ निर्धारित करने देता है। यहाँ हम **set viewport size Java** का उपयोग करके रेंडर किए गए बिटमैप के आयाम नियंत्रित करते हैं। + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +सैंडबॉक्स की ज़रूरत क्यों? यह नेटवर्क अनुरोधों जैसे साइड‑इफ़ेक्ट्स को रेंडरिंग कॉन्टेक्स्ट के बाहर लीक होने से रोकता है, और यह आपको निर्धारक परिणाम देता है—विशेषकर जब आप कोड को CI सर्वर पर चलाते हैं। + +## चरण 4: Prepare Image Save Options + +Aspose.HTML कई फ़ॉर्मेट (PNG, JPEG, BMP, आदि) में एक्सपोर्ट कर सकता है। हम `ImageSaveOptions` को कॉन्फ़िगर करेंगे ताकि दस्तावेज़ के पहले पेज को लक्ष्य बनाया जाए और आउटपुट फ़ॉर्मेट PNG हो। + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +यदि आपको मल्टी‑पेज इमेज सीक्वेंस चाहिए तो `setPageNumber` को `2` या `-1` (सभी पेज) में बदल सकते हैं। + +## चरण 5: Render and Save the PNG File + +अंत में, `HTMLDocument` पर `save` कॉल करें। यह मेथड पहले लागू किए गए सभी सैंडबॉक्स सेटिंग्स का सम्मान करता है, जिससे एक पिक्सेल‑परफेक्ट स्क्रीनशॉट बनता है। + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +जब आप प्रोग्राम चलाएँगे, तो आपको फ़ाइल लोकेशन की पुष्टि करने वाला कंसोल मैसेज दिखेगा। PNG खोलें—आपको `https://example.com` का बिल्कुल वही विज़ुअल प्रतिनिधित्व 1280 × 800 पिक्सेल पर, डिवाइस पिक्सेल रेशियो 2.0 के साथ दिखेगा (जिससे इमेज Retina डिस्प्ले पर भी तेज़ दिखेगी)। + +### अपेक्षित आउटपुट + +``` +✅ PNG saved to: rendered_page.png +``` + +परिणामी `rendered_page.png` एक उच्च‑गुणवत्ता वाली इमेज फ़ाइल होगी, जिसे रिपोर्ट, ईमेल या UI प्रीव्यू में एम्बेड किया जा सकता है। + +## How to Render HTML to PNG – Common Variations + +### Rendering a Different Page Size + +यदि आपको अलग आयाम चाहिए, तो बस `Size` मानों को बदल दें: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### Changing the Device Pixel Ratio + +`1.0` का DPR आपको स्टैंडर्ड‑रिज़ॉल्यूशन इमेज देता है, जबकि `3.0` बहुत हाई‑डेंसिटी स्क्रीन का अनुकरण करता है। आवश्यकता अनुसार समायोजित करें: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Adding Custom Headers or Cookies + +कभी‑कभी लक्ष्य पेज को ऑथेंटिकेशन की ज़रूरत होती है। आप लोड करने से पहले हेडर इंजेक्ट कर सकते हैं: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Rendering Multiple Pages + +हर पेज को अलग PNG के रूप में एक्सपोर्ट करने के लिए, पेज काउंट पर लूप करें: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Troubleshooting Tips + +- **Blank Image:** सुनिश्चित करें कि URL पहुँच योग्य है और सैंडबॉक्स के पास इंटरनेट एक्सेस है। यदि आप प्रॉक्सी के पीछे हैं, तो JVM प्रॉक्सी प्रॉपर्टीज़ (`-Dhttp.proxyHost=…`) सेट करें। +- **Out‑of‑Memory Errors:** बहुत बड़े व्यूपोर्ट रेंडर करने से बहुत RAM खर्च हो सकता है। व्यूपोर्ट आकार घटाएँ या DPR कम करें। +- **Missing Fonts:** Aspose.HTML डिफ़ॉल्ट रूप से सिस्टम फ़ॉन्ट्स का उपयोग करता है। यदि आपका पेज वेब फ़ॉन्ट्स पर निर्भर है, तो सुनिश्चित करें कि वे पहुँच योग्य हों या CSS `@font-face` के माध्यम से एम्बेड करें। + +## Full Working Example (All Code in One Place) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +इसे अपने IDE में कॉपी‑पेस्ट करें, URL या आउटपुट पाथ समायोजित करें, और **Run** दबाएँ। यदि सब कुछ सही ढंग से सेट है, तो कुछ सेकंड में आपके पास एक PNG होगी। + +## निष्कर्ष + +इस ट्यूटोरियल में हमने Java का उपयोग करके **save HTML page as PNG** कैसे किया, **how to render HTML to PNG** के नुअन्सेस को कवर किया, और **set viewport size Java** के सटीक चरण दिखाए ताकि आउटपुट पर पूर्ण नियंत्रण हो। अब आपके पास एक पुन: उपयोग योग्य स्निपेट है जिसे किसी भी Java प्रोजेक्ट में डाला जा सकता है—चाहे वह थंबनेल जेनरेट करने वाली बैकएंड सेवा हो या विज़ुअल लेआउट वैलिडेट करने वाला टेस्ट हार्नेस। + +### आगे क्या? + +- विभिन्न `DevicePixelRatio` मानों के साथ प्रयोग करें ताकि retina‑रेडी एसेट्स बन सकें। +- इस दृष्टिकोण को हेडलेस ब्राउज़र के साथ मिलाकर डायनामिक, JavaScript‑हेवी पेजेज़ को कैप्चर करें। +- `SaveFormat.PNG` को `SaveFormat.JPEG` या `SaveFormat.PDF` से बदलकर JPEG या PDF जैसे अन्य एक्सपोर्ट फ़ॉर्मेट एक्सप्लोर करें। + +कोड को अपनी पसंद के अनुसार बदलें, अपने परिणाम साझा करें, या कमेंट्स में प्रश्न पूछें। Happy rendering! + +![PNG के रूप में सहेजे गए रेंडर किए गए HTML का स्क्रीनशॉट](https://example.com/placeholder.png "HTML पेज को PNG के रूप में सहेजने का उदाहरण") + +{{< /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 bcd12f00f..9dbf59613 100644 --- a/html/hongkong/java/conversion-html-to-other-formats/_index.md +++ b/html/hongkong/java/conversion-html-to-other-formats/_index.md @@ -83,6 +83,8 @@ Aspose.HTML for Java 簡化了 HTML‑to‑PDF 工作流程。請參考專屬教 ## Conversion - HTML to Other Formats Tutorials ### [Converting HTML to PDF](./convert-html-to-pdf/) 了解如何使用 Aspose.HTML 在 Java 中將 HTML 轉換為 PDF，輕鬆產生高品質的 PDF 文件。 +### [在 Java 中將 HTML 轉換為 PDF – 逐步指南](./convert-html-to-pdf-with-java-step-by-step-guide/) +提供使用 Aspose.HTML for Java 的完整步驟，將 HTML 檔案轉換為 PDF，操作簡單、效果高品質。 ### [在 Java 中將 HTML 轉換為 PDF – 逐步指南與頁面大小設定](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) 提供在 Java 中使用 Aspose.HTML 逐步將 HTML 轉換為 PDF，並設定頁面尺寸的完整教學。 ### [Converting HTML to MHTML](./convert-html-to-mhtml/) diff --git a/html/hongkong/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/hongkong/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..180fd7226 --- /dev/null +++ b/html/hongkong/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,170 @@ +--- +category: general +date: 2026-03-17 +description: 使用 Aspose HTML for Java 將 HTML 轉換為 PDF。了解如何設定 PDF 頁面尺寸、從 HTML 產生 PDF + 以及在同一教學中匯出 HTML 為 PDF。 +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: zh-hant +og_description: 快速將 HTML 轉換為 PDF。本指南說明如何設定 PDF 頁面大小、從 HTML 產生 PDF，以及使用 Aspose HTML + for Java 匯出 HTML 為 PDF。 +og_title: 使用 Java 將 HTML 轉換為 PDF – 完整程式設計指南 +tags: +- Aspose +- Java +- PDF generation +title: 使用 Java 將 HTML 轉換為 PDF – 步驟指南 +url: /zh-hant/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 使用 Java 將 HTML 轉換為 PDF – 步驟指南 + +是否曾需要 **將 HTML 轉換為 PDF**，卻不確定哪個函式庫能讓你完整掌控輸出結果？你並不孤單。在許多專案中——例如發票產生器、報表匯出或 e‑learning 平台——都會需要一個可靠的方式，將網頁轉成可列印的 PDF。 + +在本教學中，我們將一步步示範一個完整、可直接執行的解決方案，**將 HTML 轉換為 PDF**、**設定 PDF 頁面尺寸**，並說明如何 **從 HTML 產生 PDF**，同時保持程式碼的簡潔與可維護性。完成後，你將擁有一段可在任何 Java 應用程式中直接使用的重用程式碼。沒有模糊的說明，只有具體的程式碼與清晰的解釋。 + +## 你將學到什麼 + +- 如何設定 **PdfSaveOptions** 以定義頁面尺寸與邊距。 +- 使用 Aspose.HTML for Java **匯出 HTML 為 PDF** 的完整呼叫方式。 +- 處理 PDF/A‑1b 合規性的技巧，這對於長期保存相當重要。 +- 一個完整、可執行的範例，讓你直接 copy‑paste 後再加以調整。 + +**先備條件** – 需要 Java 8 或更新版本、Maven 或 Gradle 來取得 Aspose.HTML 套件，以及一個想要轉成 PDF 的簡易 HTML 檔案。就這些；不需要額外的框架或 Web 伺服器。 + +--- + +## 步驟 1：設定 PDF 頁面尺寸與邊距 + +通常第一件要控制的，就是最終文件的尺寸。無論是歐洲標準的 A4，或是美國的 Letter，Aspose 都能透過單一物件輕鬆指定。 + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**為什麼這很重要** – 若未明確設定頁面尺寸，函式庫可能會預設為 US Letter，這會導致國際使用者的版面配置錯亂。邊距單位為毫米，方便對應列印設計稿。 + +> **專業小技巧：** 若需要自訂尺寸，請將 `PdfPageSize.A4` 改為 `new com.aspose.html.saving.PdfPageSize(width, height)`，其中 width 與 height 以點 (point) 為單位。 + +--- + +## 步驟 2：從 HTML 產生 PDF + +在確定輸出格式後，實際的轉換只需要一行程式碼。`Converter.convert` 方法會負責解析 HTML、套用 CSS，並將頁面光柵化為 PDF。 + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**運作原理** – Aspose 會先讀取 HTML，建立 DOM，解析外部資源（圖片、字型、CSS），然後將每個渲染好的頁面寫入 PDF 串流。因為我們傳入了 `pdfSaveOptions` 物件，引擎會遵守先前設定的頁面尺寸、邊距與合規性選項。 + +> **常見問題：** *如果我的 HTML 使用相對路徑引用圖片怎麼辦？* +> 請確保 Java 程式的工作目錄與 HTML 檔案所在位置相同，或改用絕對 URL。Aspose 會自動下載這些資源。 + +--- + +## 步驟 3：匯出 HTML 為 PDF – 完整可執行範例 + +將前面的步驟整合起來，以下是一個可自行編譯執行的 Java 類別。它包含必要的匯入、例外處理，以及說明每個部分功能的註解。 + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### 預期結果 + +執行程式後，會在你指定的資料夾中產生 `output.pdf`。使用任何 PDF 閱讀器（Adobe Reader、Foxit，或瀏覽器）開啟，即可看到與 `input.html` 完全相同的渲染結果，且已套用 A4 頁面與 20 mm 邊距。如果啟用了 PDF/A‑1b，檔案還會包含長期保存所需的元資料。 + +--- + +## 常見問題與特殊情境 + +| 問題 | 解答 | +|----------|--------| +| **可以轉換 URL 而非本機檔案嗎？** | 可以。將第一個參數改為 URL 字串，例如 `"https://example.com/report.html"`。 | +| **如果需要不同的頁面方向該怎麼做？** | 在轉換前呼叫 `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` 即可。 | +| **能否嵌入自訂字型？** | 當然可以。將字型檔放在與 HTML 同一目錄，或在 CSS 中使用 `@font-face` 參考；Aspose 會自動嵌入。 | +| **大型 HTML 檔案導致記憶體不足該怎麼處理？** | 考慮以串流方式讀取 HTML，或將其切分為多個區段分別轉換，最後使用 Aspose.PDF 合併 PDF。 | +| **使用 Aspose.HTML 需要授權嗎？** | 評估授權可供測試使用，正式上線則需購買授權以移除評估浮水印。 | + +--- + +## 圖片說明 + +以下為產生的 PDF 快照（佔位圖）。**alt** 屬性使用主要關鍵字，有助於 SEO 與可及性。 + +convert html to pdf example showing A4 page with margins + +--- + +## 小結 + +我們剛剛介紹了如何使用 Aspose.HTML for Java **將 HTML 轉換為 PDF**、**設定 PDF 頁面尺寸**，以及完整的 **從 HTML 產生 PDF** 步驟，且流程足夠簡單適合新手，同時也具彈性供資深開發者擴充。 + +如果想更進一步，可嘗試以下方向： + +- 不同的頁面尺寸（`PdfPageSize.LETTER`、自訂尺寸）。 +- 透過 `PdfSaveOptions` 加入浮水印或頁首/頁尾。 +- 在迴圈中轉換多個 HTML 檔案，並使用 Aspose.PDF 合併成單一 PDF。 + +這些延伸功能皆建立在相同的核心概念上，讓你能輕鬆調整程式碼以符合任何工作流程。 + +**祝開發順利！** 如有任何問題，歡迎在下方留言，或參考 Aspose 官方文件深入了解進階功能。 + +{{< /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-various-image-formats/_index.md b/html/hongkong/java/conversion-html-to-various-image-formats/_index.md index c9fd2e665..f68fc1833 100644 --- a/html/hongkong/java/conversion-html-to-various-image-formats/_index.md +++ b/html/hongkong/java/conversion-html-to-various-image-formats/_index.md @@ -93,6 +93,9 @@ weight: 24 ### [將 HTML 轉換為 PNG](./convert-html-to-png/) 學習如何在 Java 中使用 Aspose.HTML 將 HTML 轉換為 PNG 圖像。完整教學提供詳細步驟說明。 +### [在 Java 中將 HTML 頁面另存為 PNG – 完整教學](./save-html-page-as-png-in-java-complete-tutorial/) +在 Java 中使用 Aspose.HTML 將 HTML 頁面保存為 PNG 圖像的完整教學，提供詳細步驟與範例程式碼。 + ### [將 HTML 轉換為 WebP](./convert-html-to-webp-complete-java-guide-with-aspose-html/) ### [將 HTML 轉換為 TIFF](./convert-html-to-tiff/) 了解如何使用 Aspose.HTML for Java 輕鬆將 HTML 轉換為 TIFF。提供高效的文件處理步驟說明。 diff --git a/html/hongkong/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/hongkong/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..6c00324c7 --- /dev/null +++ b/html/hongkong/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,234 @@ +--- +category: general +date: 2026-03-17 +description: 快速學習如何將 HTML 頁面儲存為 PNG。本指南示範如何使用 Aspose.HTML 在 Java 中將 HTML 轉換為 PNG 並設定視口大小。 +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: zh-hant +og_description: 使用 Java 將 HTML 頁面儲存為 PNG。跟隨本教學學習如何使用 Aspose.HTML 將 HTML 轉換為 PNG 並設定視口大小。 +og_title: 在 Java 中將 HTML 頁面儲存為 PNG – 步驟教學 +tags: +- Java +- AsposeHTML +- Image Rendering +title: 在 Java 中將 HTML 頁面另存為 PNG – 完整教學 +url: /zh-hant/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +with all sections. + +Let's craft translation. + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 在 Java 中將 HTML 頁面另存為 PNG – 完整教學 + +是否曾經需要 **將 HTML 頁面另存為 PNG**，卻不知從何下手？你並不孤單——許多開發者在需要快速截取網頁畫面以用於報告、縮圖或測試時，都會遇到這個問題。在本指南中，我們將示範如何使用 Aspose.HTML for Java **將 HTML 渲染為 PNG**，同時說明如何 **在 Java 中設定視口大小**，讓輸出結果完全符合預期。 + +我們會從安裝函式庫說起，直到調整裝置像素比（Device Pixel Ratio），最後提供一個可直接執行的程式，讓任何 URL 都能產生清晰的 PNG 檔案。內容完整、一步到位，沒有模糊的參考。 + +## 需要的環境 + +在開始之前，請確保您已具備以下條件： + +- Java 11 或更新版本（目前的 LTS 版即可完美運作） +- Maven 或 Gradle 來管理相依性（以下示範 Maven 片段） +- 可連網的環境，以取得範例 URL (`https://example.com`) 或您想要擷取的任何頁面 +- 一個可寫入的磁碟目錄，用來存放產生的 PNG + +就這些——不需要額外的 SDK，也不需要本機二進位檔。Aspose.HTML 會在內部處理所有繁重的工作。 + +## 第一步：加入 Aspose.HTML 相依性 + +首先，將 Aspose.HTML 函式庫加入您的專案。若使用 Maven，請在 `pom.xml` 中加入以下內容： + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Gradle 使用者則可將以下內容放入 `build.gradle`： + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **小技巧：** 請參考 [Aspose.HTML 版本說明](https://docs.aspose.com/html/java/) 取得最新版本；較新的建置通常會包含渲染效能的優化。 + +## 第二步：從 URL 載入 HTML 文件 + +接下來，我們會建立一個指向欲擷取頁面的 `HTMLDocument` 物件。這一步是 **將 HTML 渲染為 PNG** 的核心，因為函式庫會解析標記並在內部建構 DOM。 + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +如果您想使用本機檔案，只需將 URL 字串改成類似 `"file:///C:/mypage.html"` 的檔案路徑即可。 + +## 第三步：設定 Sandbox 並指定視口大小 + +Sandbox 會將渲染工作與主應用程式執行緒隔離，並讓您定義虛擬裝置的特性。這裡就是我們 **在 Java 中設定視口大小**，以控制渲染位圖的尺寸。 + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +為什麼要使用 Sandbox？它可以防止網路請求洩漏到渲染上下文之外，並提供可預測的結果——在 CI 伺服器上執行時尤其重要。 + +## 第四步：準備影像儲存選項 + +Aspose.HTML 支援多種格式（PNG、JPEG、BMP 等）。我們將 `ImageSaveOptions` 設定為只輸出文件的第一頁，並指定 PNG 為輸出格式。 + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +若需要多頁影像序列，可將 `setPageNumber` 改為 `2` 或 `-1`（全部頁面）。 + +## 第五步：渲染並儲存 PNG 檔案 + +最後，對 `HTMLDocument` 呼叫 `save`。此方法會遵循先前設定的 Sandbox 參數，產生像素完美的螢幕截圖。 + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +執行程式後，您應會在主控台看到確認檔案位置的訊息。打開 PNG，您會看到 `https://example.com` 在 1280 × 800 像素、裝置像素比 2.0（適合 Retina 螢幕）下的完整視覺呈現。 + +### 預期輸出 + +``` +✅ PNG saved to: rendered_page.png +``` + +產生的 `rendered_page.png` 會是一張高品質的影像檔，適合嵌入報告、電子郵件或 UI 預覽中。 + +## 如何將 HTML 渲染為 PNG – 常見變化 + +### 渲染不同的頁面尺寸 + +若需要其他尺寸，只要調整 `Size` 參數即可： + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### 調整裝置像素比（Device Pixel Ratio） + +`1.0` 會產生標準解析度影像，`3.0` 則模擬超高密度螢幕。依需求自行調整： + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### 加入自訂 Header 或 Cookie + +有時目標頁面需要驗證。您可以在載入前注入 Header： + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### 渲染多頁 + +若要將每一頁分別匯出為 PNG，可依頁數迴圈處理： + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## 疑難排解小技巧 + +- **空白影像：** 確認 URL 可達且 Sandbox 具備網路存取權限。若身處代理伺服器後方，請設定 JVM 代理屬性（`-Dhttp.proxyHost=…`）。 +- **記憶體不足：** 渲染過大的視口會消耗大量 RAM。請縮小視口尺寸或降低 DPR。 +- **缺少字型：** Aspose.HTML 預設使用系統字型。若頁面依賴 Web Font，請確保其可取得，或透過 CSS `@font-face` 內嵌字型。 + +## 完整範例（所有程式碼一次呈現） + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +將上述程式碼貼到您的 IDE，調整 URL 或輸出路徑後直接 **Run**。若環境設定正確，幾秒鐘內即可得到 PNG 檔案。 + +## 結語 + +本教學示範了如何使用 Java **將 HTML 頁面另存為 PNG**，說明了 **將 HTML 渲染為 PNG** 的細節，並演示了 **在 Java 中設定視口大小** 的完整步驟。現在您擁有一段可重複使用的程式碼，能輕鬆嵌入任何 Java 專案——無論是產生縮圖的後端服務，或是驗證視覺版面的測試工具。 + +### 接下來可以做什麼？ + +- 嘗試不同的 `DevicePixelRatio`，製作 Retina 準備的資產。 +- 結合無頭瀏覽器，捕捉動態、JavaScript 密集的頁面。 +- 透過將 `SaveFormat.PNG` 改為 `SaveFormat.JPEG` 或 `SaveFormat.PDF`，探索 JPEG、PDF 等其他匯出格式。 + +歡迎自行調整程式碼、分享成果，或在留言區提問。祝您渲染愉快！ + +![Screenshot of rendered HTML saved as PNG](https://example.com/placeholder.png "save html page as png example") + +{{< /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 1c7d52b93..c0cb9c9f9 100644 --- a/html/hungarian/java/conversion-html-to-other-formats/_index.md +++ b/html/hungarian/java/conversion-html-to-other-formats/_index.md @@ -85,6 +85,8 @@ Alakítsa át az SVG grafikákat XPS formátumba a készülékek közötti konzi Ismerje meg, hogyan konvertálhatja a HTML‑t PDF‑re Java‑ban az Aspose.HTML használatával. Készítsen magas minőségű PDF‑eket HTML tartalmából könnyedén. ### [HTML átalakítása PDF-re – Lépésről‑lépésre útmutató oldalméret beállításokkal](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) Ismerje meg, hogyan konvertálhatja a HTML‑t PDF‑re Java‑ban részletesen, oldalméret beállításokkal. +### [HTML átalakítása PDF-re Java‑ban – Lépésről‑lépésre útmutató](./convert-html-to-pdf-with-java-step-by-step-guide/) +Részletes útmutató a HTML PDF‑re konvertálásához Java‑ban az Aspose.HTML‑el, lépésről‑lépésre, beállításokkal és példakóddal. ### [HTML átalakítása MHTML-re](./convert-html-to-mhtml/) Könnyedén konvertálja a HTML‑t MHTML‑re az Aspose.HTML for Java segítségével. Kövesse lépésről‑lépésre útmutatónkat a hatékony HTML‑MHTML átalakításhoz. ### [HTML átalakítása XPS-re](./convert-html-to-xps/) diff --git a/html/hungarian/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/hungarian/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..a398958f1 --- /dev/null +++ b/html/hungarian/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,184 @@ +--- +category: general +date: 2026-03-17 +description: HTML konvertálása PDF-be az Aspose HTML for Java segítségével. Tanulja + meg, hogyan állíthatja be a PDF oldalméretét, hogyan generálhat PDF-et HTML-ből, + és hogyan exportálhat HTML-t PDF-be egyetlen útmutatóban. +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: hu +og_description: Konvertálja gyorsan a HTML-t PDF-re. Ez az útmutató bemutatja, hogyan + állítható be a PDF oldalmérete, hogyan generálhat PDF-et HTML-ből, és hogyan exportálhatja + a HTML-t PDF-be az Aspose HTML for Java használatával. +og_title: HTML konvertálása PDF-be Java-val – Teljes programozási útmutató +tags: +- Aspose +- Java +- PDF generation +title: HTML konvertálása PDF-re Java-val – Lépésről lépésre útmutató +url: /hu/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +Translate "Pro tip" etc. + +Translate "How it works", "Common question", etc. + +Translate table headings and content. + +Translate alt text. + +Translate wrap-up. + +Let's produce final content. + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML PDF-re konvertálása Java-val – Lépésről‑lépésre útmutató + +Valaha is szükséged volt **HTML PDF-re konvertálására**, de nem tudtad, melyik könyvtár adja meg a teljes irányítást a kimenetre? Nem vagy egyedül. Sok projektben – gondolj csak a számlagenerátorokra, jelentésexportálókra vagy e‑learning platformokra – megbízható módra van szükséged, hogy a weboldalakat nyomtatható PDF‑ekké alakítsd. + +Ebben az útmutatóban végigvezetünk egy teljes, azonnal futtatható megoldáson, amely **HTML‑t PDF‑re konvertál**, lehetővé teszi a **PDF oldalméret beállítását**, és megmutatja, hogyan **generálj PDF‑et HTML‑ből**, miközben a kód tiszta és karbantartható marad. A végére egy újrahasználható kódrészletet kapsz, amelyet bármely Java‑alkalmazásba beilleszthetsz. Nincsenek homályos hivatkozások, csak konkrét kód és világos magyarázatok. + +## Mit tanulhatsz meg + +- Hogyan konfiguráld a **PdfSaveOptions**‑t az oldalméretek és margók meghatározásához. +- A pontos hívás, amellyel **HTML‑t PDF‑ként exportálhatsz** az Aspose.HTML for Java segítségével. +- Tippek a PDF/A‑1b megfelelőség kezeléséhez, ami archiváláskor elengedhetetlen. +- Egy teljes, futtatható példa, amelyet egyszerűen másolhatsz‑beilleszthetsz és testre szabhatsz. + +**Előfeltételek** – szükséged lesz Java 8 vagy újabb verzióra, Maven‑re vagy Gradle‑re az Aspose.HTML könyvtár lehúzásához, és egy egyszerű HTML‑fájlra, amelyet PDF‑vé szeretnél alakítani. Ennyi; nincs szükség extra keretrendszerekre vagy webszerverekre. + +--- + +## 1. lépés: PDF oldalméret és margók beállítása + +Az első dolog, amit általában irányítani szeretnél, a létrejövő dokumentum mérete. Legyen szó A4‑ről az európai szabványokhoz vagy Letter‑ről az USA‑ban, az Aspose egyetlen objektummal lehetővé teszi a megadását. + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**Miért fontos** – Ha nem állítod be kifeexplicit módon az oldalméretet, a könyvtár alapértelmezés szerint US Letter‑t használhat, ami a nemzetközi felhasználók számára eltorzíthatja a layout‑ot. A margó értékek milliméterben vannak megadva, így könnyen illeszthetőek a nyomtatásra kész tervekhez. + +> **Pro tipp:** Ha egyedi méretre van szükséged, cseréld le a `PdfPageSize.A4`‑t `new com.aspose.html.saving.PdfPageSize(width, height)`‑re, ahol a szélesség és magasság pontban van megadva. + +--- + +## 2. lépés: PDF generálása HTML‑ből + +Miután a kimeneti formátum definiálva van, a tényleges konverzió egyetlen soros hívás. A `Converter.convert` metódus kezeli a HTML elemzését, a CSS alkalmazását és az oldal rasterizálását PDF‑be. + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**Hogyan működik** – A háttérben az Aspose beolvassa a HTML‑t, felépíti a DOM‑ot, feloldja a külső erőforrásokat (képek, betűkészletek, CSS), majd minden renderelt oldalt a PDF‑folyamra ír. Mivel átadtuk a `pdfSaveOptions` objektumot, a motor tiszteletben tartja a korábban beállított oldalméretet, margókat és megfelelőségi beállításokat. + +> **Gyakori kérdés:** *Mi van, ha a HTML‑mimim relatív útvonalakat használ a képekhez?* +> Győződj meg róla, hogy a Java‑folyamat munkakönyvtára megegyezik a HTML‑fájl helyével, vagy használj abszolút URL‑eket. Az Aspose automatikusan letölti az erőforrásokat. + +--- + +## 3. lépés: HTML exportálása PDF‑ként – Teljes működő példa + +Az összetevőket egyesítve itt egy önálló Java‑osztály, amelyet lefordíthatsz és futtathatsz. Tartalmazza a szükséges importokat, a kivételkezelést és a megjegyzéseket, amelyek minden részt magyaráznak. + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### Várható eredmény + +A program futtatása után a megadott mappában megtalálod az `output.pdf`‑t. Nyisd meg bármely PDF‑olvasóval – Adobe Reader, Foxit vagy akár egy böngésző – és egy hű hűséges megjelenítést kell látnod az `input.html`‑ről, A4 oldalmérettel és a beállított 20 mm margóval. Ha engedélyezted a PDF/A‑1b‑t, a fájl tartalmazni fogja a hosszú távú megőrzéshez szükséges metaadatokat is. + +--- + +## Gyakran ismételt kérdések & speciális esetek + +| Kérdés | Válasz | +|----------|--------| +| **Konvertálhatok URL‑t a helyi fájl helyett?** | Igen. Cseréld le az első argumentumot a URL‑stringre, például `"https://example.com/report.html"`. | +| **Másik oldalorientációra van szükségem?** | Használd a `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);`‑t a konverzió előtt. | +| **Be lehet ágyazni egy egyedi betűtípust?** | Természetesen. Helyezd a betűtípusfájlt ugyanabba a könyvtárba, mint a HTML, vagy hivatkozz rá `@font-face`‑el a CSS‑ben; az Aspose automatikusan beágyazza. | +| **Hogyan kezelem a nagy HTML‑fájlokat, amelyek memóriahibákat okoznak?** | Fontold meg a HTML streaming‑jét vagy a felosztását szakaszokra, majd minden részt külön konvertálj PDF‑re, végül egyesítsd őket az Aspose.PDF‑vel. | +| **Szükség van licencre az Aspose.HTML‑hez?** | Egy ingyenes értékelő licenc elegendő a teszteléshez, de a termeléshez fizetős licencre lesz szükség az értékelő vízjel eltávolításához. | + +--- + +## Képi illusztráció + +Alább egy gyors képernyőkép a generált PDF‑ről (helyettesítő kép). A **alt** attribútum a fő kulcsszót használja, ami segíti mind a SEO‑t, mind az akadálymentességet. + +convert html to pdf example showing A4 page with margins + +--- + +## Összegzés + +Most már tudod, hogyan **konvertálj HTML‑t PDF‑re** az Aspose.HTML for Java segítségével, hogyan **állítsd be a PDF oldalméretet**, és milyen lépésekkel **generálj PDF‑et HTML‑ből**, miközben a folyamat elég egyszerű a kezdőknek, de elég rugalmas a tapasztalt fejlesztők számára. + +Ha tovább szeretnél lépni, próbáld ki a következőket: + +- Különböző oldalméretek (`PdfPageSize.LETTER`, egyedi méretek). +- Vízjelek vagy fejléc/lábléc hozzáadása a `PdfSaveOptions`‑on keresztül. +- Több HTML‑fájl konvertálása egy ciklusban és egyetlen PDF‑be egyesítése. + +Ezek a kiterjesztések ugyanazon alapfogalmakra épülnek, amelyeket most megismertünk, így könnyedén alkalmazhatod a kódot bármilyen munkafolyamatban. + +**Boldog kódolást!** Ha elakadsz, írj egy megjegyzést alább, vagy nézd meg az Aspose dokumentációját a haladó funkciók mélyebb bemutatásához. + +{{< /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-various-image-formats/_index.md b/html/hungarian/java/conversion-html-to-various-image-formats/_index.md index 81fb522d5..ed77aab49 100644 --- a/html/hungarian/java/conversion-html-to-various-image-formats/_index.md +++ b/html/hungarian/java/conversion-html-to-various-image-formats/_index.md @@ -96,6 +96,8 @@ Ismerje meg, hogyan konvertálhat HTML‑t GIF‑be Java‑ban az Aspose.HTML ha Tanulja meg, hogyan konvertálhat HTML‑t JPEG‑be az Aspose.HTML for Java segítségével. Lépésről‑lépésre útmutató a zökkenőmentes dokumentumfeldolgozáshoz. ### [HTML átalakítása PNG‑be](./convert-html-to-png/) Ismerje meg, hogyan konvertálhat HTML‑t PNG képekké Java‑ban az Aspose.HTML használatával. Átfogó útmutató részletes instrukciókkal. +### [HTML oldal mentése PNG‑ként Java‑ban – Teljes útmutató](./save-html-page-as-png-in-java-complete-tutorial/) +Ismerje meg, hogyan menthet HTML oldalt PNG képként Java‑ban az Aspose.HTML használatával. Részletes, lépésről‑lépésre útmutató. ### [HTML átalakítása TIFF‑be](./convert-html-to-tiff/) Tanulja meg, hogyan konvertálhat HTML‑t TIFF‑be az Aspose.HTML for Java segítségével. Lépésről‑lépésre útmutató a hatékony dokumentumkezeléshez. ### [HTML konvertálása WebP‑be – Teljes Java útmutató az Aspose.HTML‑el](./convert-html-to-webp-complete-java-guide-with-aspose-html/) diff --git a/html/hungarian/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/hungarian/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..3e34734e9 --- /dev/null +++ b/html/hungarian/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,234 @@ +--- +category: general +date: 2026-03-17 +description: Tanulja meg, hogyan menthet el egy HTML oldalt gyorsan PNG formátumban. + Ez az útmutató bemutatja, hogyan renderelhet HTML-t PNG-re, és hogyan állíthatja + be a viewport méretét Java-ban az Aspose.HTML használatával. +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: hu +og_description: HTML oldal mentése PNG-ként Java-val. Kövesd ezt az útmutatót, hogy + megtanuld, hogyan renderelj HTML-t PNG-be, és hogyan állítsd be a viewport méretét + Java-ban az Aspose.HTML használatával. +og_title: HTML oldal mentése PNG formátumba Java-ban – Lépésről lépésre útmutató +tags: +- Java +- AsposeHTML +- Image Rendering +title: HTML oldal mentése PNG-ként Java-ban – Teljes útmutató +url: /hu/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +we didn't translate code block placeholders. Keep them. + +Now produce final content.{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML oldal mentése PNG-ként Java-ban – Teljes útmutató + +Valaha szükséged volt **HTML oldal mentése PNG**-ként, de nem tudtad, hol kezdjed? Nem vagy egyedül – sok fejlesztő szembesül ezzel a problémával, amikor gyors képernyőképet kell készíteni egy weboldalról jelentésekhez, bélyegképekhez vagy teszteléshez. Ebben az útmutatóban végigvezetünk a **HTML PNG-re renderelése** folyamatán az Aspose.HTML for Java használatával, és megmutatjuk, hogyan **állítsd be a viewport méretet Java**-ban, hogy a kimenet pontosan úgy nézzen ki, ahogy elvárod. + +Mindent lefedünk a könyvtár telepítésétől a device pixel ratio finomhangolásáig, és a végére egy kész‑futtatható programod lesz, amely tiszta PNG fájlt állít elő bármely URL‑ről. Nincs homályos hivatkozás, csak egy teljes, önálló megoldás. + +## Amire szükséged lesz + +- Java 11 vagy újabb (az aktuális LTS verzió tökéletesen működik) +- Maven vagy Gradle a függőségek kezeléséhez (megmutatjuk a Maven példát) +- Internetkapcsolat a mint URL‑hez (`https://example.com`) vagy bármely oldalhoz, amelyet le szeretnél fényképezni +- Írható könyvtár a lemezen, ahová a PNG mentésre kerül + +Ennyi—nincs extra SDK, nincs natív bináris. Az Aspose.HTML belül kezeli a nehéz feladatokat. + +## 1. lépés: Aspose.HTML függőség hozzáadása + +Először is, húzd be az Aspose.HTML könyvtárat a projektedbe. Ha Maven‑t használsz, add hozzá a következőt a `pom.xml`-hez: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Gradle felhasználók ezt helyezhetik a `build.gradle`-ba: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Pro tipp:** Nézd meg az [Aspose.HTML kiadási megjegyzéseket](https://docs.aspose.com/html/java/) a legújabb verzióért; az újabb buildek gyakran tartalmaznak teljesítményjavításokat a rendereléshez. + +## 2. lépés: HTML dokumentum betöltése URL‑ről + +Most létrehozunk egy `HTMLDocument` objektumot, amely a le szeretnéd fényképezni kívánt oldalra mutat. Ez a lépés a **HTML PNG-re renderelése** középpontja, mivel a könyvtár elemzi a markupot és belsőleg felépít egy DOM‑ot. + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +Ha helyi fájlt részesítesz előnyben, egyszerűen cseréld le az URL‑stringet egy fájlútra, például `"file:///C:/mypage.html"`. + +## 3. lépés: Sandbox konfigurálása és a viewport méret beállítása + +A sandbox elkülöníti a renderelést a fő alkalmazásszálról, és lehetővé teszi a virtuális eszköz jellemzőinek meghatározását. Itt **állítjuk be a viewport méretet Java**-ban, hogy szabályozzuk a renderelt bitmap méreteit. + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +Miért érdemes sandboxot használni? Megakadályozza a mellékhatásokat, például a hálózati kérések kiszivárgását a renderelési kontextusból, és determinisztikus eredményeket biztosít – különösen fontos, ha a kódot CI szerveren futtatod. + +## 4. lépés: Kép mentési beállítások előkészítése + +Az Aspose.HTML sok formátumba exportálhat (PNG, JPEG, BMP, stb.). Konfigurálni fogjuk a `ImageSaveOptions`-t, hogy a dokumentum első oldalát célozza, és PNG‑t állítsuk be kimeneti formátumként. + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +A `setPageNumber` értékét megváltoztathatod `2`‑re vagy `-1`‑re (összes oldal), ha többoldalas képsorozatra van szükséged. + +## 5. lépés: Renderelés és a PNG fájl mentése + +Végül hívd meg a `save` metódust a `HTMLDocument`-on. A metódus figyelembe veszi a korábban alkalmazott sandbox beállításokat, és pixel‑pontos képernyőképet állít elő. + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +Amikor futtatod a programot, egy konzolüzenetet kell látnod, amely megerősíti a fájl helyét. Nyisd meg a PNG‑t – láthatod a `https://example.com` pontos vizuális ábrázolását 1280 × 800 pixel méretben, 2.0 device pixel ratio‑val renderelve (így a kép éles a Retina kijelzőkön). + +### Várható kimenet + +``` +✅ PNG saved to: rendered_page.png +``` + +Az eredményül kapott `rendered_page.png` egy magas minőségű képfájl lesz, készen áll beágyazásra jelentésekbe, e‑mail-ekbe vagy UI előnézetekbe. + +## Hogyan renderelj HTML-t PNG‑re – Gyakori variációk + +### Más oldalméret renderelése + +Ha más méretre van szükséged, egyszerűen módosítsd a `Size` értékeket: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### A Device Pixel Ratio módosítása + +Az `1.0` DPR egy standard felbontású képet ad, míg a `3.0` nagyon nagy sűrűségű képernyőket utánoz. Igazítsd igény szerint: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Egyedi fejlécek vagy sütik hozzáadása + +Néha a céloldal hitelesítést igényel. Betöltés előtt injektálhatsz fejléceket: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Több oldal renderelése + +Az összes oldal külön PNG‑ként való exportálásához iterálj a lapok számán: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Hibaelhárítási tippek + +- **Üres kép:** Győződj meg róla, hogy az URL elérhető és a sandboxnak van internet-hozzáférése. Ha proxy mögött vagy, állítsd be a JVM proxy tulajdonságokat (`-Dhttp.proxyHost=…`). +- **Out‑of‑Memory hibák:** Nagyon nagy viewportok renderelése sok RAM‑ot fogyaszthat. Csökkentsd a viewport méretét vagy alacsonyabb DPR‑t használj. +- **Hiányzó betűtípusok:** Az Aspose.HTML alapértelmezés szerint a rendszer betűtípusait használja. Ha az oldalad web‑fontokra támaszkodik, győződj meg róla, hogy elérhetők, vagy ágyazd be őket CSS `@font-face` segítségével. + +## Teljes működő példa (Minden kód egy helyen) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +Másold be ezt az IDE‑dbe, állítsd be az URL‑t vagy a kimeneti útvonalat, és nyomd meg a **Run** gombot. Ha minden helyesen van beállítva, néhány másodperc alatt PNG‑t kapsz. + +## Következtetés + +Ebben az útmutatóban bemutattuk, hogyan **mentheted el az HTML oldalt PNG‑ként** Java‑val, áttekintettük a **HTML PNG-re renderelése** finomságait, és bemutattuk a pontos lépéseket a **viewport méret beállításához Java**-ban a kimenet precíz szabályozásához. Most már van egy újrahasználható kódrészleted, amely bármely Java projektbe beilleszthető – legyen az egy háttérszolgáltatás bélyegképek generálásához vagy egy tesztkeret a vizuális elrendezések ellenőrzéséhez. + +### Mi a következő lépés? + +- Kísérletezz különböző `DevicePixelRatio` értékekkel a retina‑kész eszközök számára. +- Kombináld ezt a megközelítést egy headless böngészővel, hogy dinamikus, JavaScript‑intenzív oldalakat is rögzíts. +- Fedezd fel a többi export formátumot, például JPEG vagy PDF, a `SaveFormat.PNG` helyettesítésével `SaveFormat.JPEG`‑re vagy `SaveFormat.PDF`‑re. + +Nyugodtan módosítsd a kódot, oszd meg az eredményeidet, vagy tegyél fel kérdéseket a megjegyzésekben. Boldog renderelést! + +![A renderelt HTML PNG‑ként mentett képernyőképe](https://example.com/placeholder.png "html oldal mentése png példaként") + +{{< /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 1fe7d1786..87252acfe 100644 --- a/html/indonesian/java/conversion-html-to-other-formats/_index.md +++ b/html/indonesian/java/conversion-html-to-other-formats/_index.md @@ -90,6 +90,9 @@ Pelajari cara mengonversi HTML ke PDF di Java menggunakan Aspose.HTML. Buat PDF ### [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. +### [Mengonversi HTML ke PDF dengan Java – Panduan Langkah‑demi‑Langkah](./convert-html-to-pdf-with-java-step-by-step-guide/) +Panduan langkah‑demi‑langkah untuk mengonversi HTML ke PDF menggunakan Aspose.HTML for Java dengan contoh kode lengkap. + ### [Mengonversi HTML ke MHTML](./convert-html-to-mhtml/) Konversi HTML ke MHTML dengan mudah menggunakan Aspose.HTML untuk Java. Ikuti panduan langkah‑demi‑langkah kami untuk konversi HTML‑ke‑MHTML yang efisien. diff --git a/html/indonesian/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/indonesian/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..5dd8f91ff --- /dev/null +++ b/html/indonesian/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,172 @@ +--- +category: general +date: 2026-03-17 +description: Konversi HTML ke PDF menggunakan Aspose HTML untuk Java. Pelajari cara + mengatur ukuran halaman PDF, menghasilkan PDF dari HTML, dan mengekspor HTML sebagai + PDF dalam satu tutorial. +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: id +og_description: Konversi HTML ke PDF dengan cepat. Panduan ini menunjukkan cara mengatur + ukuran halaman PDF, menghasilkan PDF dari HTML, dan mengekspor HTML sebagai PDF + menggunakan Aspose HTML untuk Java. +og_title: Konversi HTML ke PDF dengan Java – Panduan Pemrograman Lengkap +tags: +- Aspose +- Java +- PDF generation +title: Mengonversi HTML ke PDF dengan Java – Panduan Langkah demi Langkah +url: /id/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Mengonversi HTML ke PDF dengan Java – Panduan Langkah‑per‑Langkah + +Pernah membutuhkan untuk **convert HTML to PDF** tetapi tidak yakin perpustakaan mana yang memberi Anda kontrol penuh atas output? Anda tidak sendirian. Dalam banyak proyek—misalnya pembuat faktur, pengekspor laporan, atau platform e‑learning—Anda akan menemukan diri Anda memerlukan cara yang andal untuk mengubah halaman web menjadi PDF yang dapat dicetak. + +Dalam tutorial ini kami akan membahas solusi lengkap yang siap‑jalan yang **converts HTML to PDF**, memungkinkan Anda **set PDF page size**, dan menunjukkan cara **generate PDF from HTML** sambil menjaga kode tetap bersih dan dapat dipelihara. Pada akhir tutorial Anda akan memiliki potongan kode yang dapat digunakan kembali dan dapat dimasukkan ke dalam aplikasi Java apa pun. Tanpa referensi yang samar, hanya kode konkret dan penjelasan yang jelas. + +## Apa yang Akan Anda Pelajari + +- Cara mengonfigurasi **PdfSaveOptions** untuk menentukan dimensi halaman dan margin. +- Pemanggilan tepat yang Anda perlukan untuk **export HTML as PDF** menggunakan Aspose.HTML for Java. +- Tips untuk menangani kepatuhan PDF/A‑1b, yang penting untuk pengarsipan. +- Contoh lengkap yang dapat dijalankan yang dapat Anda salin‑tempel dan sesuaikan. + +**Prerequisites** – Anda memerlukan Java 8 atau yang lebih baru, Maven atau Gradle untuk mengunduh pustaka Aspose.HTML, dan file HTML sederhana yang ingin Anda ubah menjadi PDF. Itu saja; tidak memerlukan kerangka kerja tambahan atau server web. + +--- + +## Langkah 1: Atur Ukuran Halaman PDF dan Margin + +Hal pertama yang biasanya ingin Anda kontrol adalah ukuran dokumen yang dihasilkan. Apakah Anda membutuhkan A4 untuk standar Eropa atau Letter untuk AS, Aspose memungkinkan Anda menentukan ukuran tersebut dengan satu objek. + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**Why this matters** – Tanpa secara eksplisit mengatur ukuran halaman, perpustakaan mungkin default ke US Letter, yang dapat mengacaukan tata letak bagi pengguna internasional. Nilai margin juga dalam milimeter, memudahkan pencocokan desain siap cetak. + +> **Pro tip:** Jika Anda membutuhkan ukuran khusus, ganti `PdfPageSize.A4` dengan `new com.aspose.html.saving.PdfPageSize(width, height)` dimana lebar dan tinggi dalam satuan point. + +--- + +## Langkah 2: Hasilkan PDF dari HTML + +Setelah format output ditentukan, konversi sebenarnya hanya satu baris kode. Metode `Converter.convert` menangani parsing HTML, menerapkan CSS, dan meraster halaman menjadi PDF. + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**How it works** – Di balik layar, Aspose membaca HTML, membangun DOM, menyelesaikan sumber daya eksternal (gambar, font, CSS), dan kemudian menulis setiap halaman yang dirender ke aliran PDF. Karena kami memberikan objek `pdfSaveOptions`, mesin menghormati ukuran halaman, margin, dan pengaturan kepatuhan yang kami definisikan sebelumnya. + +> **Common question:** *Bagaimana jika HTML saya merujuk gambar dengan jalur relatif?* +> Pastikan direktori kerja proses Java Anda cocok dengan lokasi file HTML, atau gunakan URL absolut. Aspose akan mengambil sumber daya secara otomatis. + +--- + +## Langkah 3: Export HTML as PDF – Contoh Lengkap yang Dapat Dijalankan + +Menggabungkan semua bagian, berikut kelas Java mandiri yang dapat Anda kompilasi dan jalankan. Kelas ini mencakup impor yang diperlukan, penanganan pengecualian, dan komentar yang menjelaskan setiap bagian. + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### Hasil yang Diharapkan + +Setelah menjalankan program, Anda akan menemukan `output.pdf` di folder yang sama dengan yang Anda tentukan. Buka dengan penampil PDF apa pun—Adobe Reader, Foxit, atau bahkan browser—dan Anda akan melihat rendering yang akurat dari `input.html`, lengkap dengan ukuran halaman A4 dan margin 20 mm yang Anda atur. Jika Anda mengaktifkan PDF/A‑1b, file tersebut juga akan berisi metadata yang diperlukan untuk preservasi jangka panjang. + +--- + +## Pertanyaan yang Sering Diajukan & Kasus Tepi + +| Question | Answer | +|----------|--------| +| **Bisakah saya mengonversi URL alih-alih file lokal?** | Ya. Ganti argumen pertama dengan string URL, misalnya `"https://example.com/report.html"`. | +| **Bagaimana jika saya membutuhkan orientasi halaman yang berbeda?** | Gunakan `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` sebelum konversi. | +| **Apakah memungkinkan menyematkan font khusus?** | Tentu saja. Letakkan file font di direktori yang sama dengan HTML atau referensikan melalui `@font-face` di CSS Anda; Aspose akan menyematkannya secara otomatis. | +| **Bagaimana cara menangani file HTML besar yang menyebabkan masalah memori?** | Pertimbangkan untuk streaming HTML atau membagi menjadi beberapa bagian dan mengonversi tiap bagian secara terpisah, kemudian menggabungkan PDF dengan Aspose.PDF. | +| **Apakah saya memerlukan lisensi untuk Aspose.HTML?** | Lisensi evaluasi gratis cukup untuk pengujian, tetapi untuk produksi Anda memerlukan lisensi berbayar untuk menghapus watermark evaluasi. | + +--- + +## Ilustrasi Gambar + +Berikut adalah tangkapan layar cepat dari PDF yang dihasilkan (gambar placeholder). Atribut **alt** menggunakan kata kunci utama, membantu SEO dan aksesibilitas. + +convert html to pdf example showing A4 page with margins + +--- + +## Kesimpulan + +Kami baru saja membahas cara **convert HTML to PDF** menggunakan Aspose.HTML untuk Java, cara **set PDF page size**, dan langkah tepat untuk **generate PDF from HTML** sambil menjaga proses tetap sederhana bagi pemula dan fleksibel bagi pengembang berpengalaman. + +Jika Anda siap melangkah lebih jauh, coba bereksperimen dengan: + +- Ukuran halaman berbeda (`PdfPageSize.LETTER`, dimensi khusus). +- Menambahkan watermark atau header/footer melalui `PdfSaveOptions`. +- Mengonversi beberapa file HTML dalam loop dan menggabungkannya menjadi satu PDF. + +Ekstensi ini dibangun di atas konsep inti yang kami bahas, sehingga Anda akan merasa nyaman menyesuaikan kode untuk memenuhi alur kerja apa pun. + +**Happy coding!** Jika Anda menemui kendala, tinggalkan komentar di bawah atau periksa dokumentasi Aspose untuk penjelasan lebih mendalam tentang fitur lanjutan. + +{{< /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-various-image-formats/_index.md b/html/indonesian/java/conversion-html-to-various-image-formats/_index.md index 285cd7489..ac346fcab 100644 --- a/html/indonesian/java/conversion-html-to-various-image-formats/_index.md +++ b/html/indonesian/java/conversion-html-to-various-image-formats/_index.md @@ -99,6 +99,8 @@ Pelajari cara mengkonversi HTML ke gambar PNG di Java dengan Aspose.HTML. Pandua ### [Mengonversi HTML ke TIFF](./convert-html-to-tiff/) Pelajari cara mudah mengkonversi HTML ke TIFF menggunakan Aspose.HTML untuk Java. Panduan langkah demi langkah untuk penanganan dokumen yang efisien. ### [Mengonversi HTML ke WebP – Panduan Lengkap Java dengan Aspose.HTML](./convert-html-to-webp-complete-java-guide-with-aspose-html/) +### [Simpan Halaman HTML sebagai PNG di Java – Tutorial Lengkap](./save-html-page-as-png-in-java-complete-tutorial/) +Pelajari cara menyimpan halaman HTML sebagai file PNG menggunakan Aspose.HTML for Java dengan contoh kode lengkap dan langkah-langkah mudah. ## Pertanyaan yang Sering Diajukan diff --git a/html/indonesian/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/indonesian/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..885e4e99c --- /dev/null +++ b/html/indonesian/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,234 @@ +--- +category: general +date: 2026-03-17 +description: Pelajari cara menyimpan halaman HTML sebagai PNG dengan cepat. Panduan + ini menunjukkan cara merender HTML ke PNG dan mengatur ukuran viewport di Java menggunakan + Aspose.HTML. +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: id +og_description: Simpan halaman HTML sebagai PNG dengan Java. Ikuti tutorial ini untuk + mempelajari cara merender HTML ke PNG dan mengatur ukuran viewport di Java menggunakan + Aspose.HTML. +og_title: Simpan Halaman HTML sebagai PNG di Java – Panduan Langkah demi Langkah +tags: +- Java +- AsposeHTML +- Image Rendering +title: Simpan Halaman HTML sebagai PNG di Java – Tutorial Lengkap +url: /id/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Simpan Halaman HTML sebagai PNG di Java – Tutorial Lengkap + +Pernah perlu **menyimpan halaman HTML sebagai PNG** tetapi tidak tahu harus mulai dari mana? Anda tidak sendirian—banyak pengembang mengalami kendala ini ketika mereka membutuhkan screenshot cepat dari sebuah halaman web untuk laporan, thumbnail, atau pengujian. Dalam panduan ini kami akan menjelaskan **cara merender HTML ke PNG** menggunakan Aspose.HTML untuk Java, dan juga menunjukkan **cara mengatur ukuran viewport Java** sehingga output terlihat persis seperti yang Anda harapkan. + +Kami akan membahas semuanya mulai dari pemasangan pustaka hingga penyesuaian rasio piksel perangkat, dan pada akhir tutorial Anda akan memiliki program siap‑jalankan yang menghasilkan file PNG tajam dari URL apa pun. Tanpa referensi yang samar, hanya solusi lengkap yang berdiri sendiri. + +## Apa yang Anda Butuhkan + +Sebelum kita mulai, pastikan Anda memiliki: + +- Java 11 atau lebih baru (versi LTS saat ini bekerja dengan sempurna) +- Maven atau Gradle untuk mengelola dependensi (kami akan menunjukkan cuplikan Maven) +- Koneksi internet untuk URL contoh (`https://example.com`) atau halaman apa pun yang ingin Anda tangkap +- Direktori yang dapat ditulisi di disk tempat PNG akan disimpan + +Itu saja—tidak ada SDK tambahan, tidak ada binari native. Aspose.HTML menangani semua proses berat secara internal. + +## Langkah 1: Tambahkan Dependensi Aspose.HTML + +Pertama, tarik pustaka Aspose.HTML ke dalam proyek Anda. Jika Anda menggunakan Maven, tambahkan berikut ke `pom.xml` Anda: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Pengguna Gradle dapat menambahkan ini ke `build.gradle`: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Pro tip:** Periksa [catatan rilis Aspose.HTML](https://docs.aspose.com/html/java/) untuk versi terbaru; build yang lebih baru biasanya menyertakan perbaikan kinerja untuk rendering. + +## Langkah 2: Muat Dokumen HTML dari URL + +Sekarang kita akan membuat objek `HTMLDocument` yang menunjuk ke halaman yang ingin Anda tangkap. Langkah ini merupakan inti dari **cara merender HTML ke PNG** karena pustaka akan mem-parsing markup dan membangun DOM secara internal. + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +Jika Anda lebih suka file lokal, cukup ganti string URL dengan path file seperti `"file:///C:/mypage.html"`. + +## Langkah 3: Konfigurasikan Sandbox dan Atur Ukuran Viewport + +Sandbox mengisolasi proses rendering dari thread aplikasi utama Anda dan memungkinkan Anda mendefinisikan karakteristik perangkat virtual. Di sinilah kita **mengatur ukuran viewport Java** untuk mengontrol dimensi bitmap yang dirender. + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +Mengapa harus menggunakan sandbox? Ia mencegah efek samping seperti permintaan jaringan yang bocor keluar dari konteks rendering, dan memberikan hasil yang deterministik—terutama penting saat Anda menjalankan kode di server CI. + +## Langkah 4: Siapkan Opsi Penyimpanan Gambar + +Aspose.HTML dapat mengekspor ke banyak format (PNG, JPEG, BMP, dll.). Kami akan mengonfigurasi `ImageSaveOptions` untuk menargetkan halaman pertama dokumen dan menentukan PNG sebagai format output. + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +Anda dapat mengubah `setPageNumber` menjadi `2` atau `-1` (semua halaman) jika membutuhkan urutan gambar multi‑halaman. + +## Langkah 5: Render dan Simpan File PNG + +Akhirnya, panggil `save` pada `HTMLDocument`. Metode ini menghormati semua pengaturan sandbox yang telah kita terapkan sebelumnya, menghasilkan screenshot yang pixel‑perfect. + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +Saat Anda menjalankan program, Anda akan melihat pesan di konsol yang mengonfirmasi lokasi file. Buka PNG—Anda akan melihat representasi visual tepat dari `https://example.com` dengan resolusi 1280 × 800 piksel, dirender dengan device pixel ratio 2.0 (sehingga gambar tampak tajam pada layar Retina). + +### Output yang Diharapkan + +``` +✅ PNG saved to: rendered_page.png +``` + +File `rendered_page.png` yang dihasilkan akan menjadi file gambar berkualitas tinggi, siap untuk disisipkan dalam laporan, email, atau pratinjau UI. + +## Cara Merender HTML ke PNG – Variasi Umum + +### Merender dengan Ukuran Halaman Berbeda + +Jika Anda memerlukan dimensi yang berbeda, cukup ubah nilai `Size`: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### Mengubah Device Pixel Ratio + +DPR `1.0` memberi Anda gambar resolusi standar, sementara `3.0` meniru layar dengan kepadatan sangat tinggi. Sesuaikan sesuai kebutuhan: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Menambahkan Header atau Cookie Kustom + +Terkadang halaman target memerlukan autentikasi. Anda dapat menyuntikkan header sebelum memuat: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Merender Banyak Halaman + +Untuk mengekspor setiap halaman sebagai PNG terpisah, lakukan loop atas jumlah halaman: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Tips Pemecahan Masalah + +- **Gambar Kosong:** Pastikan URL dapat dijangkau dan sandbox memiliki akses internet. Jika Anda berada di belakang proxy, atur properti proxy JVM (`-Dhttp.proxyHost=…`). +- **Out‑of‑Memory Errors:** Merender viewport yang sangat besar dapat mengonsumsi banyak RAM. Kurangi ukuran viewport atau turunkan DPR. +- **Font Hilang:** Aspose.HTML menggunakan font sistem secara default. Jika halaman Anda mengandalkan web font, pastikan font tersebut dapat dijangkau atau sematkan melalui CSS `@font-face`. + +## Contoh Lengkap yang Berfungsi (Semua Kode dalam Satu Tempat) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +Salin‑tempel ini ke IDE Anda, sesuaikan URL atau path output, lalu tekan **Run**. Jika semuanya telah diatur dengan benar, Anda akan memiliki PNG dalam hitungan detik. + +## Kesimpulan + +Dalam tutorial ini kami menunjukkan **cara menyimpan halaman HTML sebagai PNG** menggunakan Java, membahas seluk‑beluk **cara merender HTML ke PNG**, dan mendemonstrasikan langkah‑langkah tepat untuk **mengatur ukuran viewport Java** demi kontrol yang presisi atas output. Sekarang Anda memiliki potongan kode yang dapat digunakan kembali dan dapat disisipkan ke dalam proyek Java mana pun—baik itu layanan backend yang menghasilkan thumbnail atau harness pengujian yang memvalidasi tata letak visual. + +### Apa Selanjutnya? + +- Bereksperimen dengan nilai `DevicePixelRatio` yang berbeda untuk aset siap‑retina. +- Menggabungkan pendekatan ini dengan browser headless untuk menangkap halaman dinamis yang berat JavaScript. +- Menjelajahi format ekspor lain seperti JPEG atau PDF dengan mengganti `SaveFormat.PNG` menjadi `SaveFormat.JPEG` atau `SaveFormat.PDF`. + +Silakan modifikasi kode, bagikan hasil Anda, atau ajukan pertanyaan di kolom komentar. Selamat merender! + +![Screenshot of rendered HTML saved as PNG](https://example.com/placeholder.png "save html page as png example") + +{{< /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 8c3556a36..d426631d5 100644 --- a/html/italian/java/conversion-html-to-other-formats/_index.md +++ b/html/italian/java/conversion-html-to-other-formats/_index.md @@ -85,6 +85,7 @@ In conclusione, padroneggiare **html to pdf java** e l'insieme più ampio di con ### [Conversione da HTML a PDF](./convert-html-to-pdf/) ### [Converti HTML in PDF in Java – Guida passo‑passo con impostazioni della dimensione della pagina](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) +### [Converti HTML in PDF con Java – Guida passo‑per‑passo](./convert-html-to-pdf-with-java-step-by-step-guide/) ### [Conversione da HTML a MHTML](./convert-html-to-mhtml/) ### [Conversione da HTML a XPS](./convert-html-to-xps/) ### [Conversione da Markdown a HTML](./convert-markdown-to-html/) diff --git a/html/italian/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/italian/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..69ec8dbcd --- /dev/null +++ b/html/italian/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,172 @@ +--- +category: general +date: 2026-03-17 +description: Converti HTML in PDF usando Aspose HTML per Java. Scopri come impostare + le dimensioni della pagina PDF, generare PDF da HTML ed esportare HTML come PDF + in un unico tutorial. +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: it +og_description: Converti rapidamente HTML in PDF. Questa guida mostra come impostare + la dimensione della pagina PDF, generare PDF da HTML ed esportare HTML come PDF + utilizzando Aspose HTML per Java. +og_title: Converti HTML in PDF con Java – Guida completa alla programmazione +tags: +- Aspose +- Java +- PDF generation +title: Converti HTML in PDF con Java – Guida passo passo +url: /it/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Converti HTML in PDF con Java – Guida passo‑passo + +Ti è mai capitato di dover **convertire HTML in PDF** senza sapere quale libreria ti offrisse il pieno controllo sull'output? Non sei l'unico. In molti progetti—pensaci a generatori di fatture, esportatori di report o piattaforme di e‑learning—ti troverai a cercare un modo affidabile per trasformare pagine web in PDF stampabili. + +In questo tutorial percorreremo una soluzione completa, pronta all'uso, che **converte HTML in PDF**, ti permette di **impostare la dimensione della pagina PDF** e ti mostra come **generare PDF da HTML** mantenendo il codice pulito e manutenibile. Alla fine avrai uno snippet riutilizzabile da inserire in qualsiasi applicazione Java. Niente riferimenti vaghi, solo codice concreto e spiegazioni chiare. + +## Cosa imparerai + +- Come configurare **PdfSaveOptions** per definire dimensioni della pagina e margini. +- La chiamata esatta necessaria per **esportare HTML come PDF** usando Aspose.HTML for Java. +- Consigli per gestire la conformità PDF/A‑1b, essenziale per l'archiviazione. +- Un esempio completo, eseguibile, che puoi copiare‑incollare e adattare. + +**Prerequisiti** – ti servirà Java 8 o superiore, Maven o Gradle per scaricare la libreria Aspose.HTML, e un semplice file HTML che desideri trasformare in PDF. Tutto qui; non servono framework aggiuntivi né server web. + +--- + +## Passo 1: Impostare la dimensione della pagina PDF e i margini + +La prima cosa che di solito vuoi controllare è la dimensione del documento risultante. Che tu abbia bisogno di A4 per gli standard europei o Letter per gli USA, Aspose ti consente di specificarlo con un unico oggetto. + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**Perché è importante** – Senza impostare esplicitamente la dimensione della pagina, la libreria potrebbe usare per default US Letter, il che potrebbe rovinare i layout per gli utenti internazionali. I valori dei margini sono espressi in millimetri, facilitando l'abbinamento a design pronti per la stampa. + +> **Consiglio professionale:** Se ti serve una dimensione personalizzata, sostituisci `PdfPageSize.A4` con `new com.aspose.html.saving.PdfPageSize(width, height)` dove width e height sono in punti. + +--- + +## Passo 2: Generare PDF da HTML + +Ora che il formato di output è definito, la conversione vera e propria è una singola riga. Il metodo `Converter.convert` si occupa di analizzare l'HTML, applicare il CSS e rasterizzare la pagina in un PDF. + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**Come funziona** – In pratica, Aspose legge l'HTML, costruisce un DOM, risolve le risorse esterne (immagini, font, CSS) e poi scrive ogni pagina renderizzata nello stream PDF. Poiché abbiamo passato l'oggetto `pdfSaveOptions`, il motore rispetta la dimensione della pagina, i margini e le impostazioni di conformità definite in precedenza. + +> **Domanda frequente:** *E se il mio HTML fa riferimento a immagini con percorsi relativi?* +> Assicurati che la directory di lavoro del tuo processo Java corrisponda alla posizione del file HTML, oppure usa URL assoluti. Aspose recupererà le risorse automaticamente. + +--- + +## Passo 3: Esportare HTML come PDF – Esempio completo funzionante + +Mettendo insieme tutti i pezzi, ecco una classe Java autonoma che puoi compilare ed eseguire. Include gli import necessari, la gestione delle eccezioni e commenti che spiegano ogni parte. + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### Risultato atteso + +Dopo aver eseguito il programma, troverai `output.pdf` nella stessa cartella indicata. Aprilo con qualsiasi visualizzatore PDF—Adobe Reader, Foxit o anche un browser—e dovresti vedere una resa fedele di `input.html`, completa della dimensione A4 e dei margini di 20 mm impostati. Se hai abilitato PDF/A‑1b, il file conterrà anche i metadati necessari per la conservazione a lungo termine. + +--- + +## Domande frequenti & casi particolari + +| Domanda | Risposta | +|----------|--------| +| **Posso convertire un URL invece di un file locale?** | Sì. Sostituisci il primo argomento con la stringa URL, ad esempio `"https://example.com/report.html"`. | +| **E se ho bisogno di un orientamento della pagina diverso?** | Usa `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` prima della conversione. | +| **È possibile incorporare un font personalizzato?** | Assolutamente. Posiziona il file del font nella stessa directory dell'HTML o riferiscilo tramite `@font-face` nel tuo CSS; Aspose lo incorporerà automaticamente. | +| **Come gestire file HTML di grandi dimensioni che causano problemi di memoria?** | Considera lo streaming dell'HTML o la suddivisione in sezioni, convertendo ogni parte separatamente, per poi unire i PDF con Aspose.PDF. | +| **È necessaria una licenza per Aspose.HTML?** | Una licenza di valutazione gratuita è sufficiente per i test, ma per la produzione avrai bisogno di una licenza a pagamento per rimuovere la filigrana di valutazione. | + +--- + +## Illustrazione immagine + +Di seguito trovi uno screenshot rapido del PDF generato (immagine segnaposto). L'attributo **alt** utilizza la parola chiave principale, aiutando sia SEO che accessibilità. + +convert html to pdf example showing A4 page with margins + +--- + +## Conclusioni + +Abbiamo appena coperto come **convertire HTML in PDF** usando Aspose.HTML for Java, come **impostare la dimensione della pagina PDF** e i passaggi esatti per **generare PDF da HTML** mantenendo il processo sufficientemente semplice per i principianti e abbastanza flessibile per gli sviluppatori esperti. + +Se sei pronto a spingerti oltre, prova a sperimentare con: + +- Diverse dimensioni di pagina (`PdfPageSize.LETTER`, dimensioni personalizzate). +- Aggiunta di filigrane o intestazioni/piè di pagina tramite `PdfSaveOptions`. +- Conversione di più file HTML in un ciclo e fusione in un unico PDF. + +Queste estensioni si basano sugli stessi concetti fondamentali che abbiamo esplorato, così ti sentirai a tuo agio nell'adattare il codice a qualsiasi flusso di lavoro. + +**Buona programmazione!** Se incontri difficoltà, lascia un commento qui sotto o consulta la documentazione Aspose per approfondimenti su funzionalità avanzate. + +{{< /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-various-image-formats/_index.md b/html/italian/java/conversion-html-to-various-image-formats/_index.md index 8d2cd44b9..5ba081e8b 100644 --- a/html/italian/java/conversion-html-to-various-image-formats/_index.md +++ b/html/italian/java/conversion-html-to-various-image-formats/_index.md @@ -84,14 +84,22 @@ Usare Aspose.HTML for Java semplifica la conversione di documenti HTML in vari f ## Conversione - HTML in vari formati immagine – Tutorial ### [Conversione di HTML in BMP](./convert-html-to-bmp/) Converti HTML in BMP con Aspose.HTML for Java. Un tutorial completo per convertire senza problemi i documenti HTML in immagini BMP usando Aspose.HTML for Java. + ### [Conversione di HTML in GIF](./convert-html-to-gif/) Scopri come convertire HTML in GIF in Java usando Aspose.HTML. Una guida completa passo‑passo per una conversione efficiente da HTML a GIF. + ### [Conversione di HTML in JPEG](./convert-html-to-jpeg/) Impara a convertire HTML in JPEG con Aspose.HTML for Java. Guida passo‑passo per una gestione fluida dei documenti. + ### [Conversione di HTML in PNG](./convert-html-to-png/) Scopri come convertire HTML in immagini PNG in Java con Aspose.HTML. Una guida completa con istruzioni passo‑passo. + +### [Salva pagina HTML come PNG in Java – Guida completa](./save-html-page-as-png-in-java-complete-tutorial/) +Impara a salvare una pagina HTML come immagine PNG usando Aspose.HTML for Java. Guida passo‑passo completa. + ### [Conversione di HTML in TIFF](./convert-html-to-tiff/) Scopri come convertire facilmente HTML in TIFF usando Aspose.HTML for Java. Guida passo‑passo per una gestione efficiente dei documenti. + ### [Converti HTML in WebP](./convert-html-to-webp-complete-java-guide-with-aspose-html/) Scopri come convertire HTML in WebP in Java usando Aspose.HTML. Una guida completa passo‑passo per una conversione efficiente. diff --git a/html/italian/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/italian/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..dde712db0 --- /dev/null +++ b/html/italian/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,240 @@ +--- +category: general +date: 2026-03-17 +description: Impara come salvare rapidamente una pagina HTML come PNG. Questa guida + mostra come rendere HTML in PNG e impostare la dimensione della viewport in Java + usando Aspose.HTML. +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: it +og_description: Salva la pagina HTML come PNG con Java. Segui questo tutorial per + imparare a convertire HTML in PNG e impostare la dimensione della viewport in Java + usando Aspose.HTML. +og_title: Salva pagina HTML come PNG in Java – Guida passo passo +tags: +- Java +- AsposeHTML +- Image Rendering +title: Salva pagina HTML come PNG in Java – Tutorial completo +url: /it/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +actual code; they are placeholders. Keep them. + +Now translate. + +Let's produce final content. + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Salva una pagina HTML come PNG in Java – Tutorial completo + +Ti è mai capitato di dover **salvare una pagina HTML come PNG** ma non sapevi da dove cominciare? Non sei l'unico: molti sviluppatori si trovano in questa situazione quando hanno bisogno di uno screenshot rapido di una pagina web per report, miniature o test. In questa guida ti mostreremo **come renderizzare HTML in PNG** usando Aspose.HTML per Java, e ti spiegheremo anche **come impostare la dimensione del viewport in Java** affinché l'output sia esattamente come ti aspetti. + +Copriamo tutto, dall'installazione della libreria alla regolazione del device pixel ratio, e alla fine avrai un programma pronto all'uso che genera un file PNG nitido da qualsiasi URL. Niente riferimenti vaghi, solo una soluzione completa e autonoma. + +## Cosa ti serve + +Prima di iniziare, assicurati di avere: + +- Java 11 o versioni successive (l'attuale LTS funziona perfettamente) +- Maven o Gradle per gestire le dipendenze (mostreremo lo snippet per Maven) +- Una connessione internet per l'URL di esempio (`https://example.com`) o per qualsiasi pagina tu voglia catturare +- Una directory scrivibile sul disco dove salvare il PNG + +Tutto qui—nessun SDK aggiuntivo, nessun binario nativo. Aspose.HTML si occupa del lavoro pesante internamente. + +## Passo 1: Aggiungi la dipendenza Aspose.HTML + +Per prima cosa, importa la libreria Aspose.HTML nel tuo progetto. Se usi Maven, aggiungi quanto segue al tuo `pom.xml`: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Gli utenti Gradle possono inserire questo in `build.gradle`: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Suggerimento:** Controlla le [note di rilascio di Aspose.HTML](https://docs.aspose.com/html/java/) per la versione più recente; le build più recenti includono spesso ottimizzazioni di performance per il rendering. + +## Passo 2: Carica il documento HTML da un URL + +Ora creeremo un oggetto `HTMLDocument` che punta alla pagina che vuoi catturare. Questo passaggio è il cuore di **come renderizzare HTML in PNG** perché la libreria analizza il markup e costruisce un DOM internamente. + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +Se preferisci un file locale, sostituisci semplicemente la stringa URL con un percorso file come `"file:///C:/mypage.html"`. + +## Passo 3: Configura il Sandbox e imposta la dimensione del viewport + +Il sandbox isola il rendering dal thread principale della tua applicazione e ti permette di definire le caratteristiche del dispositivo virtuale. Qui è dove **impostiamo la dimensione del viewport in Java** per controllare le dimensioni della bitmap renderizzata. + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +Perché usare un sandbox? Previene effetti collaterali come richieste di rete che fuoriescono dal contesto di rendering e ti garantisce risultati deterministici—particolarmente importante quando esegui il codice su un server CI. + +## Passo 4: Prepara le opzioni di salvataggio immagine + +Aspose.HTML può esportare in molti formati (PNG, JPEG, BMP, ecc.). Configureremo `ImageSaveOptions` per puntare alla prima pagina del documento e specificare PNG come formato di output. + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +Puoi cambiare `setPageNumber` a `2` o a `-1` (tutte le pagine) se ti serve una sequenza di immagini multi‑pagina. + +## Passo 5: Renderizza e salva il file PNG + +Infine, chiama `save` sul `HTMLDocument`. Il metodo rispetta tutte le impostazioni del sandbox applicate in precedenza, producendo uno screenshot pixel‑perfect. + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +Quando esegui il programma, dovresti vedere un messaggio sulla console che conferma la posizione del file. Apri il PNG—vedrai la rappresentazione visiva esatta di `https://example.com` a 1280 × 800 pixel, renderizzata con un device pixel ratio di 2.0 (così l'immagine appare nitida sui display Retina). + +### Output previsto + +``` +✅ PNG saved to: rendered_page.png +``` + +Il file `rendered_page.png` risultante sarà un'immagine di alta qualità, pronta per essere inserita in report, email o anteprime UI. + +## Come renderizzare HTML in PNG – Varianti comuni + +### Renderizzare una dimensione pagina diversa + +Se ti serve una dimensione diversa, modifica semplicemente i valori di `Size`: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### Cambiare il Device Pixel Ratio + +Un DPR di `1.0` ti dà un'immagine a risoluzione standard, mentre `3.0` simula schermi ad altissima densità. Regola secondo le necessità: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Aggiungere header o cookie personalizzati + +A volte la pagina di destinazione richiede autenticazione. Puoi iniettare header prima del caricamento: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Renderizzare più pagine + +Per esportare ogni pagina come PNG separato, itera sul conteggio delle pagine: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Suggerimenti per la risoluzione dei problemi + +- **Immagine vuota:** Verifica che l'URL sia raggiungibile e che il sandbox abbia accesso a internet. Se sei dietro un proxy, imposta le proprietà proxy della JVM (`-Dhttp.proxyHost=…`). +- **Errori Out‑of‑Memory:** Renderizzare viewport molto grandi può consumare molta RAM. Riduci la dimensione del viewport o abbassa il DPR. +- **Font mancanti:** Aspose.HTML utilizza i font di sistema per impostazione predefinita. Se la tua pagina dipende da web‑font, assicurati che siano raggiungibili o incorporali tramite CSS `@font-face`. + +## Esempio completo funzionante (tutto il codice in un unico posto) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +Copia‑incolla questo nel tuo IDE, modifica l'URL o il percorso di output, e premi **Run**. Se tutto è configurato correttamente, avrai un PNG in pochi secondi. + +## Conclusione + +In questo tutorial ti abbiamo mostrato **come salvare una pagina HTML come PNG** usando Java, abbiamo approfondito le sfumature di **come renderizzare HTML in PNG**, e abbiamo dimostrato i passaggi esatti per **impostare la dimensione del viewport in Java** per un controllo preciso dell'output. Ora disponi di uno snippet riutilizzabile da inserire in qualsiasi progetto Java—sia che si tratti di un servizio backend che genera miniature, sia di un test harness che valida layout visivi. + +### Cosa fare dopo? + +- Sperimenta con valori diversi di `DevicePixelRatio` per asset pronti per Retina. +- Combina questo approccio con un browser headless per catturare pagine dinamiche e ricche di JavaScript. +- Esplora altri formati di esportazione come JPEG o PDF sostituendo `SaveFormat.PNG` con `SaveFormat.JPEG` o `SaveFormat.PDF`. + +Sentiti libero di modificare il codice, condividere i tuoi risultati o porre domande nei commenti. Buon rendering! + +![Screenshot di HTML renderizzato salvato come PNG](https://example.com/placeholder.png "save html page as png example") + +{{< /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 ef52efca8..6137f8c31 100644 --- a/html/japanese/java/conversion-html-to-other-formats/_index.md +++ b/html/japanese/java/conversion-html-to-other-formats/_index.md @@ -97,6 +97,8 @@ Aspose.HTML で Java の SVG を PDF に変換します。高品質文書変換 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に変換 – ステップバイステップガイド](./convert-html-to-pdf-with-java-step-by-step-guide/) +Aspose.HTML を使用して Java で HTML を PDF に変換する手順を詳しく解説します。 ## よくある質問 diff --git a/html/japanese/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/japanese/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..5f57c8f7e --- /dev/null +++ b/html/japanese/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,170 @@ +--- +category: general +date: 2026-03-17 +description: Aspose HTML for Java を使用して HTML を PDF に変換します。PDF のページサイズの設定方法、HTML から + PDF を生成する方法、HTML を PDF としてエクスポートする方法を、1 つのチュートリアルで学びましょう。 +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: ja +og_description: HTML を PDF に素早く変換します。このガイドでは、PDF のページサイズの設定方法、HTML から PDF を生成する方法、そして + Aspose HTML for Java を使用して HTML を PDF としてエクスポートする方法を示します。 +og_title: JavaでHTMLをPDFに変換 – 完全プログラミングガイド +tags: +- Aspose +- Java +- PDF generation +title: JavaでHTMLをPDFに変換 – ステップバイステップガイド +url: /ja/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML を PDF に変換する Java – ステップバイステップガイド + +**HTML を PDF に変換**したいけど、どのライブラリが出力を完全にコントロールできるか分からない…という経験はありませんか？同じ悩みを抱える人は多いです。請求書ジェネレータ、レポートエクスポーター、e‑ラーニングプラットフォームなど、さまざまなプロジェクトで Web ページを印刷可能な PDF に変換する信頼できる方法が必要になります。 + +このチュートリアルでは、**HTML を PDF に変換**し、**PDF のページサイズを設定**でき、**HTML から PDF を生成**する完全な実行可能ソリューションを順を追って解説します。コードはクリーンで保守しやすく、任意の Java アプリケーションに組み込める再利用可能なスニペットが完成します。曖昧な説明はなく、具体的なコードと明確な解説だけです。 + +## 学べること + +- **PdfSaveOptions** を設定してページサイズや余白を定義する方法。 +- Aspose.HTML for Java を使って **HTML を PDF としてエクスポート**する正確な呼び出し方。 +- アーカイブに必須の PDF/A‑1b 準拠を扱うコツ。 +- コピー＆ペーストしてすぐに使える、実行可能な完全サンプル。 + +**前提条件** – Java 8 以上、Aspose.HTML ライブラリを取得できる Maven または Gradle、そして PDF に変換したいシンプルな HTML ファイルがあれば OKです。余計なフレームワークや Web サーバーは不要です。 + +--- + +## 手順 1: PDF のページサイズと余白を設定 + +最初にコントロールしたいのは生成されるドキュメントのサイズです。欧州規格の A4 でも、米国規格の Letter でも、Aspose なら単一オブジェクトで指定できます。 + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**重要ポイント** – ページサイズを明示的に設定しないと、ライブラリはデフォルトで US Letter を使用することがあり、国際的なユーザー向けのレイアウトが崩れる可能性があります。余白の単位はミリメートルなので、印刷用デザインと簡単に合わせられます。 + +> **プロのコツ:** カスタムサイズが必要な場合は `PdfPageSize.A4` を `new com.aspose.html.saving.PdfPageSize(width, height)` に置き換えてください。`width` と `height` はポイント単位です。 + +--- + +## 手順 2: HTML から PDF を生成 + +出力フォーマットが決まったら、実際の変換はワンライナーです。`Converter.convert` メソッドが HTML の解析、CSS の適用、ページのラスタライズをすべて処理し、PDF に書き出します。 + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**動作概要** – Aspose は内部で HTML を読み込み DOM を構築し、外部リソース（画像、フォント、CSS）を解決した上で、各レンダリングページを PDF ストリームに書き込みます。`pdfSaveOptions` オブジェクトを渡しているため、エンジンは先に設定したページサイズ、余白、準拠設定を尊重します。 + +> **よくある質問:** *HTML が相対パスで画像を参照している場合は？* +> Java プロセスの作業ディレクトリを HTML ファイルの場所と合わせるか、絶対 URL を使用してください。Aspose が自動的にリソースを取得します。 + +--- + +## 手順 3: HTML を PDF としてエクスポート – 完全動作サンプル + +全体を組み合わせた、コンパイルして実行できる自己完結型の Java クラスです。必要なインポート、例外処理、各部分を説明するコメントが含まれています。 + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### 期待される結果 + +プログラムを実行すると、指定したフォルダーに `output.pdf` が生成されます。Adobe Reader、Foxit、あるいはブラウザで開くと、`input.html` の忠実なレンダリングが表示され、A4 ページサイズと 20 mm の余白が適用されていることが確認できます。PDF/A‑1b を有効にしていれば、長期保存に必要なメタデータも含まれます。 + +--- + +## よくある質問 & エッジケース + +| 質問 | 回答 | +|----------|--------| +| **ローカルファイルではなく URL を変換できますか？** | はい。最初の引数を URL 文字列に置き換えてください（例: `"https://example.com/report.html"`）。 | +| **ページの向きを変更したい場合は？** | 変換前に `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` を呼び出します。 | +| **カスタムフォントを埋め込むことは可能ですか？** | 可能です。フォントファイルを HTML と同じディレクトリに置くか、CSS の `@font-face` で参照してください。Aspose が自動的に埋め込みます。 | +| **メモリ問題を起こす大容量 HTML をどう処理すれば？** | HTML をストリーミングするか、セクションに分割して個別に変換し、最後に Aspose.PDF で PDF を結合する方法を検討してください。 | +| **Aspose.HTML のライセンスは必要ですか？** | 評価ライセンスでテストは可能ですが、本番環境では評価透かしを除去する有料ライセンスが必要です。 | + +--- + +## 画像イラスト + +以下は生成された PDF のスクリーンショット（プレースホルダー画像）です。**alt** 属性には主要キーワードを使用し、SEO とアクセシビリティの両方に配慮しています。 + +convert html to pdf example showing A4 page with margins + +--- + +## まとめ + +Aspose.HTML for Java を使って **HTML を PDF に変換**し、**PDF のページサイズを設定**し、**HTML から PDF を生成**する手順を解説しました。初心者にも分かりやすく、経験豊富な開発者にも柔軟に拡張できる内容です。 + +さらに踏み込むなら、以下に挑戦してみてください。 + +- 異なるページサイズ（`PdfPageSize.LETTER`、カスタム寸法）を試す。 +- `PdfSaveOptions` を使って透かしやヘッダー/フッターを追加する。 +- 複数の HTML ファイルをループで変換し、単一の PDF に結合する。 + +これらの拡張は本稿で学んだコア概念に基づいているため、コードを自在にカスタマイズできるはずです。 + +**Happy coding!** 問題があればコメントを残すか、Aspose の公式ドキュメントで高度な機能を確認してください。 + +{{< /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-various-image-formats/_index.md b/html/japanese/java/conversion-html-to-various-image-formats/_index.md index b8d96e2dd..2950e6d33 100644 --- a/html/japanese/java/conversion-html-to-various-image-formats/_index.md +++ b/html/japanese/java/conversion-html-to-various-image-formats/_index.md @@ -99,6 +99,8 @@ Aspose.HTML for Java を使用して HTML を TIFF に簡単に変換する方 ### [HTML を WebP に変換 – Aspose.HTML を使用した完全な Java ガイド](./convert-html-to-webp-complete-java-guide-with-aspose-html/) Aspose.HTML for Java を使用して HTML を WebP に変換します。完全な Java ガイドでステップバイステップの手順を紹介します。 +### [Java で HTML ページを PNG に保存 – 完全チュートリアル](./save-html-page-as-png-in-java-complete-tutorial/) + ## よくある質問 **Q: 追加の画像ライブラリなしで Java で HTML を PNG に変換できますか？** diff --git a/html/japanese/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/japanese/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..02fe1dfb9 --- /dev/null +++ b/html/japanese/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,240 @@ +--- +category: general +date: 2026-03-17 +description: HTMLページをPNGとしてすばやく保存する方法を学びましょう。このガイドでは、Aspose.HTML を使用して Java で HTML + を PNG にレンダリングし、ビューポートサイズを設定する方法を示します。 +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: ja +og_description: JavaでHTMLページをPNGとして保存します。このチュートリアルでは、Aspose.HTML を使用して HTML を PNG + にレンダリングし、Javaでビューポートサイズを設定する方法を学びます。 +og_title: JavaでHTMLページをPNGに保存する – ステップバイステップガイド +tags: +- Java +- AsposeHTML +- Image Rendering +title: JavaでHTMLページをPNGとして保存する – 完全チュートリアル +url: /ja/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +text of image? The alt text "Screenshot of rendered HTML saved as PNG" should be translated? Probably yes, but keep the URL unchanged. The title attribute also. So translate alt and title. + +Also translate the "Pro tip:" etc. + +Make sure to keep code block placeholders unchanged. + +Let's produce final markdown. + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Save HTML Page as PNG in Java – Complete Tutorial + +HTMLページを **PNGとして保存** したいけど、どこから始めればいいか分からないことはありませんか？同じ悩みを抱える開発者は多く、レポートやサムネイル、テスト用にウェブページのスクリーンショットが必要になることがあります。このガイドでは、Aspose.HTML for Java を使って **HTMLをPNGにレンダリングする方法** を解説し、**Javaでビューポートサイズを設定する方法** も併せて紹介します。 + +ライブラリのインストールからデバイスピクセル比の調整まで網羅し、最終的には任意のURLから鮮明なPNGファイルを生成できる、実行可能なプログラムを手に入れられます。曖昧な説明は一切なく、完全な自己完結型ソリューションです。 + +## What You’ll Need + +始める前に以下を用意してください。 + +- Java 11 以上（現在の LTS バージョンで問題ありません） +- Maven または Gradle（依存関係管理に使用します。Maven の例を示します） +- サンプル URL（`https://example.com`）またはキャプチャしたい任意のページへのインターネット接続 +- PNG を保存できる書き込み可能なディレクトリ + +以上だけです。追加の SDK やネイティブバイナリは不要です。Aspose.HTML が内部で重い処理をすべて行います。 + +## Step 1: Add Aspose.HTML Dependency + +まず、Aspose.HTML ライブラリをプロジェクトに追加します。Maven を使用している場合は、`pom.xml` に以下を追加してください。 + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Gradle を使用している場合は、`build.gradle` に次の行を追加します。 + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Pro tip:** 最新バージョンは [Aspose.HTML release notes](https://docs.aspose.com/html/java/) で確認できます。新しいビルドにはレンダリング性能の改善が含まれていることが多いです。 + +## Step 2: Load the HTML Document from a URL + +次に、キャプチャしたいページを指す `HTMLDocument` オブジェクトを作成します。このステップが **HTMLをPNGにレンダリングする方法** の核心で、ライブラリがマークアップを解析し、内部で DOM を構築します。 + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +ローカルファイルを使用したい場合は、URL 文字列を `"file:///C:/mypage.html"` のようなファイルパスに置き換えてください。 + +## Step 3: Configure the Sandbox and Set Viewport Size + +サンドボックスはレンダリングをメインスレッドから分離し、仮想デバイスの特性を定義できるようにします。ここで **Javaでビューポートサイズを設定** し、ビットマップの寸法を制御します。 + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +サンドボックスを使う理由は何ですか？ネットワーク要求がレンダリングコンテキスト外に漏れるのを防ぎ、決定的な結果を得られるからです。特に CI サーバー上でコードを実行する場合に重要です。 + +## Step 4: Prepare Image Save Options + +Aspose.HTML は多数のフォーマット（PNG、JPEG、BMP など）にエクスポートできます。`ImageSaveOptions` を設定して、ドキュメントの最初のページを PNG 形式で保存するように構成します。 + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +マルチページの画像シーケンスが必要な場合は、`setPageNumber` を `2` や `-1`（すべてのページ）に変更してください。 + +## Step 5: Render and Save the PNG File + +最後に、`HTMLDocument` の `save` メソッドを呼び出します。このメソッドは前述のサンドボックス設定をすべて考慮し、ピクセル単位で正確なスクリーンショットを生成します。 + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +プログラムを実行すると、コンソールにファイル保存場所が表示されます。PNG を開くと、`https://example.com` が 1280 × 800 ピクセル、デバイスピクセル比 2.0 でレンダリングされた正確なビジュアルが確認でき、Retina ディスプレイでも鮮明に表示されます。 + +### Expected Output + +``` +✅ PNG saved to: rendered_page.png +``` + +生成された `rendered_page.png` は高品質な画像ファイルとなり、レポートやメール、UI プレビューへの埋め込みにすぐに利用できます。 + +## How to Render HTML to PNG – Common Variations + +### Rendering a Different Page Size + +別のサイズが必要な場合は、`Size` の値を変更するだけです。 + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### Changing the Device Pixel Ratio + +DPR を `1.0` にすると標準解像度、`3.0` にすると非常に高密度な画面を模倣します。必要に応じて調整してください。 + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Adding Custom Headers or Cookies + +対象ページが認証を必要とする場合は、ロード前にヘッダーを注入できます。 + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Rendering Multiple Pages + +すべてのページを個別の PNG としてエクスポートするには、ページ数分ループします。 + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Troubleshooting Tips + +- **Blank Image:** URL が到達可能で、サンドボックスがインターネットにアクセスできることを確認してください。プロキシ環境下では JVM のプロキシプロパティ（`-Dhttp.proxyHost=…`）を設定します。 +- **Out‑of‑Memory Errors:** 非常に大きなビューポートは大量の RAM を消費します。ビューポートサイズを小さくするか、DPR を下げてください。 +- **Missing Fonts:** Aspose.HTML はデフォルトでシステムフォントを使用します。ページがウェブフォントに依存している場合は、フォントが取得可能であるか、CSS の `@font-face` で埋め込んでください。 + +## Full Working Example (All Code in One Place) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +IDE に貼り付けて、URL または出力パスを調整し、**Run** をクリックしてください。正しく設定されていれば、数秒で PNG が生成されます。 + +## Conclusion + +このチュートリアルでは、Java を使って **HTMLページをPNGとして保存する方法** を示し、**HTMLをPNGにレンダリングする方法** の細部と、**Javaでビューポートサイズを設定する方法** を具体的に解説しました。これで、サムネイル生成やビジュアルレイアウトのテストなど、あらゆる Java プロジェクトに再利用可能なスニペットが手に入ります。 + +### What’s Next? + +- Retina 対応資産向けに `DevicePixelRatio` の値をいろいろ試す +- ヘッドレスブラウザと組み合わせて、動的な JavaScript 重視ページをキャプチャする +- `SaveFormat.PNG` を `SaveFormat.JPEG` や `SaveFormat.PDF` に置き換えて、JPEG や PDF など他の形式でエクスポートする + +コードを自由にカスタマイズし、結果を共有したり、コメントで質問したりしてください。快適なレンダリングをお楽しみください！ + +![Screenshot of rendered HTML saved as PNG](https://example.com/placeholder.png "save html page as png example") + +{{< /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 de4e019fe..c502ed98a 100644 --- a/html/korean/java/conversion-html-to-other-formats/_index.md +++ b/html/korean/java/conversion-html-to-other-formats/_index.md @@ -84,8 +84,10 @@ SVG 그래픽을 XPS 형식으로 변환하여 기기 간 일관된 인쇄를 ## 변환 - HTML 기타 형식 튜토리얼 ### [HTML을 PDF로 변환](./convert-html-to-pdf/) Aspose.HTML를 사용하여 Java에서 HTML을 PDF로 변환하는 방법을 배우세요. HTML 콘텐츠에서 고품질 PDF를 손쉽게 생성합니다. -### [Java에서 HTML을 PDF로 변환 – 페이지 크기 설정을 포함한 단계별 가이드](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) +### [Java에서 HTML을 PDF로 변환 – 페이지 크기 설정을 포함한 단계별 가이드](./convert-html-to-pdf-in-java-step-by-size/) Aspose.HTML를 사용하여 Java에서 페이지 크기 옵션을 지정하며 HTML을 PDF로 변환하는 방법을 단계별로 안내합니다. +### [Java에서 HTML을 PDF로 변환 – 단계별 가이드](./convert-html-to-pdf-with-java-step-by-step-guide/) +Aspose.HTML를 사용해 Java에서 HTML을 PDF로 변환하는 단계별 과정을 자세히 안내합니다. ### [HTML을 MHTML로 변환](./convert-html-to-mhtml/) Aspose.HTML for Java를 사용하여 HTML을 MHTML로 손쉽게 변환합니다. 효율적인 HTML‑to‑MHTML 변환을 위한 단계별 가이드를 따라 주세요. ### [HTML을 XPS로 변환](./convert-html-to-xps/) diff --git a/html/korean/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/korean/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..04bac308f --- /dev/null +++ b/html/korean/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,170 @@ +--- +category: general +date: 2026-03-17 +description: Aspose HTML for Java를 사용하여 HTML을 PDF로 변환합니다. PDF 페이지 크기 설정 방법, HTML에서 + PDF 생성 및 HTML을 PDF로 내보내는 방법을 하나의 튜토리얼에서 배워보세요. +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: ko +og_description: HTML을 빠르게 PDF로 변환합니다. 이 가이드는 PDF 페이지 크기 설정, HTML에서 PDF 생성, 그리고 Aspose + HTML for Java를 사용한 HTML의 PDF 내보내는 방법을 보여줍니다. +og_title: Java로 HTML을 PDF로 변환하기 – 완전한 프로그래밍 가이드 +tags: +- Aspose +- Java +- PDF generation +title: Java로 HTML을 PDF로 변환하기 – 단계별 가이드 +url: /ko/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Java로 HTML을 PDF로 변환 – 단계별 가이드 + +HTML을 PDF로 **변환**해야 하는데 어떤 라이브러리가 출력 결과를 완벽히 제어할 수 있을지 고민한 적 있나요? 여러분만 그런 것이 아닙니다. 청구서 생성기, 보고서 내보내기, e‑learning 플랫폼 등 많은 프로젝트에서 웹 페이지를 인쇄 가능한 PDF로 바꾸는 신뢰할 수 있는 방법이 필요합니다. + +이 튜토리얼에서는 **HTML을 PDF로 변환**하고 **PDF 페이지 크기를 설정**하며 **HTML에서 PDF를 생성**하는 전체 실행 가능한 솔루션을 단계별로 살펴봅니다. 코드를 깔끔하고 유지 보수하기 쉽게 유지하면서, 재사용 가능한 스니펫을 Java 애플리케이션에 바로 삽입할 수 있게 됩니다. 모호한 설명이 아닌 구체적인 코드와 명확한 설명만 제공합니다. + +## 배울 내용 + +- **PdfSaveOptions**를 구성하여 페이지 크기와 여백을 정의하는 방법. +- Aspose.HTML for Java를 사용해 **HTML을 PDF로 내보내는** 정확한 호출 방법. +- 보관용으로 필수적인 PDF/A‑1b 준수 처리 팁. +- 복사‑붙여넣기하고 바로 적용할 수 있는 완전한 실행 예제. + +**전제 조건** – Java 8 이상, Aspose.HTML 라이브러리를 가져올 Maven 또는 Gradle, 그리고 PDF로 변환하고 싶은 간단한 HTML 파일만 있으면 됩니다. 별도의 프레임워크나 웹 서버는 필요하지 않습니다. + +--- + +## 1단계: PDF 페이지 크기와 여백 설정 + +보통 가장 먼저 제어하고 싶은 것은 결과 문서의 크기입니다. 유럽 표준인 A4이든 미국 표준인 Letter이든, Aspose에서는 하나의 객체만으로 지정할 수 있습니다. + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**왜 중요한가요** – 페이지 크기를 명시적으로 설정하지 않으면 라이브러리가 기본값으로 US Letter를 사용하게 되며, 이는 국제 사용자에게 레이아웃이 깨지는 원인이 될 수 있습니다. 여백 값도 밀리미터 단위이므로 인쇄용 디자인과 쉽게 맞출 수 있습니다. + +> **프로 팁:** 맞춤 크기가 필요하면 `PdfPageSize.A4`를 `new com.aspose.html.saving.PdfPageSize(width, height)` 로 교체하세요. 여기서 width와 height는 포인트 단위입니다. + +--- + +## 2단계: HTML에서 PDF 생성 + +출력 형식이 정의되었으니 실제 변환은 한 줄 코드로 끝납니다. `Converter.convert` 메서드는 HTML 파싱, CSS 적용, 페이지 레스터화까지 모두 처리합니다. + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**작동 방식** – 내부적으로 Aspose는 HTML을 읽어 DOM을 구축하고, 외부 리소스(이미지, 폰트, CSS)를 해석한 뒤 각 렌더링된 페이지를 PDF 스트림에 씁니다. `pdfSaveOptions` 객체를 전달했기 때문에 엔진은 앞서 정의한 페이지 크기, 여백, 준수 설정을 그대로 적용합니다. + +> **자주 묻는 질문:** *HTML이 상대 경로 이미지를 참조하고 있다면?* +> Java 프로세스의 작업 디렉터리가 HTML 파일 위치와 일치하도록 하거나 절대 URL을 사용하면 됩니다. Aspose가 자동으로 리소스를 가져옵니다. + +--- + +## 3단계: HTML을 PDF로 내보내기 – 전체 작업 예제 + +전체 흐름을 하나로 묶은 독립 실행형 Java 클래스를 아래에 제공합니다. 필요한 import, 예외 처리, 각 부분을 설명하는 주석이 포함되어 있습니다. + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### 예상 결과 + +프로그램을 실행하면 지정한 폴더에 `output.pdf` 파일이 생성됩니다. Adobe Reader, Foxit, 혹은 브라우저 등 어느 PDF 뷰어로 열어도 `input.html`이 A4 페이지 크기와 20 mm 여백으로 정확히 렌더링된 것을 확인할 수 있습니다. PDF/A‑1b를 활성화했다면 장기 보존을 위한 메타데이터도 포함됩니다. + +--- + +## 자주 묻는 질문 & 예외 상황 + +| Question | Answer | +|----------|--------| +| **Can I convert a URL instead of a local file?** | Yes. Replace the first argument with the URL string, e.g., `"https://example.com/report.html"`. | +| **What if I need a different page orientation?** | Use `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` before conversion. | +| **Is it possible to embed a custom font?** | Absolutely. Place the font file in the same directory as the HTML or reference it via `@font-face` in your CSS; Aspose will embed it automatically. | +| **How do I handle large HTML files that cause memory issues?** | Consider streaming the HTML or splitting it into sections and converting each part separately, then merging the PDFs with Aspose.PDF. | +| **Do I need a license for Aspose.HTML?** | A free evaluation license works for testing, but for production you’ll need a paid license to remove the evaluation watermark. | + +--- + +## 이미지 예시 + +아래는 생성된 PDF의 스크린샷(플레이스홀더 이미지)입니다. **alt** 속성은 주요 키워드를 사용해 SEO와 접근성을 모두 향상시킵니다. + +HTML을 PDF로 변환한 예시 – A4 페이지에 20mm 여백 적용 + +--- + +## 마무리 + +우리는 Aspose.HTML for Java을 이용해 **HTML을 PDF로 변환**, **PDF 페이지 크기 설정**, 그리고 **HTML에서 PDF를 생성**하는 정확한 절차를 살펴보았습니다. 초보자에게도 이해하기 쉬우면서 숙련된 개발자에게는 충분히 유연한 방법입니다. + +다음과 같은 확장을 시도해 보세요: + +- 다른 페이지 크기(`PdfPageSize.LETTER`, 사용자 정의 치수) 사용. +- `PdfSaveOptions`를 통해 워터마크나 머리글/바닥글 추가. +- 여러 HTML 파일을 루프 돌려 변환하고 Aspose.PDF로 하나의 PDF로 병합. + +이러한 확장은 모두 앞서 배운 핵심 개념을 기반으로 하므로, 어떤 워크플로에도 자신 있게 적용할 수 있을 것입니다. + +**행복한 코딩 되세요!** 문제가 생기면 아래 댓글을 남기거나 Aspose 문서를 참고해 고급 기능을 탐구해 보세요. + +{{< /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-various-image-formats/_index.md b/html/korean/java/conversion-html-to-various-image-formats/_index.md index 126ddb6a9..92f9ba7ed 100644 --- a/html/korean/java/conversion-html-to-various-image-formats/_index.md +++ b/html/korean/java/conversion-html-to-various-image-formats/_index.md @@ -98,6 +98,7 @@ Aspose.HTML를 사용해 Java에서 HTML을 PNG 이미지로 변환하는 방법 Aspose.HTML for Java를 사용해 HTML을 TIFF로 쉽게 변환하는 방법을 배웁니다. 효율적인 문서 처리를 위한 단계별 가이드입니다. ### [HTML을 WebP로 변환 – Aspose.HTML와 함께하는 완전한 Java 가이드](./convert-html-to-webp-complete-java-guide-with-aspose-html/) Aspose.HTML for Java를 사용해 HTML을 WebP 이미지로 변환하는 방법을 단계별로 안내합니다. +### [Java에서 HTML 페이지를 PNG로 저장 – 완전한 튜토리얼](./save-html-page-as-png-in-java-complete-tutorial/) ## 자주 묻는 질문 diff --git a/html/korean/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/korean/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..46cac33b2 --- /dev/null +++ b/html/korean/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,232 @@ +--- +category: general +date: 2026-03-17 +description: HTML 페이지를 PNG로 빠르게 저장하는 방법을 배워보세요. 이 가이드는 Aspose.HTML을 사용하여 Java에서 HTML을 + PNG로 렌더링하고 뷰포트 크기를 설정하는 방법을 보여줍니다. +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: ko +og_description: Java로 HTML 페이지를 PNG로 저장하세요. 이 튜토리얼을 따라 Aspose.HTML을 사용하여 HTML을 PNG로 + 렌더링하고 Java에서 뷰포트 크기를 설정하는 방법을 배워보세요. +og_title: Java에서 HTML 페이지를 PNG로 저장하기 – 단계별 가이드 +tags: +- Java +- AsposeHTML +- Image Rendering +title: Java에서 HTML 페이지를 PNG로 저장하기 – 완전 튜토리얼 +url: /ko/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Save HTML Page as PNG in Java – Complete Tutorial + +HTML 페이지를 **PNG로 저장**해야 하는데 어디서 시작해야 할지 몰라 고민했던 적 있나요? 혼자가 아닙니다—보고서, 썸네일, 테스트 등에서 웹 페이지의 스크린샷이 필요할 때 많은 개발자들이 이 문제에 부딪힙니다. 이 가이드에서는 Aspose.HTML for Java를 사용해 **HTML을 PNG로 렌더링하는 방법**을 단계별로 설명하고, **Java에서 뷰포트 크기 설정** 방법도 보여드립니다. + +라이브러리 설치부터 디바이스 픽셀 비율 조정까지 모두 다루며, 최종적으로 어떤 URL이든 깔끔한 PNG 파일을 생성하는 완전한 실행 프로그램을 제공할 것입니다. 모호한 참고 자료는 없으며, 완전하고 독립적인 솔루션만을 제공합니다. + +## What You’ll Need + +시작하기 전에 다음이 준비되어 있는지 확인하세요: + +- Java 11 이상 (현재 LTS 버전이 완벽히 작동합니다) +- Maven 또는 Gradle (의존성 관리를 위해, Maven 예시를 보여드립니다) +- 샘플 URL(`https://example.com`) 또는 캡처하고 싶은 페이지에 대한 인터넷 연결 +- PNG 파일을 저장할 수 있는 쓰기 가능한 디스크 디렉터리 + +이것만 있으면 됩니다—추가 SDK나 네이티브 바이너리는 필요 없습니다. Aspose.HTML가 내부에서 무거운 작업을 처리합니다. + +## Step 1: Add Aspose.HTML Dependency + +먼저 Aspose.HTML 라이브러리를 프로젝트에 추가합니다. Maven을 사용한다면 `pom.xml`에 다음을 삽입하세요: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Gradle을 사용하는 경우 `build.gradle`에 아래를 추가하면 됩니다: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **팁:** 최신 버전은 [Aspose.HTML 릴리스 노트](https://docs.aspose.com/html/java/)에서 확인하세요. 최신 빌드에는 렌더링 성능 향상이 포함되는 경우가 많습니다. + +## Step 2: Load the HTML Document from a URL + +이제 캡처하려는 페이지를 가리키는 `HTMLDocument` 객체를 생성합니다. 이 단계가 **HTML을 PNG로 렌더링하는 방법**의 핵심이며, 라이브러리가 마크업을 파싱해 내부적으로 DOM을 구축합니다. + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +로컬 파일을 사용하고 싶다면 URL 문자열을 `"file:///C:/mypage.html"` 같은 파일 경로로 바꾸면 됩니다. + +## Step 3: Configure the Sandbox and Set Viewport Size + +샌드박스는 렌더링을 메인 애플리케이션 스레드와 격리하고 가상 디바이스 특성을 정의할 수 있게 해줍니다. 여기서 **Java에서 뷰포트 크기 설정**을 통해 렌더링된 비트맵의 차원을 제어합니다. + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +샌드박스를 사용하는 이유는 무엇일까요? 네트워크 요청이 렌더링 컨텍스트 밖으로 새어나가는 것을 방지하고, CI 서버에서 실행할 때도 결정적인 결과를 얻을 수 있기 때문입니다. + +## Step 4: Prepare Image Save Options + +Aspose.HTML는 PNG, JPEG, BMP 등 다양한 포맷으로 내보낼 수 있습니다. `ImageSaveOptions`를 설정해 문서의 첫 페이지를 대상으로 PNG 형식으로 저장하도록 구성합니다. + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +멀티 페이지 이미지 시퀀스가 필요하다면 `setPageNumber`를 `2` 혹은 `-1`(전체 페이지) 로 변경하면 됩니다. + +## Step 5: Render and Save the PNG File + +마지막으로 `HTMLDocument`의 `save` 메서드를 호출합니다. 이 메서드는 앞서 적용한 모든 샌드박스 설정을 반영해 픽셀 단위로 정확한 스크린샷을 생성합니다. + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +프로그램을 실행하면 파일 위치를 알려주는 콘솔 메시지가 표시됩니다. PNG 파일을 열어보면 `https://example.com` 페이지가 1280 × 800 픽셀, 디바이스 픽셀 비율 2.0으로 렌더링된 정확한 시각적 표현을 확인할 수 있습니다. + +### Expected Output + +``` +✅ PNG saved to: rendered_page.png +``` + +생성된 `rendered_page.png`는 고품질 이미지 파일이며, 보고서, 이메일, UI 미리보기 등에 바로 삽입할 수 있습니다. + +## How to Render HTML to PNG – Common Variations + +### Rendering a Different Page Size + +다른 크기가 필요하면 `Size` 값만 바꾸면 됩니다: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### Changing the Device Pixel Ratio + +DPR이 `1.0`이면 표준 해상도 이미지가, `3.0`이면 매우 고밀도 화면을 흉내낸 이미지가 생성됩니다. 필요에 따라 조정하세요: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Adding Custom Headers or Cookies + +대상 페이지가 인증을 요구하는 경우, 로드하기 전에 헤더를 주입할 수 있습니다: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Rendering Multiple Pages + +각 페이지를 별도의 PNG로 내보내려면 페이지 수만큼 반복하면 됩니다: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Troubleshooting Tips + +- **Blank Image:** URL에 접근할 수 있는지, 샌드박스가 인터넷에 연결되어 있는지 확인하세요. 프록시 뒤에 있다면 JVM 프록시 속성(`-Dhttp.proxyHost=…`)을 설정합니다. +- **Out‑of‑Memory Errors:** 매우 큰 뷰포트를 렌더링하면 RAM 사용량이 급증합니다. 뷰포트 크기를 줄이거나 DPR을 낮추세요. +- **Missing Fonts:** Aspose.HTML는 기본적으로 시스템 폰트를 사용합니다. 페이지에 웹 폰트가 필요하면 해당 폰트가 접근 가능하도록 하거나 CSS `@font-face`를 통해 임베드하세요. + +## Full Working Example (All Code in One Place) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +IDE에 복사‑붙여넣기하고 URL이나 출력 경로를 조정한 뒤 **Run**을 누르세요. 모든 설정이 올바르면 몇 초 안에 PNG 파일이 생성됩니다. + +## Conclusion + +이 튜토리얼에서는 Java를 사용해 **HTML 페이지를 PNG로 저장**하는 방법을 보여주었고, **HTML을 PNG로 렌더링하는 방법**의 세부 사항과 **Java에서 뷰포트 크기 설정** 방법을 상세히 다뤘습니다. 이제 백엔드 서비스에서 썸네일을 생성하거나 시각 레이아웃을 검증하는 테스트 하네스 등 어느 Java 프로젝트에든 재사용 가능한 스니펫을 보유하게 되었습니다. + +### What’s Next? + +- 레티나‑준비 자산을 위해 다양한 `DevicePixelRatio` 값을 실험해 보세요. +- 헤드리스 브라우저와 결합해 동적이고 JavaScript‑무거운 페이지도 캡처해 보세요. +- `SaveFormat.PNG`를 `SaveFormat.JPEG` 또는 `SaveFormat.PDF`로 교체해 JPEG나 PDF 같은 다른 포맷으로 내보내는 방법을 탐색해 보세요. + +코드를 자유롭게 수정하고, 결과를 공유하거나 댓글로 질문을 남겨 주세요. 즐거운 렌더링 되세요! + +![렌더링된 HTML이 PNG로 저장된 스크린샷](https://example.com/placeholder.png "HTML 페이지를 PNG로 저장한 예시") + +{{< /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 f5a75bf2c..999bfa073 100644 --- a/html/polish/java/conversion-html-to-other-formats/_index.md +++ b/html/polish/java/conversion-html-to-other-formats/_index.md @@ -84,6 +84,8 @@ Podsumowując, opanowanie **html to pdf java** oraz szerszego zestawu konwersji ## Konwersja - Samouczki HTML do Innych Formatów ### [Converting HTML to PDF](./convert-html-to-pdf/) Learn how to convert HTML to PDF in Java using Aspose.HTML. Create high-quality PDFs from your HTML content effortlessly. +### [Konwertowanie HTML do PDF w Javie – Przewodnik krok po kroku](./convert-html-to-pdf-with-java-step-by-step-guide/) +Dowiedz się, jak w prosty sposób konwertować HTML do PDF w Javie, korzystając z Aspose.HTML, krok po kroku. ### [Konwertowanie HTML do PDF w Javie – Przewodnik krok po kroku z ustawieniami rozmiaru strony](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) Dowiedz się, jak konwertować HTML do PDF w Javie, ustawiając rozmiar strony krok po kroku. ### [Converting HTML to MHTML](./convert-html-to-mhtml/) diff --git a/html/polish/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/polish/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..165f3dca2 --- /dev/null +++ b/html/polish/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,172 @@ +--- +category: general +date: 2026-03-17 +description: Konwertuj HTML na PDF przy użyciu Aspose HTML for Java. Dowiedz się, + jak ustawić rozmiar strony PDF, wygenerować PDF z HTML oraz wyeksportować HTML jako + PDF w jednym samouczku. +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: pl +og_description: Szybko konwertuj HTML na PDF. Ten przewodnik pokazuje, jak ustawić + rozmiar strony PDF, wygenerować PDF z HTML oraz wyeksportować HTML jako PDF przy + użyciu Aspose HTML for Java. +og_title: Konwertuj HTML na PDF w Javie – Kompletny przewodnik programistyczny +tags: +- Aspose +- Java +- PDF generation +title: Konwertuj HTML do PDF w Javie – Przewodnik krok po kroku +url: /pl/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Konwersja HTML do PDF w Javie – Przewodnik krok po kroku + +Kiedykolwiek potrzebowałeś **przekształcić HTML do PDF**, ale nie byłeś pewien, która biblioteka da Ci pełną kontrolę nad wynikiem? Nie jesteś sam. W wielu projektach — myśl o generatorach faktur, eksporterach raportów czy platformach e‑learningowych — znajdziesz się w sytuacji, w której potrzebny jest niezawodny sposób na zamianę stron internetowych w drukowalne PDF‑y. + +W tym tutorialu przeprowadzimy Cię przez kompletną, gotową do uruchomienia rozwiązanie, które **konwertuje HTML do PDF**, pozwala **ustawić rozmiar strony PDF** i pokazuje, jak **generować PDF z HTML**, zachowując czysty i utrzymywalny kod. Po zakończeniu będziesz mieć fragment, który możesz wkleić do dowolnej aplikacji Java. Bez niejasnych odniesień, tylko konkretny kod i klarowne wyjaśnienia. + +## Czego się nauczysz + +- Jak skonfigurować **PdfSaveOptions**, aby określić wymiary i marginesy strony. +- Dokładne wywołanie, którego potrzebujesz, aby **wyeksportować HTML jako PDF** przy użyciu Aspose.HTML for Java. +- Wskazówki dotyczące obsługi zgodności PDF/A‑1b, co jest niezbędne przy archiwizacji. +- Pełny, działający przykład, który możesz skopiować i dostosować. + +**Wymagania wstępne** – potrzebujesz Javy 8 lub nowszej, Maven lub Gradle do pobrania biblioteki Aspose.HTML oraz prostego pliku HTML, który chcesz przekształcić w PDF. To wszystko; nie są potrzebne dodatkowe frameworki ani serwery WWW. + +--- + +## Krok 1: Ustaw rozmiar i marginesy strony PDF + +Pierwszą rzeczą, którą zazwyczaj chcesz kontrolować, jest rozmiar powstałego dokumentu. Niezależnie od tego, czy potrzebujesz formatu A4 dla standardów europejskich, czy Letter dla USA, Aspose pozwala określić to jednym obiektem. + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**Dlaczego to ważne** – Bez wyraźnego ustawienia rozmiaru strony biblioteka może domyślnie przyjąć US Letter, co może zepsuć układy dla użytkowników międzynarodowych. Wartości marginesów podawane są w milimetrach, co ułatwia dopasowanie do projektów gotowych do druku. + +> **Pro tip:** Jeśli potrzebujesz niestandardowego rozmiaru, zamień `PdfPageSize.A4` na `new com.aspose.html.saving.PdfPageSize(width, height)`, gdzie szerokość i wysokość podane są w punktach. + +--- + +## Krok 2: Generuj PDF z HTML + +Teraz, gdy format wyjściowy jest określony, faktyczna konwersja to jednowierszowy kod. Metoda `Converter.convert` zajmuje się parsowaniem HTML, stosowaniem CSS i rasteryzacją strony do PDF. + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**Jak to działa** – W tle Aspose odczytuje HTML, buduje DOM, rozwiązuje zewnętrzne zasoby (obrazy, czcionki, CSS), a następnie zapisuje każdą wyrenderowaną stronę do strumienia PDF. Ponieważ przekazaliśmy obiekt `pdfSaveOptions`, silnik respektuje rozmiar strony, marginesy i ustawienia zgodności, które zdefiniowaliśmy wcześniej. + +> **Częste pytanie:** *Co zrobić, gdy mój HTML odwołuje się do obrazów ze względnymi ścieżkami?* +> Upewnij się, że katalog roboczy procesu Java odpowiada lokalizacji pliku HTML lub użyj bezwzględnych URL‑i. Aspose pobierze zasoby automatycznie. + +--- + +## Krok 3: Eksportuj HTML jako PDF – Pełny działający przykład + +Łącząc wszystkie elementy, oto samodzielna klasa Java, którą możesz skompilować i uruchomić. Zawiera niezbędne importy, obsługę wyjątków oraz komentarze wyjaśniające każdy fragment. + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### Oczekiwany rezultat + +Po uruchomieniu programu znajdziesz plik `output.pdf` w tym samym folderze, który wskazałeś. Otwórz go w dowolnym przeglądarce PDF — Adobe Reader, Foxit czy nawet w przeglądarce internetowej — i zobaczysz wierne odwzorowanie `input.html`, z rozmiarem strony A4 i marginesami 20 mm, które ustawiłeś. Jeśli włączyłeś PDF/A‑1b, plik będzie także zawierał niezbędne metadane do długoterminowego przechowywania. + +--- + +## Najczęściej zadawane pytania i przypadki brzegowe + +| Pytanie | Odpowiedź | +|----------|-----------| +| **Czy mogę konwertować URL zamiast pliku lokalnego?** | Tak. Zamień pierwszy argument na ciąg URL, np. `"https://example.com/report.html"`. | +| **Co zrobić, jeśli potrzebuję innej orientacji strony?** | Użyj `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` przed konwersją. | +| **Czy można osadzić własną czcionkę?** | Oczywiście. Umieść plik czcionki w tym samym katalogu co HTML lub odwołaj się do niej za pomocą `@font-face` w CSS; Aspose osadzi ją automatycznie. | +| **Jak radzić sobie z dużymi plikami HTML, które powodują problemy z pamięcią?** | Rozważ strumieniowanie HTML lub podzielenie go na sekcje i konwersję każdej części osobno, a następnie połączenie PDF‑ów przy użyciu Aspose.PDF. | +| **Czy potrzebna jest licencja na Aspose.HTML?** | Licencja ewaluacyjna działa w trybie testowym, ale w produkcji potrzebna jest płatna licencja, aby usunąć znak wodny oceny. | + +--- + +## Ilustracja graficzna + +Poniżej szybki zrzut ekranu wygenerowanego PDF (obraz zastępczy). Atrybut **alt** wykorzystuje główne słowo kluczowe, co pomaga zarówno SEO, jak i dostępności. + +przykład konwersji html do pdf pokazujący stronę A4 z marginesami + +--- + +## Podsumowanie + +Właśnie omówiliśmy, jak **konwertować HTML do PDF** przy użyciu Aspose.HTML for Java, jak **ustawić rozmiar strony PDF** oraz dokładne kroki, aby **generować PDF z HTML**, zachowując proces prostym dla początkujących i elastycznym dla doświadczonych deweloperów. + +Jeśli chcesz pójść dalej, wypróbuj: + +- Różne rozmiary stron (`PdfPageSize.LETTER`, wymiary niestandardowe). +- Dodawanie znaków wodnych lub nagłówków/stopki za pomocą `PdfSaveOptions`. +- Konwersję wielu plików HTML w pętli i scalanie ich w jeden PDF. + +Te rozszerzenia opierają się na tych samych podstawowych koncepcjach, które poznaliśmy, więc łatwo dostosujesz kod do dowolnego workflow. + +**Miłego kodowania!** Jeśli napotkasz problemy, zostaw komentarz poniżej lub zajrzyj do dokumentacji Aspose, aby zgłębić zaawansowane funkcje. + +{{< /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-various-image-formats/_index.md b/html/polish/java/conversion-html-to-various-image-formats/_index.md index 2e1d027d5..763884e2e 100644 --- a/html/polish/java/conversion-html-to-various-image-formats/_index.md +++ b/html/polish/java/conversion-html-to-various-image-formats/_index.md @@ -94,6 +94,9 @@ Dowiedz się, jak konwertować HTML do JPEG przy użyciu Aspose.HTML for Java. P ### [Converting HTML to PNG](./convert-html-to-png/) Dowiedz się, jak konwertować HTML do obrazów PNG w Javie przy użyciu Aspose.HTML. Kompleksowy przewodnik z instrukcjami krok po kroku. +### [Zapisz stronę HTML jako PNG w Javie – Kompletny samouczek](./save-html-page-as-png-in-java-complete-tutorial/) +Dowiedz się, jak zapisać stronę HTML jako plik PNG w Javie przy użyciu Aspose.HTML – pełny przewodnik krok po kroku. + ### [Converting HTML to TIFF](./convert-html-to-tiff/) Dowiedz się, jak łatwo konwertować HTML do TIFF przy użyciu Aspose.HTML for Java. Przewodnik krok po kroku dla efektywnego zarządzania dokumentami. diff --git a/html/polish/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/polish/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..bc2a2fc31 --- /dev/null +++ b/html/polish/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,232 @@ +--- +category: general +date: 2026-03-17 +description: Dowiedz się, jak szybko zapisać stronę HTML jako PNG. Ten przewodnik + pokazuje, jak renderować HTML do PNG i ustawiać rozmiar viewportu w Javie przy użyciu + Aspose.HTML. +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: pl +og_description: Zapisz stronę HTML jako PNG w Javie. Skorzystaj z tego samouczka, + aby dowiedzieć się, jak renderować HTML do PNG i ustawiać rozmiar viewportu w Javie + przy użyciu Aspose.HTML. +og_title: Zapisz stronę HTML jako PNG w Javie – Przewodnik krok po kroku +tags: +- Java +- AsposeHTML +- Image Rendering +title: Zapisz stronę HTML jako PNG w Javie – kompletny poradnik +url: /pl/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Zapisz stronę HTML jako PNG w Javie – Kompletny poradnik + +Kiedykolwiek potrzebowałeś **save HTML page as PNG**, ale nie wiedziałeś od czego zacząć? Nie jesteś sam — wielu programistów napotyka ten problem, gdy potrzebują szybkiego zrzutu ekranu strony internetowej do raportów, miniatur lub testów. W tym przewodniku przeprowadzimy Cię przez **how to render HTML to PNG** przy użyciu Aspose.HTML dla Javy, a także pokażemy, jak **set viewport size Java**, aby wynik wyglądał dokładnie tak, jak oczekujesz. + +Omówimy wszystko, od instalacji biblioteki po dostosowanie device pixel ratio, i pod koniec będziesz mieć gotowy do uruchomienia program, który generuje wyraźny plik PNG z dowolnego URL. Bez niejasnych odniesień, tylko kompletny, samodzielny rozwiązanie. + +## Czego będziesz potrzebować + +- Java 11 lub nowszy (obecna wersja LTS działa perfekcyjnie) +- Maven lub Gradle do zarządzania zależnościami (pokażemy fragment Maven) +- Połączenie internetowe dla przykładowego URL (`https://example.com`) lub dowolnej strony, którą chcesz przechwycić +- Zapisywalny katalog na dysku, w którym zostanie zapisany PNG + +To wszystko — bez dodatkowych SDK, bez natywnych binarek. Aspose.HTML radzi sobie z ciężką pracą wewnętrznie. + +## Krok 1: Dodaj zależność Aspose.HTML + +Najpierw pobierz bibliotekę Aspose.HTML do swojego projektu. Jeśli używasz Maven, dodaj poniższy kod do swojego `pom.xml`: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Użytkownicy Gradle mogą wstawić to do `build.gradle`: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Pro tip:** Sprawdź [Aspose.HTML release notes](https://docs.aspose.com/html/java/) aby uzyskać najnowszą wersję; nowsze buildy często zawierają poprawki wydajności renderowania. + +## Krok 2: Załaduj dokument HTML z URL + +Teraz utworzymy obiekt `HTMLDocument`, który wskazuje na stronę, którą chcesz przechwycić. Ten krok jest rdzeniem **how to render HTML to PNG**, ponieważ biblioteka parsuje znacznik i buduje DOM wewnętrznie. + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +Jeśli wolisz plik lokalny, po prostu zamień ciąg URL na ścieżkę pliku, np. `"file:///C:/mypage.html"`. + +## Krok 3: Skonfiguruj Sandbox i ustaw rozmiar Viewport + +Sandbox izoluje renderowanie od głównego wątku aplikacji i pozwala zdefiniować wirtualne cechy urządzenia. To tutaj **set viewport size Java**, aby kontrolować wymiary renderowanego bitmapy. + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +Po co sandbox? Zapobiega skutkom ubocznym, takim jak wycieki żądań sieciowych poza kontekst renderowania, i daje deterministyczne wyniki — szczególnie ważne, gdy uruchamiasz kod na serwerze CI. + +## Krok 4: Przygotuj opcje zapisu obrazu + +Aspose.HTML może eksportować do wielu formatów (PNG, JPEG, BMP, itp.). Skonfigurujemy `ImageSaveOptions`, aby skierować się na pierwszą stronę dokumentu i określić PNG jako format wyjściowy. + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +Możesz zmienić `setPageNumber` na `2` lub `-1` (wszystkie strony), jeśli potrzebujesz sekwencji obrazów wielostronicowych. + +## Krok 5: Renderuj i zapisz plik PNG + +Na koniec wywołaj `save` na `HTMLDocument`. Metoda respektuje wszystkie ustawienia sandbox, które zastosowaliśmy wcześniej, tworząc pixel‑perfect zrzut ekranu. + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +Gdy uruchomisz program, powinieneś zobaczyć komunikat w konsoli potwierdzający lokalizację pliku. Otwórz PNG — zobaczysz dokładną wizualną reprezentację `https://example.com` w rozdzielczości 1280 × 800 pikseli, renderowaną przy device pixel ratio równym 2.0 (więc obraz wygląda ostro na wyświetlaczach Retina). + +### Oczekiwany wynik + +``` +✅ PNG saved to: rendered_page.png +``` + +Wynikowy `rendered_page.png` będzie wysokiej jakości plikiem obrazu, gotowym do osadzenia w raportach, e‑mailach lub podglądach UI. + +## Jak renderować HTML do PNG – typowe warianty + +### Renderowanie innego rozmiaru strony + +Jeśli potrzebujesz innego wymiaru, po prostu zmień wartości `Size`: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### Zmiana Device Pixel Ratio + +DPR równy `1.0` daje obraz o standardowej rozdzielczości, natomiast `3.0` naśladuje ekrany o bardzo wysokiej gęstości. Dostosuj w razie potrzeby: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Dodawanie własnych nagłówków lub ciasteczek + +Czasami docelowa strona wymaga uwierzytelnienia. Możesz wstrzyknąć nagłówki przed załadowaniem: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Renderowanie wielu stron + +Aby wyeksportować każdą stronę jako osobny PNG, iteruj po liczbie stron: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Wskazówki rozwiązywania problemów + +- **Blank Image:** Upewnij się, że URL jest dostępny i sandbox ma dostęp do internetu. Jeśli jesteś za proxy, ustaw właściwości proxy JVM (`-Dhttp.proxyHost=…`). +- **Out‑of‑Memory Errors:** Renderowanie bardzo dużych viewportów może zużywać dużo pamięci RAM. Zmniejsz rozmiar viewportu lub obniż DPR. +- **Missing Fonts:** Aspose.HTML używa domyślnie czcionek systemowych. Jeśli Twoja strona korzysta z czcionek internetowych, upewnij się, że są dostępne lub osadź je za pomocą CSS `@font-face`. + +## Pełny działający przykład (cały kod w jednym miejscu) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +Skopiuj i wklej to do swojego IDE, dostosuj URL lub ścieżkę wyjścia i naciśnij **Run**. Jeśli wszystko jest poprawnie skonfigurowane, będziesz mieć PNG w kilka sekund. + +## Zakończenie + +W tym poradniku pokazaliśmy Ci **how to save HTML page as PNG** przy użyciu Javy, omówiliśmy niuanse **how to render HTML to PNG**, i przedstawiliśmy dokładne kroki do **set viewport size Java** dla precyzyjnej kontroli nad wynikiem. Masz teraz wielokrotnego użytku fragment kodu, który można wkleić do dowolnego projektu Java — niezależnie od tego, czy jest to usługa backendowa generująca miniatury, czy harness testowy walidujący układy wizualne. + +### Co dalej? + +- Eksperymentuj z różnymi wartościami `DevicePixelRatio` dla zasobów gotowych na Retina. +- Połącz to podejście z przeglądarką headless, aby przechwytywać dynamiczne, obciążone JavaScriptem strony. +- Zbadaj inne formaty eksportu, takie jak JPEG lub PDF, zamieniając `SaveFormat.PNG` na `SaveFormat.JPEG` lub `SaveFormat.PDF`. + +Śmiało modyfikuj kod, udostępniaj wyniki lub zadawaj pytania w komentarzach. Szczęśliwego renderowania! + +![Screenshot of rendered HTML saved as PNG](https://example.com/placeholder.png "save html page as png example") + +{{< /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 7a450e146..51d88afde 100644 --- a/html/portuguese/java/conversion-html-to-other-formats/_index.md +++ b/html/portuguese/java/conversion-html-to-other-formats/_index.md @@ -83,21 +83,14 @@ Em conclusão, dominar **html to pdf java** e o conjunto mais amplo de conversõ ## Conversão - Tutoriais de HTML para Outros Formatos ### [Convertendo HTML para PDF](./convert-html-to-pdf/) -Aprenda como converter HTML para PDF em Java usando Aspose.HTML. Crie PDFs de alta qualidade a partir do seu conteúdo HTML sem esforço. ### [Converter HTML para PDF em Java – Guia passo a passo com configurações de tamanho de página](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) -Aprenda a converter HTML para PDF em Java, definindo tamanhos de página personalizados passo a passo. +### [Converter HTML para PDF com Java – Guia passo a passo](./convert-html-to-pdf-with-java-step-by-step-guide/) ### [Convertendo HTML para MHTML](./convert-html-to-mhtml/) -Converta HTML para MHTML facilmente usando Aspose.HTML for Java. Siga nosso guia passo a passo para uma conversão eficiente de HTML‑para‑MHTML. ### [Convertendo HTML para XPS](./convert-html-to-xps/) -Aprenda como converter HTML para XPS usando Aspose.HTML for Java. Crie documentos multiplataforma com facilidade. ### [Convertendo Markdown para HTML](./convert-markdown-to-html/) -Converta Markdown para HTML em Java de forma fluida com Aspose.HTML for Java. Siga nosso guia passo a passo para simplificar suas necessidades de conversão de documentos. ### [Convertendo SVG para Imagem](./convert-svg-to-image/) -Aprenda como converter SVG para imagens em Java com Aspose.HTML. Guia abrangente para saída de alta qualidade. ### [Convertendo SVG para PDF](./convert-svg-to-pdf/) -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. ## Perguntas Frequentes diff --git a/html/portuguese/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/portuguese/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..dfcb7826b --- /dev/null +++ b/html/portuguese/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,180 @@ +--- +category: general +date: 2026-03-17 +description: Converta HTML em PDF usando Aspose HTML para Java. Aprenda como definir + o tamanho da página PDF, gerar PDF a partir de HTML e exportar HTML como PDF em + um único tutorial. +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: pt +og_description: Converta HTML em PDF rapidamente. Este guia mostra como definir o + tamanho da página PDF, gerar PDF a partir de HTML e exportar HTML como PDF usando + o Aspose HTML for Java. +og_title: Converter HTML para PDF com Java – Guia Completo de Programação +tags: +- Aspose +- Java +- PDF generation +title: Converter HTML em PDF com Java – Guia passo a passo +url: /pt/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +the "Image Illustration" heading. + +Also translate "Wrap‑Up" heading. + +Also translate "Happy coding!" maybe "Bom codificação!" but maybe "Feliz codificação!" but typical Portuguese: "Bom código!" but we can say "Feliz codificação!" Keep exclamation. + +Let's produce final content. + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Converter HTML para PDF com Java – Guia Passo a Passo + +Já precisou **converter HTML para PDF** mas não sabia qual biblioteca ofereceria controle total sobre o resultado? Você não está sozinho. Em muitos projetos—como geradores de faturas, exportadores de relatórios ou plataformas de e‑learning—você vai precisar de uma maneira confiável de transformar páginas web em PDFs imprimíveis. + +Neste tutorial vamos percorrer uma solução completa, pronta‑para‑executar que **converte HTML para PDF**, permite **definir o tamanho da página PDF** e mostra como **gerar PDF a partir de HTML** mantendo o código limpo e fácil de manter. Ao final, você terá um trecho reutilizável que pode ser inserido em qualquer aplicação Java. Sem referências vagas, apenas código concreto e explicações claras. + +## O que você vai aprender + +- Como configurar **PdfSaveOptions** para definir dimensões e margens da página. +- A chamada exata que você precisa para **exportar HTML como PDF** usando Aspose.HTML for Java. +- Dicas para lidar com conformidade PDF/A‑1b, essencial para arquivamento. +- Um exemplo completo, executável, que você pode copiar‑colar e adaptar. + +**Pré‑requisitos** – você precisará do Java 8 ou superior, Maven ou Gradle para obter a biblioteca Aspose.HTML, e um arquivo HTML simples que deseja transformar em PDF. É só isso; não são necessários frameworks extras ou servidores web. + +--- + +## Etapa 1: Definir tamanho da página PDF e margens + +A primeira coisa que você geralmente quer controlar é o tamanho do documento resultante. Seja A4 para padrões europeus ou Letter para os EUA, o Aspose permite especificá‑lo com um único objeto. + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**Por que isso importa** – Sem definir explicitamente o tamanho da página, a biblioteca pode usar US Letter como padrão, o que pode bagunçar layouts para usuários internacionais. Os valores das margens também estão em milímetros, facilitando a correspondência com designs prontos para impressão. + +> **Dica de especialista:** Se precisar de um tamanho personalizado, substitua `PdfPageSize.A4` por `new com.aspose.html.saving.PdfPageSize(width, height)` onde largura e altura são em pontos. + +--- + +## Etapa 2: Gerar PDF a partir de HTML + +Agora que o formato de saída está definido, a conversão real é feita em uma única linha. O método `Converter.convert` cuida da análise do HTML, aplicação do CSS e rasterização da página em PDF. + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**Como funciona** – Nos bastidores, o Aspose lê o HTML, constrói um DOM, resolve recursos externos (imagens, fontes, CSS) e, em seguida, grava cada página renderizada no fluxo PDF. Como passamos o objeto `pdfSaveOptions`, o motor respeita o tamanho da página, margens e configurações de conformidade que definimos anteriormente. + +> **Pergunta comum:** *E se meu HTML referenciar imagens com caminhos relativos?* +> Basta garantir que o diretório de trabalho do seu processo Java corresponda à localização do arquivo HTML, ou use URLs absolutas. O Aspose buscará os recursos automaticamente. + +--- + +## Etapa 3: Exportar HTML como PDF – Exemplo completo funcional + +Juntando as peças, aqui está uma classe Java autocontida que você pode compilar e executar. Ela inclui as importações necessárias, tratamento de exceções e comentários que explicam cada parte. + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### Resultado esperado + +Após executar o programa, você encontrará `output.pdf` na mesma pasta que você indicou. Abra-o com qualquer visualizador de PDF—Adobe Reader, Foxit ou até mesmo um navegador—e verá uma renderização fiel de `input.html`, com o tamanho de página A4 e margens de 20 mm que você definiu. Se você habilitou PDF/A‑1b, o arquivo também conterá os metadados necessários para preservação a longo prazo. + +--- + +## Perguntas Frequentes & Casos de Borda + +| Pergunta | Resposta | +|----------|----------| +| **Posso converter uma URL em vez de um arquivo local?** | Sim. Substitua o primeiro argumento pela string da URL, por exemplo, `"https://example.com/report.html"`. | +| **E se eu precisar de uma orientação de página diferente?** | Use `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` antes da conversão. | +| **É possível incorporar uma fonte personalizada?** | Absolutamente. Coloque o arquivo de fonte no mesmo diretório do HTML ou referencie‑o via `@font-face` no seu CSS; o Aspose o incorporará automaticamente. | +| **Como lidar com arquivos HTML grandes que causam problemas de memória?** | Considere fazer streaming do HTML ou dividi‑lo em seções e converter cada parte separadamente, depois mesclar os PDFs com Aspose.PDF. | +| **Preciso de licença para o Aspose.HTML?** | Uma licença de avaliação gratuita funciona para testes, mas para produção você precisará de uma licença paga para remover a marca d'água de avaliação. | + +--- + +## Ilustração de Imagem + +Abaixo está uma captura de tela rápida do PDF gerado (imagem placeholder). O atributo **alt** usa a palavra‑chave principal, ajudando tanto o SEO quanto a acessibilidade. + +exemplo de conversão de html para pdf mostrando página A4 com margens + +--- + +## Conclusão + +Acabamos de cobrir como **converter HTML para PDF** usando Aspose.HTML for Java, como **definir o tamanho da página PDF** e os passos exatos para **gerar PDF a partir de HTML** mantendo o processo simples o suficiente para iniciantes e flexível o bastante para desenvolvedores experientes. + +Se você está pronto para avançar, experimente: + +- Diferentes tamanhos de página (`PdfPageSize.LETTER`, dimensões personalizadas). +- Adicionar marcas d'água ou cabeçalhos/rodapés via `PdfSaveOptions`. +- Converter múltiplos arquivos HTML em um loop e mesclá‑los em um único PDF. + +Essas extensões se baseiam nos mesmos conceitos centrais que exploramos, então você se sentirá confortável adaptando o código a qualquer fluxo de trabalho. + +**Feliz codificação!** Se encontrar algum problema, deixe um comentário abaixo ou consulte a documentação do Aspose para aprofundar-se em recursos avançados. + +{{< /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-various-image-formats/_index.md b/html/portuguese/java/conversion-html-to-various-image-formats/_index.md index 5b1531c71..515120086 100644 --- a/html/portuguese/java/conversion-html-to-various-image-formats/_index.md +++ b/html/portuguese/java/conversion-html-to-various-image-formats/_index.md @@ -94,6 +94,8 @@ Aprenda a converter HTML para imagens PNG em Java com Aspose.HTML. Um guia abran Aprenda a converter HTML para TIFF usando Aspose.HTML for Java de forma fácil. Guia passo a passo para manipulação eficiente de documentos. ### [Convertendo HTML para WebP – Guia Completo em Java com Aspose.HTML](./convert-html-to-webp-complete-java-guide-with-aspose-html/) Aprenda a converter HTML para WebP em Java usando Aspose.HTML. Guia completo passo a passo para gerar imagens WebP de alta qualidade. +### [Salvar página HTML como PNG em Java – Tutorial completo](./save-html-page-as-png-in-java-complete-tutorial/) +Aprenda a salvar uma página HTML como PNG em Java usando Aspose.HTML. Guia completo passo a passo. ## Perguntas Frequentes diff --git a/html/portuguese/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/portuguese/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..2eec3fb4c --- /dev/null +++ b/html/portuguese/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,232 @@ +--- +category: general +date: 2026-03-17 +description: Aprenda a salvar uma página HTML como PNG rapidamente. Este guia mostra + como renderizar HTML para PNG e definir o tamanho da viewport em Java usando Aspose.HTML. +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: pt +og_description: Salvar página HTML como PNG com Java. Siga este tutorial para aprender + como renderizar HTML para PNG e definir o tamanho da viewport em Java usando Aspose.HTML. +og_title: Salvar página HTML como PNG em Java – Guia passo a passo +tags: +- Java +- AsposeHTML +- Image Rendering +title: Salvar página HTML como PNG em Java – Tutorial completo +url: /pt/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Salvar página HTML como PNG em Java – Tutorial completo + +Já precisou **salvar página HTML como PNG** mas não sabia por onde começar? Você não está sozinho — muitos desenvolvedores se deparam com esse obstáculo quando precisam de uma captura rápida de uma página web para relatórios, miniaturas ou testes. Neste guia vamos percorrer **como renderizar HTML para PNG** usando Aspose.HTML para Java, e também mostrar como **definir tamanho da viewport Java** para que a saída fique exatamente como você espera. + +Cobriremos tudo, desde a instalação da biblioteca até o ajuste da proporção de pixels do dispositivo, e ao final você terá um programa pronto‑para‑executar que produz um arquivo PNG nítido a partir de qualquer URL. Sem referências vagas, apenas uma solução completa e autônoma. + +## O que você vai precisar + +Antes de mergulharmos, certifique‑se de que você tem: + +- Java 11 ou superior (a versão LTS atual funciona perfeitamente) +- Maven ou Gradle para gerenciar dependências (mostraremos o trecho Maven) +- Uma conexão à internet para a URL de exemplo (`https://example.com`) ou qualquer página que você queira capturar +- Um diretório gravável em disco onde o PNG será salvo + +É só isso — sem SDKs extras, sem binários nativos. Aspose.HTML cuida do trabalho pesado internamente. + +## Etapa 1: Adicionar a dependência Aspose.HTML + +Primeiro, importe a biblioteca Aspose.HTML para o seu projeto. Se você usa Maven, adicione o seguinte ao seu `pom.xml`: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Usuários do Gradle podem inserir isso em `build.gradle`: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Dica profissional:** Consulte as [notas de versão do Aspose.HTML](https://docs.aspose.com/html/java/) para obter a versão mais recente; builds mais recentes costumam incluir melhorias de desempenho para renderização. + +## Etapa 2: Carregar o documento HTML a partir de uma URL + +Agora criaremos um objeto `HTMLDocument` que aponta para a página que você deseja capturar. Esta etapa é o núcleo de **como renderizar HTML para PNG**, pois a biblioteca analisa a marcação e constrói um DOM internamente. + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +Se preferir um arquivo local, basta substituir a string da URL por um caminho de arquivo como `"file:///C:/mypage.html"`. + +## Etapa 3: Configurar a sandbox e definir o tamanho da viewport + +A sandbox isola a renderização da sua thread principal e permite definir as características do dispositivo virtual. É aqui que **definimos o tamanho da viewport Java** para controlar as dimensões do bitmap renderizado. + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +Por que usar uma sandbox? Ela impede efeitos colaterais como requisições de rede vazando fora do contexto de renderização e fornece resultados determinísticos — especialmente importante quando você executa o código em um servidor de CI. + +## Etapa 4: Preparar as opções de salvamento da imagem + +Aspose.HTML pode exportar para vários formatos (PNG, JPEG, BMP, etc.). Configuraremos `ImageSaveOptions` para direcionar a primeira página do documento e especificar PNG como formato de saída. + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +Você pode mudar `setPageNumber` para `2` ou `-1` (todas as páginas) se precisar de uma sequência de imagens multi‑página. + +## Etapa 5: Renderizar e salvar o arquivo PNG + +Por fim, chame `save` no `HTMLDocument`. O método respeita todas as configurações da sandbox que aplicamos anteriormente, produzindo uma captura de tela pixel‑perfect. + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +Ao executar o programa, você deverá ver uma mensagem no console confirmando o local do arquivo. Abra o PNG — você verá a representação visual exata de `https://example.com` em 1280 × 800 pixels, renderizada com uma proporção de pixel de dispositivo de 2.0 (para que a imagem fique nítida em telas Retina). + +### Saída esperada + +``` +✅ PNG saved to: rendered_page.png +``` + +O `rendered_page.png` resultante será um arquivo de imagem de alta qualidade, pronto para ser incorporado em relatórios, e‑mails ou pré‑visualizações de UI. + +## Como renderizar HTML para PNG – Variações comuns + +### Renderizando um tamanho de página diferente + +Se precisar de dimensões distintas, basta alterar os valores de `Size`: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### Alterando a proporção de pixels do dispositivo + +Um DPR de `1.0` gera uma imagem de resolução padrão, enquanto `3.0` imita telas de densidade muito alta. Ajuste conforme necessário: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Adicionando cabeçalhos ou cookies personalizados + +Às vezes a página alvo requer autenticação. Você pode injetar cabeçalhos antes de carregar: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Renderizando múltiplas páginas + +Para exportar cada página como um PNG separado, faça um loop sobre a contagem de páginas: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Dicas de solução de problemas + +- **Imagem em branco:** Verifique se a URL está acessível e se a sandbox tem acesso à internet. Se estiver atrás de um proxy, configure as propriedades de proxy da JVM (`-Dhttp.proxyHost=…`). +- **Erros de Out‑of‑Memory:** Renderizar viewports muito grandes pode consumir muita RAM. Reduza o tamanho da viewport ou diminua o DPR. +- **Fontes ausentes:** Aspose.HTML usa fontes do sistema por padrão. Se sua página depende de web fonts, certifique‑se de que elas estejam acessíveis ou incorpore‑as via CSS `@font-face`. + +## Exemplo completo (todo o código em um único lugar) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +Copie‑e‑cole isso no seu IDE, ajuste a URL ou o caminho de saída, e pressione **Run**. Se tudo estiver configurado corretamente, você terá um PNG em segundos. + +## Conclusão + +Neste tutorial mostramos **como salvar página HTML como PNG** usando Java, abordamos as nuances de **como renderizar HTML para PNG** e demonstramos os passos exatos para **definir tamanho da viewport Java** para controle preciso da saída. Agora você tem um trecho reutilizável que pode ser inserido em qualquer projeto Java — seja um serviço backend que gera miniaturas ou um harness de teste que valida layouts visuais. + +### O que vem a seguir? + +- Experimente diferentes valores de `DevicePixelRatio` para ativos prontos para retina. +- Combine esta abordagem com um navegador headless para capturar páginas dinâmicas, pesadas em JavaScript. +- Explore outros formatos de exportação como JPEG ou PDF trocando `SaveFormat.PNG` por `SaveFormat.JPEG` ou `SaveFormat.PDF`. + +Sinta‑se à vontade para ajustar o código, compartilhar seus resultados ou fazer perguntas nos comentários. Boa renderização! + +![Screenshot of rendered HTML saved as PNG](https://example.com/placeholder.png "save html page as png example") + +{{< /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 7a599423a..be42e7b1a 100644 --- a/html/russian/java/conversion-html-to-other-formats/_index.md +++ b/html/russian/java/conversion-html-to-other-formats/_index.md @@ -85,28 +85,14 @@ Aspose.HTML for Java упрощает процесс конвертации HTML ## Конвертация - Руководства по преобразованию HTML в другие форматы ### [Конвертация HTML в PDF](./convert-html-to-pdf/) -Узнайте, как конвертировать HTML в PDF в Java с помощью Aspose.HTML. Создавайте высококачественные PDF из вашего HTML‑контента без усилий. - ### [Конвертация HTML в MHTML](./convert-html-to-mhtml/) -Легко конвертируйте HTML в MHTML с помощью Aspose.HTML for Java. Следуйте нашему пошаговому руководству для эффективной конвертации HTML в MHTML. - ### [Конвертация HTML в XPS](./convert-html-to-xps/) -Узнайте, как без труда конвертировать HTML в XPS с помощью Aspose.HTML for Java. Создавайте кросс‑платформенные документы с лёгкостью. - ### [Конвертация Markdown в HTML](./convert-markdown-to-html/) -Бесшовно конвертируйте Markdown в HTML в Java с помощью Aspose.HTML for Java. Следуйте нашему пошаговому руководству, чтобы упростить ваши потребности в конвертации документов. - ### [Конвертация SVG в изображение](./convert-svg-to-image/) -Узнайте, как конвертировать SVG в изображения в Java с помощью Aspose.HTML. Полное руководство для получения высококачественного результата. - ### [Конвертация SVG в PDF](./convert-svg-to-pdf/) -Конвертируйте SVG в PDF в Java с помощью Aspose.HTML. Бесшовное решение для высококачественной конвертации документов. - ### [Конвертация SVG в XPS](./convert-svg-to-xps/) -Узнайте, как конвертировать SVG в XPS с помощью Aspose.HTML for Java. Простое пошаговое руководство для бесшовных конвертаций. - ### [Конвертация HTML в PDF в Java – Пошаговое руководство с настройками размера страницы](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) -Подробное пошаговое руководство по конвертации HTML в PDF в Java с настройкой размеров страниц. +### [Конвертация HTML в PDF с Java – Пошаговое руководство](./convert-html-to-pdf-with-java-step-by-step-guide/) ## Часто задаваемые вопросы diff --git a/html/russian/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/russian/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..7c7d6cbce --- /dev/null +++ b/html/russian/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,186 @@ +--- +category: general +date: 2026-03-17 +description: Преобразуйте HTML в PDF с помощью Aspose HTML for Java. Узнайте, как + установить размер страницы PDF, создать PDF из HTML и экспортировать HTML в PDF + в одном руководстве. +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: ru +og_description: Быстро преобразуйте HTML в PDF. В этом руководстве показано, как установить + размер страницы PDF, создать PDF из HTML и экспортировать HTML в PDF с помощью Aspose + HTML for Java. +og_title: Конвертировать HTML в PDF с помощью Java – Полное руководство по программированию +tags: +- Aspose +- Java +- PDF generation +title: Конвертация HTML в PDF с помощью Java — пошаговое руководство +url: /ru/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +to PDF with Java – Step‑by‑Step Guide + +Translate heading: "Convert HTML to PDF with Java – Step‑by‑Step Guide" => "Конвертация HTML в PDF с помощью Java – Пошаговое руководство" + +Then paragraph. + +We'll translate. + +Proceed. + +Make sure to keep **bold** formatting. + +Let's write translation. + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Конвертация HTML в PDF с помощью Java – Пошаговое руководство + +Когда‑то вам **нужно было конвертировать HTML в PDF**, но вы не знали, какая библиотека даст вам полный контроль над результатом? Вы не одиноки. Во многих проектах — будь то генераторы счетов, экспортеры отчетов или e‑learning платформы — возникает необходимость надежно превращать веб‑страницы в печатные PDF‑файлы. + +В этом руководстве мы пройдемся по полностью готовому решению, которое **конвертирует HTML в PDF**, позволяет **задать размер страницы PDF** и показывает, как **генерировать PDF из HTML**, сохраняя код чистым и поддерживаемым. К концу вы получите переиспользуемый фрагмент, который можно вставить в любое Java‑приложение. Никаких расплывчатых ссылок, только конкретный код и понятные объяснения. + +## Что вы узнаете + +- Как настроить **PdfSaveOptions** для определения размеров страницы и полей. +- Точный вызов, необходимый для **экспорта HTML в PDF** с использованием Aspose.HTML for Java. +- Советы по работе с соответствием PDF/A‑1b, что важно для архивирования. +- Полный, готовый к запуску пример, который можно скопировать и адаптировать. + +**Prerequisites** — вам понадобится Java 8 или новее, Maven или Gradle для получения библиотеки Aspose.HTML и простой HTML‑файл, который вы хотите превратить в PDF. Всё, без дополнительных фреймворков или веб‑серверов. + +--- + +## Шаг 1: Задать размер страницы PDF и поля + +Первое, что обычно хочется контролировать, — это размер получаемого документа. Нужно ли вам A4 по европейским стандартам или Letter для США, Aspose позволяет задать это одним объектом. + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**Почему это важно** — без явного указания размера страницы библиотека может по умолчанию использовать US Letter, что может испортить макет для международных пользователей. Значения полей также указаны в миллиметрах, что упрощает соответствие готовым к печати дизайнам. + +> **Pro tip:** Если нужен пользовательский размер, замените `PdfPageSize.A4` на `new com.aspose.html.saving.PdfPageSize(width, height)`, где width и height задаются в пунктах. + +--- + +## Шаг 2: Генерировать PDF из HTML + +Теперь, когда формат вывода определён, сама конверсия сводится к одной строке. Метод `Converter.convert` обрабатывает парсинг HTML, применение CSS и растеризацию страницы в PDF. + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**Как это работает** — под капотом Aspose читает HTML, строит DOM, разрешает внешние ресурсы (изображения, шрифты, CSS) и затем записывает каждую отрисованную страницу в поток PDF. Поскольку мы передали объект `pdfSaveOptions`, движок учитывает заданные размер страницы, поля и настройки соответствия, определённые ранее. + +> **Common question:** *Что делать, если мой HTML ссылается на изображения по относительным путям?* +> Просто убедитесь, что рабочий каталог вашего Java‑процесса совпадает с местоположением HTML‑файла, или используйте абсолютные URL. Aspose автоматически загрузит ресурсы. + +--- + +## Шаг 3: Экспорт HTML в PDF — Полный рабочий пример + +Объединив всё вместе, получаем автономный Java‑класс, который можно скомпилировать и запустить. В нём присутствуют необходимые импорты, обработка исключений и комментарии, поясняющие каждую часть. + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### Ожидаемый результат + +После запуска программы вы найдёте `output.pdf` в той же папке, которую указали. Откройте его любым PDF‑просмотрщиком — Adobe Reader, Foxit или даже браузером — и вы увидите точную визуализацию `input.html` с размером страницы A4 и полями 20 mm, которые вы задали. Если вы включили PDF/A‑1b, файл также будет содержать необходимые метаданные для долгосрочного хранения. + +--- + +## Часто задаваемые вопросы и особые случаи + +| Question | Answer | +|----------|--------| +| **Можно ли конвертировать URL вместо локального файла?** | Да. Замените первый аргумент строкой URL, например, `"https://example.com/report.html"`. | +| **Как задать другую ориентацию страницы?** | Вызовите `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` перед конвертацией. | +| **Можно ли встроить пользовательский шрифт?** | Конечно. Поместите файл шрифта в ту же директорию, что и HTML, или укажите его через `@font-face` в CSS; Aspose автоматически внедрит его. | +| **Как справиться с большими HTML‑файлами, вызывающими проблемы с памятью?** | Рассмотрите возможность потоковой передачи HTML или разбивки его на секции и конвертации каждой части отдельно, а затем объединения PDF‑файлов с помощью Aspose.PDF. | +| **Нужна ли лицензия для Aspose.HTML?** | Для тестирования достаточно бесплатной оценочной лицензии, но в продакшене потребуется платная лицензия, чтобы убрать водяной знак оценки. | + +--- + +## Иллюстрация + +Ниже показан быстрый скриншот сгенерированного PDF (заполнитель изображения). Атрибут **alt** использует основной ключевой запрос, помогая как SEO, так и доступности. + +пример конвертации html в pdf, показывающий страницу A4 с полями + +--- + +## Итоги + +Мы только что рассмотрели, как **конвертировать HTML в PDF** с помощью Aspose.HTML for Java, как **задать размер страницы PDF** и какие шаги нужны для **генерации PDF из HTML**, сохраняя процесс достаточно простым для новичков и гибким для опытных разработчиков. + +Если хотите пойти дальше, попробуйте поэкспериментировать с: + +- Разными размерами страниц (`PdfPageSize.LETTER`, пользовательские размеры). +- Добавлением водяных знаков или колонтитулов через `PdfSaveOptions`. +- Конвертацией нескольких HTML‑файлов в цикле и их объединением в один PDF. + +Эти расширения опираются на те же базовые концепции, которые мы изучили, поэтому вы легко адаптируете код под любой рабочий процесс. + +**Happy coding!** Если возникнут проблемы, оставьте комментарий ниже или обратитесь к документации Aspose для более глубокого изучения продвинутых возможностей. + +{{< /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-various-image-formats/_index.md b/html/russian/java/conversion-html-to-various-image-formats/_index.md index d92382e42..fc406ef3f 100644 --- a/html/russian/java/conversion-html-to-various-image-formats/_index.md +++ b/html/russian/java/conversion-html-to-various-image-formats/_index.md @@ -106,6 +106,8 @@ weight: 24 ### [Преобразование HTML в WebP – Полное руководство Java с Aspose.HTML](./convert-html-to-webp-complete-java-guide-with-aspose-html/) Узнайте, как преобразовать HTML в WebP в Java с помощью Aspose.HTML. Полное пошаговое руководство. +### [Сохранить HTML‑страницу как PNG в Java – Полное руководство](./save-html-page-as-png-in-java-complete-tutorial/) + ## Часто задаваемые вопросы **В: Можно ли конвертировать HTML в PNG с помощью Java без дополнительных библиотек для работы с изображениями?** diff --git a/html/russian/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/russian/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..87dc6b516 --- /dev/null +++ b/html/russian/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,238 @@ +--- +category: general +date: 2026-03-17 +description: Узнайте, как быстро сохранить HTML‑страницу в PNG. Это руководство показывает, + как отрендерить HTML в PNG и установить размер области просмотра в Java с помощью + Aspose.HTML. +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: ru +og_description: Сохраните HTML‑страницу в PNG с помощью Java. Следуйте этому руководству, + чтобы узнать, как преобразовать HTML в PNG и установить размер области просмотра + в Java с использованием Aspose.HTML. +og_title: Сохранить HTML‑страницу как PNG в Java – пошаговое руководство +tags: +- Java +- AsposeHTML +- Image Rendering +title: Сохранить HTML‑страницу в PNG в Java – Полное руководство +url: /ru/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +conclusion paragraph there is "You now have a reusable snippet that can be dropped into any Java project—whether it’s a backend service generating thumbnails or a test harness validating visual layouts." Already translated. + +Make sure to keep bold formatting (**). Keep code block placeholders unchanged. + +Now produce final answer.{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Сохранить HTML‑страницу как PNG в Java — Полный учебник + +Когда‑нибудь вам нужно было **save HTML page as PNG**, но вы не знали, с чего начать? Вы не одиноки — многие разработчики сталкиваются с этой проблемой, когда им нужен быстрый скриншот веб‑страницы для отчётов, миниатюр или тестирования. В этом руководстве мы пройдёмся по **how to render HTML to PNG** с использованием Aspose.HTML для Java, а также покажем, как **set viewport size Java**, чтобы результат выглядел точно так, как вы ожидаете. + +Мы охватим всё — от установки библиотеки до настройки коэффициента пикселей устройства, и к концу у вас будет готовая к запуску программа, создающая чёткий PNG‑файл из любого URL. Никаких неопределённых ссылок, только полное, автономное решение. + +## Что понадобится + +Перед тем как начать, убедитесь, что у вас есть: + +- Java 11 или новее (текущая LTS‑версия работает отлично) +- Maven или Gradle для управления зависимостями (мы покажем фрагмент Maven) +- Подключение к интернету для примера URL (`https://example.com`) или любой страницы, которую хотите захватить +- Записываемый каталог на диске, куда будет сохраняться PNG + +Вот и всё — никаких дополнительных SDK, никаких нативных бинарных файлов. Aspose.HTML берёт на себя всю тяжёлую работу. + +## Шаг 1: Добавьте зависимость Aspose.HTML + +Сначала подключите библиотеку Aspose.HTML к вашему проекту. Если вы используете Maven, добавьте следующее в ваш `pom.xml`: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Пользователи Gradle могут добавить это в `build.gradle`: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Pro tip:** Проверьте [Aspose.HTML release notes](https://docs.aspose.com/html/java/) на предмет самой последней версии; более новые сборки часто включают оптимизации производительности рендеринга. + +## Шаг 2: Загрузите HTML‑документ из URL + +Теперь мы создадим объект `HTMLDocument`, указывающий на страницу, которую хотите захватить. Этот шаг является ядром **how to render HTML to PNG**, поскольку библиотека парсит разметку и внутренне строит DOM. + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +Если вы предпочитаете локальный файл, просто замените строку URL на путь к файлу, например `"file:///C:/mypage.html"`. + +## Шаг 3: Настройте Sandbox и задайте размер области просмотра + +Sandbox изолирует рендеринг от основного потока вашего приложения и позволяет задать характеристики виртуального устройства. Здесь мы **set viewport size Java**, чтобы контролировать размеры отрисованного битмапа. + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +Зачем нужен sandbox? Он предотвращает побочные эффекты, такие как сетевые запросы, выходящие за пределы контекста рендеринга, и обеспечивает детерминированные результаты — особенно важно при запуске кода на CI‑сервере. + +## Шаг 4: Подготовьте параметры сохранения изображения + +Aspose.HTML может экспортировать в множество форматов (PNG, JPEG, BMP и т.д.). Мы настроим `ImageSaveOptions` так, чтобы он экспортировал первую страницу документа и указал PNG в качестве формата вывода. + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +Вы можете изменить `setPageNumber` на `2` или `-1` (все страницы), если нужна последовательность изображений из нескольких страниц. + +## Шаг 5: Отрендерите и сохраните PNG‑файл + +Наконец, вызовите `save` у `HTMLDocument`. Метод учитывает все настройки sandbox, которые мы задали ранее, и создаёт пиксельно‑идеальный скриншот. + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +Когда вы запустите программу, в консоли появится сообщение, подтверждающее место сохранения файла. Откройте PNG — вы увидите точное визуальное представление `https://example.com` размером 1280 × 800 пикселей, отрендеренное с коэффициентом пикселей устройства 2.0 (поэтому изображение выглядит чётко на Retina‑дисплеях). + +### Ожидаемый вывод + +``` +✅ PNG saved to: rendered_page.png +``` + +Полученный `rendered_page.png` будет высококачественным изображением, готовым к встраиванию в отчёты, письма или превью интерфейса. + +## Как рендерить HTML в PNG — Общие варианты + +### Рендеринг с другим размером страницы + +Если нужен другой размер, просто измените значения `Size`: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### Изменение коэффициента пикселей устройства + +DPR `1.0` даёт изображение стандартного разрешения, а `3.0` имитирует экраны с очень высокой плотностью. Настраивайте по необходимости: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Добавление пользовательских заголовков или cookie + +Иногда целевая страница требует аутентификации. Вы можете добавить заголовки перед загрузкой: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Рендеринг нескольких страниц + +Чтобы экспортировать каждую страницу в отдельный PNG, пройдитесь по количеству страниц в цикле: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Советы по устранению неполадок + +- **Blank Image:** Убедитесь, что URL доступен и sandbox имеет доступ к интернету. Если вы за прокси, задайте свойства прокси JVM (`-Dhttp.proxyHost=…`). +- **Out‑of‑Memory Errors:** Рендеринг очень больших областей просмотра может потреблять много ОЗУ. Уменьшите размер области просмотра или снизьте DPR. +- **Missing Fonts:** Aspose.HTML использует системные шрифты по умолчанию. Если ваша страница полагается на веб‑шрифты, убедитесь, что они доступны, или внедрите их через CSS `@font-face`. + +## Полный рабочий пример (весь код в одном месте) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +Скопируйте‑вставьте это в вашу IDE, измените URL или путь вывода и нажмите **Run**. Если всё настроено правильно, PNG появится за секунды. + +## Заключение + +В этом учебнике мы показали, как **save HTML page as PNG** с помощью Java, рассмотрели нюансы **how to render HTML to PNG** и продемонстрировали точные шаги **set viewport size Java** для точного контроля над результатом. Теперь у вас есть переиспользуемый фрагмент, который можно вставить в любой Java‑проект — будь то бекенд‑служба, генерирующая миниатюры, или тестовый набор, проверяющий визуальные макеты. + +### Что дальше? + +- Экспериментируйте с различными значениями `DevicePixelRatio` для ретина‑готовых ресурсов. +- Сочетайте этот подход с безголовым браузером для захвата динамических страниц, насыщенных JavaScript. +- Исследуйте другие форматы экспорта, такие как JPEG или PDF, заменив `SaveFormat.PNG` на `SaveFormat.JPEG` или `SaveFormat.PDF`. + +Не стесняйтесь менять код, делиться результатами или задавать вопросы в комментариях. Приятного рендеринга! + +![Скриншот отрендеренного HTML, сохранённого как PNG](https://example.com/placeholder.png "пример сохранения html‑страницы как png") + +{{< /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 5c04b8250..06c33a5f8 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,7 @@ 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/) +### [Convertir HTML a PDF con Java – Guía paso a paso](./convert-html-to-pdf-with-java-step-by-step-guide/) ### [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/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/spanish/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..8ea99b140 --- /dev/null +++ b/html/spanish/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,176 @@ +--- +category: general +date: 2026-03-17 +description: Convertir HTML a PDF usando Aspose HTML para Java. Aprende cómo establecer + el tamaño de página del PDF, generar PDF a partir de HTML y exportar HTML como PDF + en un solo tutorial. +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: es +og_description: Convertir HTML a PDF rápidamente. Esta guía muestra cómo establecer + el tamaño de página del PDF, generar PDF a partir de HTML y exportar HTML como PDF + usando Aspose HTML para Java. +og_title: Convertir HTML a PDF con Java – Guía completa de programación +tags: +- Aspose +- Java +- PDF generation +title: Convertir HTML a PDF con Java – Guía paso a paso +url: /es/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +Also keep blockquote > formatting. + +Translate table content. + +Let's write final.{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Convertir HTML a PDF con Java – Guía paso a paso + +¿Alguna vez necesitaste **convertir HTML a PDF** pero no estabas seguro de qué biblioteca te daría control total sobre el resultado? No estás solo. En muchos proyectos —piense en generadores de facturas, exportadores de informes o plataformas de e‑learning— te encontrarás necesitando una forma fiable de transformar páginas web en PDFs imprimibles. + +En este tutorial recorreremos una solución completa, lista para ejecutar, que **convierte HTML a PDF**, te permite **establecer el tamaño de página del PDF**, y te muestra cómo **generar PDF desde HTML** manteniendo el código limpio y mantenible. Al final tendrás un fragmento reutilizable que podrás insertar en cualquier aplicación Java. Sin referencias vagas, solo código concreto y explicaciones claras. + +## Lo que aprenderás + +- Cómo configurar **PdfSaveOptions** para definir dimensiones y márgenes de página. +- La llamada exacta que necesitas para **exportar HTML como PDF** usando Aspose.HTML for Java. +- Consejos para manejar la conformidad PDF/A‑1b, esencial para archivado. +- Un ejemplo completo y ejecutable que puedes copiar‑pegar y adaptar. + +**Requisitos previos** – necesitarás Java 8 o superior, Maven o Gradle para obtener la biblioteca Aspose.HTML, y un archivo HTML sencillo que quieras convertir a PDF. Eso es todo; no se requieren frameworks adicionales ni servidores web. + +--- + +## Paso 1: Establecer el tamaño de página y los márgenes del PDF + +Lo primero que normalmente deseas controlar es el tamaño del documento resultante. Ya sea que necesites A4 para estándares europeos o Letter para EE. UU., Aspose te permite especificarlo con un solo objeto. + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**Por qué es importante** – Sin establecer explícitamente el tamaño de página, la biblioteca podría usar por defecto US Letter, lo que podría desajustar los diseños para usuarios internacionales. Los valores de margen también están en milímetros, lo que facilita coincidir con diseños listos para imprimir. + +> **Consejo profesional:** Si necesitas un tamaño personalizado, reemplaza `PdfPageSize.A4` por `new com.aspose.html.saving.PdfPageSize(width, height)` donde width y height están en puntos. + +--- + +## Paso 2: Generar PDF desde HTML + +Ahora que el formato de salida está definido, la conversión real es una sola línea. El método `Converter.convert` se encarga de analizar el HTML, aplicar CSS y rasterizar la página en un PDF. + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**Cómo funciona** – Internamente, Aspose lee el HTML, construye un DOM, resuelve recursos externos (imágenes, fuentes, CSS) y luego escribe cada página renderizada en el flujo PDF. Como pasamos el objeto `pdfSaveOptions`, el motor respeta el tamaño de página, los márgenes y la configuración de conformidad que definimos antes. + +> **Pregunta frecuente:** *¿Qué pasa si mi HTML hace referencia a imágenes con rutas relativas?* +> Simplemente asegúrate de que el directorio de trabajo de tu proceso Java coincida con la ubicación del archivo HTML, o usa URLs absolutas. Aspose obtendrá los recursos automáticamente. + +--- + +## Paso 3: Exportar HTML como PDF – Ejemplo completo y funcional + +Uniendo las piezas, aquí tienes una clase Java autocontenida que puedes compilar y ejecutar. Incluye las importaciones necesarias, manejo de excepciones y comentarios que explican cada parte. + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### Resultado esperado + +Después de ejecutar el programa, encontrarás `output.pdf` en la misma carpeta que especificaste. Ábrelo con cualquier visor de PDF —Adobe Reader, Foxit o incluso un navegador— y deberías ver una reproducción fiel de `input.html`, con el tamaño de página A4 y márgenes de 20 mm que configuraste. Si habilitaste PDF/A‑1b, el archivo también contendrá los metadatos necesarios para la preservación a largo plazo. + +--- + +## Preguntas frecuentes y casos especiales + +| Pregunta | Respuesta | +|----------|-----------| +| **¿Puedo convertir una URL en lugar de un archivo local?** | Sí. Reemplaza el primer argumento por la cadena URL, por ejemplo, `"https://example.com/report.html"`. | +| **¿Qué pasa si necesito una orientación de página diferente?** | Usa `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` antes de la conversión. | +| **¿Es posible incrustar una fuente personalizada?** | Por supuesto. Coloca el archivo de fuente en el mismo directorio que el HTML o haz referencia a él mediante `@font-face` en tu CSS; Aspose lo incrustará automáticamente. | +| **¿Cómo manejo archivos HTML muy grandes que provocan problemas de memoria?** | Considera transmitir el HTML o dividirlo en secciones y convertir cada parte por separado, luego combinar los PDFs con Aspose.PDF. | +| **¿Necesito una licencia para Aspose.HTML?** | Una licencia de evaluación gratuita funciona para pruebas, pero para producción necesitarás una licencia de pago para eliminar la marca de agua de evaluación. | + +--- + +## Ilustración de imagen + +A continuación se muestra una captura rápida del PDF generado (imagen de marcador). El atributo **alt** utiliza la palabra clave principal, ayudando tanto al SEO como a la accesibilidad. + +convert html to pdf example showing A4 page with margins + +--- + +## Conclusión + +Acabamos de cubrir cómo **convertir HTML a PDF** usando Aspose.HTML for Java, cómo **establecer el tamaño de página del PDF**, y los pasos exactos para **generar PDF desde HTML** manteniendo el proceso lo suficientemente simple para principiantes y lo suficientemente flexible para desarrolladores experimentados. + +Si estás listo para ir más allá, prueba a experimentar con: + +- Diferentes tamaños de página (`PdfPageSize.LETTER`, dimensiones personalizadas). +- Añadir marcas de agua o encabezados/pies de página mediante `PdfSaveOptions`. +- Convertir varios archivos HTML en un bucle y combinarlos en un único PDF. + +Estas extensiones se basan en los mismos conceptos centrales que exploramos, por lo que te sentirás cómodo adaptando el código a cualquier flujo de trabajo. + +**¡Feliz codificación!** Si encuentras algún obstáculo, deja un comentario abajo o consulta la documentación de Aspose para profundizar en funciones avanzadas. + +{{< /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-various-image-formats/_index.md b/html/spanish/java/conversion-html-to-various-image-formats/_index.md index ab22c6c57..1a70bcbed 100644 --- a/html/spanish/java/conversion-html-to-various-image-formats/_index.md +++ b/html/spanish/java/conversion-html-to-various-image-formats/_index.md @@ -90,6 +90,8 @@ Aprenda cómo convertir HTML a GIF en Java usando Aspose.HTML. Una guía paso a Aprenda a convertir HTML a JPEG con Aspose.HTML for Java. Guía paso a paso para un procesamiento de documentos sin interrupciones. ### [Converting HTML to PNG](./convert-html-to-png/) Aprenda cómo convertir HTML a imágenes PNG en Java con Aspose.HTML. Una guía completa con instrucciones paso a paso. +### [Guardar página HTML como PNG en Java – Tutorial completo](./save-html-page-as-png-in-java-complete-tutorial/) +Aprenda a guardar una página HTML como PNG en Java usando Aspose.HTML. Guía paso a paso completa. ### [Converting HTML to TIFF](./convert-html-to-tiff/) Aprenda a convertir HTML a TIFF fácilmente usando Aspose.HTML for Java. Guía paso a paso para un manejo eficiente de documentos. ### [Convertir HTML a WebP – Guía completa de Java con Aspose.HTML](./convert-html-to-webp-complete-java-guide-with-aspose-html/) diff --git a/html/spanish/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/spanish/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..51469b687 --- /dev/null +++ b/html/spanish/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,233 @@ +--- +category: general +date: 2026-03-17 +description: Aprende a guardar una página HTML como PNG rápidamente. Esta guía muestra + cómo renderizar HTML a PNG y establecer el tamaño del viewport en Java usando Aspose.HTML. +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: es +og_description: Guarda una página HTML como PNG con Java. Sigue este tutorial para + aprender cómo renderizar HTML a PNG y establecer el tamaño del viewport en Java + usando Aspose.HTML. +og_title: Guardar página HTML como PNG en Java – Guía paso a paso +tags: +- Java +- AsposeHTML +- Image Rendering +title: Guardar página HTML como PNG en Java – Tutorial completo +url: /es/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Guardar página HTML como PNG en Java – Tutorial completo + +¿Alguna vez necesitaste **guardar página HTML como PNG** pero no sabías por dónde empezar? No estás solo: muchos desarrolladores se topan con este problema cuando necesitan una captura rápida de una página web para informes, miniaturas o pruebas. En esta guía recorreremos **cómo renderizar HTML a PNG** usando Aspose.HTML para Java, y también te mostraremos cómo **establecer el tamaño del viewport Java** para que el resultado se vea exactamente como esperas. + +Cubriremos todo, desde la instalación de la biblioteca hasta el ajuste de la relación de píxeles del dispositivo, y al final tendrás un programa listo para ejecutar que genera un archivo PNG nítido a partir de cualquier URL. Sin referencias vagas, solo una solución completa y autónoma. + +## Lo que necesitarás + +Antes de comenzar, asegúrate de tener: + +- Java 11 o superior (la versión LTS actual funciona perfectamente) +- Maven o Gradle para gestionar dependencias (mostraremos el fragmento para Maven) +- Una conexión a internet para la URL de ejemplo (`https://example.com`) o cualquier página que quieras capturar +- Un directorio escribible en disco donde se guardará el PNG + +Eso es todo: sin SDKs adicionales, sin binarios nativos. Aspose.HTML se encarga del trabajo pesado internamente. + +## Paso 1: Añadir la dependencia de Aspose.HTML + +Primero, incorpora la biblioteca Aspose.HTML a tu proyecto. Si usas Maven, agrega lo siguiente a tu `pom.xml`: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Los usuarios de Gradle pueden colocar esto en `build.gradle`: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Consejo profesional:** Consulta las [notas de la versión de Aspose.HTML](https://docs.aspose.com/html/java/) para obtener la versión más reciente; las compilaciones más nuevas suelen incluir mejoras de rendimiento para el renderizado. + +## Paso 2: Cargar el documento HTML desde una URL + +Ahora crearemos un objeto `HTMLDocument` que apunte a la página que deseas capturar. Este paso es el núcleo de **cómo renderizar HTML a PNG** porque la biblioteca analiza el marcado y construye un DOM internamente. + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +Si prefieres un archivo local, simplemente reemplaza la cadena URL por una ruta de archivo como `"file:///C:/mypage.html"`. + +## Paso 3: Configurar el Sandbox y establecer el tamaño del viewport + +El sandbox aísla el renderizado del hilo principal de tu aplicación y te permite definir las características del dispositivo virtual. Aquí es donde **establecemos el tamaño del viewport Java** para controlar las dimensiones del bitmap renderizado. + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +¿Por qué usar un sandbox? Evita efectos secundarios como solicitudes de red que se filtren fuera del contexto de renderizado, y te brinda resultados determinísticos, especialmente importante cuando ejecutas el código en un servidor CI. + +## Paso 4: Preparar las opciones de guardado de imagen + +Aspose.HTML puede exportar a muchos formatos (PNG, JPEG, BMP, etc.). Configuraremos `ImageSaveOptions` para apuntar a la primera página del documento y especificar PNG como formato de salida. + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +Puedes cambiar `setPageNumber` a `2` o `-1` (todas las páginas) si necesitas una secuencia de imágenes multipágina. + +## Paso 5: Renderizar y guardar el archivo PNG + +Finalmente, llama a `save` sobre el `HTMLDocument`. El método respeta todas las configuraciones del sandbox que aplicamos antes, produciendo una captura de pantalla pixel‑perfecta. + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +Al ejecutar el programa, deberías ver un mensaje en la consola confirmando la ubicación del archivo. Abre el PNG; verás la representación visual exacta de `https://example.com` a 1280 × 800 píxeles, renderizada con una relación de píxeles del dispositivo de 2.0 (para que la imagen se vea nítida en pantallas Retina). + +### Salida esperada + +``` +✅ PNG saved to: rendered_page.png +``` + +El archivo resultante `rendered_page.png` será una imagen de alta calidad, lista para incrustarse en informes, correos electrónicos o vistas previas de UI. + +## Cómo renderizar HTML a PNG – Variaciones comunes + +### Renderizar con un tamaño de página diferente + +Si necesitas una dimensión distinta, simplemente cambia los valores de `Size`: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### Cambiar la relación de píxeles del dispositivo + +Un DPR de `1.0` te da una imagen de resolución estándar, mientras que `3.0` imita pantallas de muy alta densidad. Ajusta según sea necesario: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Añadir encabezados o cookies personalizados + +A veces la página objetivo requiere autenticación. Puedes inyectar encabezados antes de cargar: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Renderizar múltiples páginas + +Para exportar cada página como un PNG separado, recorre el recuento de páginas: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Consejos de solución de problemas + +- **Imagen en blanco:** Asegúrate de que la URL sea accesible y de que el sandbox tenga acceso a internet. Si estás detrás de un proxy, establece las propiedades del proxy JVM (`-Dhttp.proxyHost=…`). +- **Errores de Out‑of‑Memory:** Renderizar viewports muy grandes puede consumir mucha RAM. Reduce el tamaño del viewport o disminuye el DPR. +- **Fuentes faltantes:** Aspose.HTML usa fuentes del sistema por defecto. Si tu página depende de fuentes web, asegúrate de que sean accesibles o incrústalas mediante `@font-face` en CSS. + +## Ejemplo completo (Todo el código en un solo lugar) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +Copia y pega esto en tu IDE, ajusta la URL o la ruta de salida, y pulsa **Run**. Si todo está configurado correctamente, tendrás un PNG en segundos. + +## Conclusión + +En este tutorial te mostramos **cómo guardar página HTML como PNG** usando Java, cubrimos los matices de **cómo renderizar HTML a PNG**, y demostramos los pasos exactos para **establecer el tamaño del viewport Java** y controlar con precisión la salida. Ahora dispones de un fragmento reutilizable que puedes insertar en cualquier proyecto Java, ya sea un servicio backend que genere miniaturas o un harness de pruebas que valide diseños visuales. + +### ¿Qué sigue? + +- Experimenta con diferentes valores de `DevicePixelRatio` para crear activos listos para retina. +- Combina este enfoque con un navegador sin cabeza para capturar páginas dinámicas y con mucho JavaScript. +- Explora otros formatos de exportación como JPEG o PDF cambiando `SaveFormat.PNG` por `SaveFormat.JPEG` o `SaveFormat.PDF`. + +Siéntete libre de modificar el código, compartir tus resultados o hacer preguntas en los comentarios. ¡Feliz renderizado! + +![Captura de pantalla del HTML renderizado guardado como PNG](https://example.com/placeholder.png "ejemplo de guardar página html como png") + +{{< /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 91c83a46f..f2d7c32e0 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. +### [Konvertera HTML till PDF med Java – Steg‑för‑steg‑guide](./convert-html-to-pdf-with-java-step-by-step-guide/) +Lär dig konvertera HTML till PDF i Java med en detaljerad steg‑för‑steg‑guide. ## Vanliga frågor diff --git a/html/swedish/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/swedish/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..420e08ed9 --- /dev/null +++ b/html/swedish/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,172 @@ +--- +category: general +date: 2026-03-17 +description: Konvertera HTML till PDF med Aspose HTML för Java. Lär dig hur du ställer + in PDF‑sidstorlek, genererar PDF från HTML och exporterar HTML som PDF i en enda + handledning. +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: sv +og_description: Konvertera HTML till PDF snabbt. Denna guide visar hur du ställer + in PDF‑sidstorlek, genererar PDF från HTML och exporterar HTML som PDF med Aspose + HTML för Java. +og_title: Konvertera HTML till PDF med Java – Komplett programmeringsguide +tags: +- Aspose +- Java +- PDF generation +title: Konvertera HTML till PDF med Java – Steg‑för‑steg guide +url: /sv/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Konvertera HTML till PDF med Java – Steg‑för‑steg guide + +Har du någonsin behövt **konvertera HTML till PDF** men varit osäker på vilket bibliotek som ger dig full kontroll över resultatet? Du är inte ensam. I många projekt—tänk fakturageneratorer, rapportexportörer eller e‑learning‑plattformar—kommer du att behöva ett pålitligt sätt att omvandla webbsidor till utskrivbara PDF‑filer. + +I den här handledningen går vi igenom en komplett, färdig‑att‑köra lösning som **konverterar HTML till PDF**, låter dig **ange PDF‑sidstorlek** och visar hur du **genererar PDF från HTML** samtidigt som koden hålls ren och underhållbar. I slutet har du ett återanvändbart kodsnutt som du kan klistra in i vilken Java‑applikation som helst. Inga vaga referenser, bara konkret kod och tydliga förklaringar. + +## Vad du kommer att lära dig + +- Hur du konfigurerar **PdfSaveOptions** för att definiera sidmått och marginaler. +- Det exakta anropet du behöver för att **exportera HTML som PDF** med Aspose.HTML för Java. +- Tips för att hantera PDF/A‑1b‑kompatibilitet, vilket är viktigt för arkivering. +- Ett komplett, körbart exempel som du kan kopiera‑klistra och anpassa. + +**Förutsättningar** – du behöver Java 8 eller nyare, Maven eller Gradle för att hämta Aspose.HTML‑biblioteket, och en enkel HTML‑fil som du vill omvandla till en PDF. Det är allt; inga extra ramverk eller webbservrar krävs. + +--- + +## Steg 1: Ange PDF‑sidstorlek och marginaler + +Det första du vanligtvis vill kontrollera är storleken på det resulterande dokumentet. Oavsett om du behöver A4 för europeiska standarder eller Letter för USA, låter Aspose dig specificera det med ett enda objekt. + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**Varför detta är viktigt** – Utan att explicit ange sidstorleken kan biblioteket defaulta till US Letter, vilket kan förstöra layouten för internationella användare. Marginalvärdena är också i millimeter, vilket gör det enkelt att matcha utskriftsklara designer. + +> **Pro tip:** Om du behöver en anpassad storlek, ersätt `PdfPageSize.A4` med `new com.aspose.html.saving.PdfPageSize(width, height)` där bredd och höjd är i points. + +--- + +## Steg 2: Generera PDF från HTML + +Nu när utdataformatet är definierat är själva konverteringen en endaste rad. Metoden `Converter.convert` hanterar parsning av HTML, tillämpning av CSS och rasterisering av sidan till en PDF. + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**Hur det fungerar** – Under huven läser Aspose HTML‑koden, bygger ett DOM‑träd, löser externa resurser (bilder, teckensnitt, CSS) och skriver sedan varje renderad sida till PDF‑strömmen. Eftersom vi skickade med `pdfSaveOptions`‑objektet respekterar motorn sidstorlek, marginaler och efterlevnadsinställningar som vi definierade tidigare. + +> **Vanlig fråga:** *Vad händer om min HTML refererar till bilder med relativa sökvägar?* +> Se bara till att arbetskatalogen för din Java‑process matchar platsen för HTML‑filen, eller använd absoluta URL‑er. Aspose hämtar resurserna automatiskt. + +--- + +## Steg 3: Exportera HTML som PDF – Fullt fungerande exempel + +När vi sätter ihop bitarna, här är en självständig Java‑klass som du kan kompilera och köra. Den innehåller nödvändiga imports, felhantering och kommentarer som förklarar varje del. + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### Förväntat resultat + +Efter att programmet har körts hittar du `output.pdf` i samma mapp som du pekade på. Öppna den med någon PDF‑visare—Adobe Reader, Foxit eller till och med en webbläsare—så bör du se en trogen återgivning av `input.html`, komplett med A4‑sidstorlek och 20 mm marginaler som du angav. Om du aktiverade PDF/A‑1b innehåller filen även den nödvändiga metadata för långsiktig bevarande. + +--- + +## Vanliga frågor & kantfall + +| Fråga | Svar | +|----------|--------| +| **Kan jag konvertera en URL istället för en lokal fil?** | Ja. Ersätt det första argumentet med URL‑strängen, t.ex. `"https://example.com/report.html"`. | +| **Vad om jag behöver en annan sidorientering?** | Använd `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` före konverteringen. | +| **Är det möjligt att bädda in ett eget teckensnitt?** | Absolut. Placera teckensnittsfilen i samma katalog som HTML‑filen eller referera till den via `@font-face` i din CSS; Aspose bäddar in den automatiskt. | +| **Hur hanterar jag stora HTML‑filer som orsakar minnesproblem?** | Överväg att strömma HTML‑innehållet eller dela upp det i sektioner och konvertera varje del separat, för att sedan slå ihop PDF‑erna med Aspose.PDF. | +| **Behöver jag en licens för Aspose.HTML?** | En gratis utvärderingslicens fungerar för testning, men för produktion behöver du en betald licens för att ta bort vattenstämpeln. | + +--- + +## Bildillustration + +Nedan är en snabb skärmbild av den genererade PDF‑en (platshållarbild). **alt**‑attributet använder huvudnyckelordet, vilket hjälper både SEO och tillgänglighet. + +konvertera html till pdf exempel som visar A4‑sida med marginaler + +--- + +## Sammanfattning + +Vi har precis gått igenom hur du **konverterar HTML till PDF** med Aspose.HTML för Java, hur du **anger PDF‑sidstorlek**, och de exakta stegen för att **generera PDF från HTML** samtidigt som processen hålls enkel nog för nybörjare och flexibel nog för erfarna utvecklare. + +Om du är redo att gå vidare, prova att experimentera med: + +- Olika sidstorlekar (`PdfPageSize.LETTER`, egna dimensioner). +- Lägga till vattenstämplar eller sidhuvuden/sidfötter via `PdfSaveOptions`. +- Konvertera flera HTML‑filer i en loop och slå ihop dem till en enda PDF. + +Dessa utökningar bygger på samma kärnkoncept som vi har utforskat, så du kommer att känna dig bekväm med att anpassa koden till vilket arbetsflöde som helst. + +**Lycka till med kodningen!** Om du stöter på problem, lämna en kommentar nedan eller kolla Aspose‑dokumentationen för djupare insikter i avancerade funktioner. + +{{< /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-various-image-formats/_index.md b/html/swedish/java/conversion-html-to-various-image-formats/_index.md index 2b7cf68d4..c39b9dcc6 100644 --- a/html/swedish/java/conversion-html-to-various-image-formats/_index.md +++ b/html/swedish/java/conversion-html-to-various-image-formats/_index.md @@ -93,6 +93,7 @@ Att använda Aspose.HTML for Java förenklar konverteringen av HTML‑dokument t ### [Konvertera HTML till PNG](./convert-html-to-png/) ### [Konvertera HTML till TIFF](./convert-html-to-tiff/) ### [Konvertera HTML till WebP – Komplett Java‑guide med Aspose.HTML](./convert-html-to-webp-complete-java-guide-with-aspose-html/) +### [Spara HTML-sida som PNG i Java – Komplett handledning](./save-html-page-as-png-in-java-complete-tutorial/) ## Vanliga frågor diff --git a/html/swedish/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/swedish/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..a73534ca4 --- /dev/null +++ b/html/swedish/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,231 @@ +--- +category: general +date: 2026-03-17 +description: Lär dig hur du snabbt sparar en HTML‑sida som PNG. Den här guiden visar + hur du renderar HTML till PNG och ställer in viewport‑storlek i Java med Aspose.HTML. +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: sv +og_description: Spara HTML-sida som PNG med Java. Följ den här handledningen för att + lära dig hur du renderar HTML till PNG och ställer in viewport‑storlek i Java med + Aspose.HTML. +og_title: Spara HTML-sida som PNG i Java – Steg‑för‑steg guide +tags: +- Java +- AsposeHTML +- Image Rendering +title: Spara HTML-sida som PNG i Java – Komplett handledning +url: /sv/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Spara HTML-sida som PNG i Java – Komplett handledning + +Har du någonsin behövt **save HTML page as PNG** men var osäker på var du skulle börja? Du är inte ensam—många utvecklare stöter på detta problem när de behöver en snabb skärmdump av en webbsida för rapporter, miniatyrbilder eller testning. I den här guiden går vi igenom **how to render HTML to PNG** med Aspose.HTML för Java, och vi visar också hur du **set viewport size Java** så att resultatet ser exakt ut som du förväntar dig. + +Vi kommer att täcka allt från att installera biblioteket till att justera enhetens pixelförhållande, och i slutet har du ett färdigt program som producerar en skarp PNG‑fil från vilken URL som helst. Inga vaga referenser, bara en komplett, självständig lösning. + +## Vad du behöver + +- Java 11 eller nyare (den nuvarande LTS‑versionen fungerar perfekt) +- Maven eller Gradle för att hantera beroenden (vi visar Maven‑exemplet) +- En internetanslutning för exempel‑URL:en (`https://example.com`) eller vilken sida du vill fånga +- En skrivbar katalog på disken där PNG‑filen ska sparas + +Det är allt—inga extra SDK:er, inga inhemska binärer. Aspose.HTML sköter det tunga arbetet internt. + +## Steg 1: Lägg till Aspose.HTML‑beroende + +Först, hämta Aspose.HTML‑biblioteket till ditt projekt. Om du använder Maven, lägg till följande i din `pom.xml`: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Gradle‑användare kan lägga till detta i `build.gradle`: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Pro tip:** Kolla [Aspose.HTML release notes](https://docs.aspose.com/html/java/) för den senaste versionen; nyare builds innehåller ofta prestandaförbättringar för rendering. + +## Steg 2: Ladda HTML‑dokumentet från en URL + +Nu skapar vi ett `HTMLDocument`‑objekt som pekar på sidan du vill fånga. Detta steg är kärnan i **how to render HTML to PNG** eftersom biblioteket parsar markupen och bygger ett DOM internt. + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +Om du föredrar en lokal fil, ersätt bara URL‑strängen med en filsökväg som `"file:///C:/mypage.html"`. + +## Steg 3: Konfigurera sandboxen och ange viewport‑storlek + +Sandboxen isolerar rendering från din huvudapplikations‑tråd och låter dig definiera de virtuella enhets‑egenskaperna. Här **set viewport size Java** för att kontrollera dimensionerna på den renderade bitmapen. + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +Varför bry sig om en sandbox? Den förhindrar bieffekter som nätverksförfrågningar som läcker utanför renderingskontexten, och den ger deterministiska resultat—särskilt viktigt när du kör koden på en CI‑server. + +## Steg 4: Förbered bild‑spara‑alternativ + +Aspose.HTML kan exportera till många format (PNG, JPEG, BMP, osv.). Vi konfigurerar `ImageSaveOptions` för att rikta in sig på den första sidan i dokumentet och ange PNG som utdataformat. + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +Du kan ändra `setPageNumber` till `2` eller `-1` (alla sidor) om du behöver en flersidig bildsekvens. + +## Steg 5: Rendera och spara PNG‑filen + +Slutligen, anropa `save` på `HTMLDocument`. Metoden respekterar alla sandbox‑inställningar vi applicerade tidigare, och producerar en pixel‑perfekt skärmdump. + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +När du kör programmet bör du se ett konsolmeddelande som bekräftar filens plats. Öppna PNG‑filen—du ser den exakta visuella representationen av `https://example.com` i 1280 × 800 pixlar, renderad med ett enhetspixelförhållande på 2.0 (så bilden ser skarp ut på Retina‑skärmar). + +### Förväntad utdata + +``` +✅ PNG saved to: rendered_page.png +``` + +Den resulterande `rendered_page.png` blir en högkvalitativ bildfil, redo att bäddas in i rapporter, e‑post eller UI‑förhandsvisningar. + +## Så renderar du HTML till PNG – Vanliga variationer + +### Rendera en annan sidstorlek + +Om du behöver en annan dimension, ändra helt enkelt `Size`‑värdena: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### Ändra enhetens pixelförhållande + +En DPR på `1.0` ger en standardupplöst bild, medan `3.0` efterliknar mycket högdensitetsskärmar. Justera efter behov: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Lägg till anpassade headers eller cookies + +Ibland kräver målsidan autentisering. Du kan injicera headers innan laddning: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Rendera flera sidor + +För att exportera varje sida som en separat PNG, loopa över sidantalet: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Felsökningstips + +- **Blank Image:** Se till att URL:en är nåbar och sandboxen har internetåtkomst. Om du är bakom en proxy, sätt JVM‑proxy‑egenskaperna (`-Dhttp.proxyHost=…`). +- **Out‑of‑Memory Errors:** Rendering av mycket stora viewports kan förbruka mycket RAM. Minska viewport‑storleken eller sänk DPR. +- **Missing Fonts:** Aspose.HTML använder systemfonter som standard. Om din sida förlitar sig på webbfonter, se till att de är åtkomliga eller bädda in dem via CSS `@font-face`. + +## Fullt fungerande exempel (All kod på ett ställe) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +Kopiera‑klistra in detta i din IDE, justera URL:en eller utsökvägen, och tryck på **Run**. Om allt är korrekt konfigurerat får du en PNG på några sekunder. + +## Slutsats + +I den här handledningen visade vi dig **how to save HTML page as PNG** med Java, gick igenom nyanserna av **how to render HTML to PNG**, och demonstrerade de exakta stegen för att **set viewport size Java** för exakt kontroll över resultatet. Du har nu ett återanvändbart kodsnutt som kan infogas i vilket Java‑projekt som helst—oavsett om det är en backend‑tjänst som genererar miniatyrbilder eller ett test‑härverktyg som validerar visuella layouter. + +### Vad blir nästa? + +- Experimentera med olika `DevicePixelRatio`‑värden för retina‑klara tillgångar. +- Kombinera detta tillvägagångssätt med en huvudlös webbläsare för att fånga dynamiska, JavaScript‑tunga sidor. +- Utforska andra exportformat som JPEG eller PDF genom att byta `SaveFormat.PNG` mot `SaveFormat.JPEG` eller `SaveFormat.PDF`. + +Känn dig fri att justera koden, dela dina resultat, eller ställa frågor i kommentarerna. Lycka till med rendering! + +![Screenshot of rendered HTML saved as PNG](https://example.com/placeholder.png "save html page as png example") + +{{< /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 aa3e49be5..349f487cc 100644 --- a/html/thai/java/conversion-html-to-other-formats/_index.md +++ b/html/thai/java/conversion-html-to-other-formats/_index.md @@ -95,6 +95,8 @@ Aspose.HTML for Java ทำให้กระบวนการแปลง HTML เรียนรู้วิธีแปลง HTML เป็น PDF ใน Java ด้วย Aspose.HTML สร้าง PDF คุณภาพสูงจากเนื้อหา HTML ของคุณได้อย่างง่ายดาย ### [Convert HTML to PDF in Java – Step‑by‑Step Guide with Page Size Settings](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) เรียนรู้ขั้นตอนการแปลง HTML เป็น PDF ใน Java พร้อมการตั้งค่าขนาดหน้าอย่างละเอียด +### [แปลง HTML เป็น PDF ด้วย Java – คู่มือขั้นตอน‑ต่อ‑ขั้นตอน](./convert-html-to-pdf-with-java-step-by-step-guide/) +เรียนรู้วิธีแปลง HTML เป็น PDF ใน Java อย่างละเอียดด้วยขั้นตอนที่ชัดเจนและตัวอย่างโค้ด ### [Converting HTML to MHTML](./convert-html-to-mhtml/) แปลง HTML เป็น MHTML อย่างไม่มีความยุ่งยากด้วย Aspose.HTML for Java ทำตามคู่มือขั้นตอน‑ต่อ‑ขั้นตอนสำหรับการแปลง HTML‑to‑MHTML ที่มีประสิทธิภาพ ### [Converting HTML to XPS](./convert-html-to-xps/) diff --git a/html/thai/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/thai/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..1b90ad56a --- /dev/null +++ b/html/thai/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,170 @@ +--- +category: general +date: 2026-03-17 +description: แปลง HTML เป็น PDF ด้วย Aspose HTML for Java. เรียนรู้วิธีตั้งขนาดหน้ากระดาษ + PDF, สร้าง PDF จาก HTML และส่งออก HTML เป็น PDF ในบทเรียนเดียว. +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: th +og_description: แปลง HTML เป็น PDF อย่างรวดเร็ว คู่มือนี้แสดงวิธีตั้งค่าขนาดหน้ากระดาษ + PDF, สร้าง PDF จาก HTML, และส่งออก HTML เป็น PDF ด้วย Aspose HTML for Java. +og_title: แปลง HTML เป็น PDF ด้วย Java – คู่มือการเขียนโปรแกรมเต็มรูปแบบ +tags: +- Aspose +- Java +- PDF generation +title: แปลง HTML เป็น PDF ด้วย Java – คู่มือขั้นตอนโดยละเอียด +url: /th/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# แปลง HTML เป็น PDF ด้วย Java – คู่มือขั้นตอนโดยละเอียด + +เคยต้อง **แปลง HTML เป็น PDF** แต่ไม่แน่ใจว่าห้องสมุดใดจะให้คุณควบคุมผลลัพธ์ได้เต็มที่หรือไม่? คุณไม่ได้เป็นคนเดียว ในหลายโครงการ—เช่น ตัวสร้างใบแจ้งหนี้, ตัวส่งออกรายงาน, หรือแพลตฟอร์ม e‑learning—คุณจะพบว่าต้องการวิธีที่เชื่อถือได้ในการเปลี่ยนหน้าเว็บให้เป็น PDF ที่พิมพ์ได้ + +ในบทเรียนนี้เราจะพาคุณผ่านโซลูชันที่สมบูรณ์พร้อมรันได้ทันทีที่ **แปลง HTML เป็น PDF**, ให้คุณ **ตั้งค่าขนาดหน้าของ PDF**, และแสดงวิธี **สร้าง PDF จาก HTML** พร้อมรักษาโค้ดให้สะอาดและดูแลได้ง่าย เมื่อจบคุณจะได้สแนปช็อตที่นำกลับไปใช้ได้ในแอปพลิเคชัน Java ใดก็ได้ ไม่มีการอ้างอิงที่คลุมเครือ มีเพียงโค้ดที่ชัดเจนและคำอธิบายที่เข้าใจง่าย + +## สิ่งที่คุณจะได้เรียนรู้ + +- วิธีกำหนดค่า **PdfSaveOptions** เพื่อระบุขนาดหน้าและขอบกระดาษ +- คำสั่งที่ต้องใช้เพื่อ **ส่งออก HTML เป็น PDF** ด้วย Aspose.HTML for Java +- เคล็ดลับการจัดการกับการปฏิบัติตามมาตรฐาน PDF/A‑1b ซึ่งสำคัญสำหรับการเก็บรักษาเอกสาร +- ตัวอย่างเต็มที่สามารถรันได้ซึ่งคุณสามารถคัดลอกและปรับใช้ได้ + +**Prerequisites** – คุณต้องมี Java 8 หรือใหม่กว่า, Maven หรือ Gradle เพื่อดึงไลบรารี Aspose.HTML, และไฟล์ HTML ง่าย ๆ ที่ต้องการแปลงเป็น PDF เพียงเท่านั้น ไม่ต้องมีเฟรมเวิร์กหรือเว็บเซิร์ฟเวอร์เพิ่มเติม + +--- + +## ขั้นตอนที่ 1: ตั้งค่าขนาดหน้า PDF และขอบกระดาษ + +สิ่งแรกที่คุณมักต้องการควบคุมคือขนาดของเอกสารที่ได้ ไม่ว่าคุณจะต้องการ A4 ตามมาตรฐานยุโรปหรือ Letter สำหรับสหรัฐฯ Aspose ให้คุณระบุได้ด้วยอ็อบเจกต์เดียว + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**ทำไมเรื่องนี้ถึงสำคัญ** – หากไม่ได้ตั้งค่าขนาดหน้าอย่างชัดเจน ไลบรารีอาจใช้ค่าเริ่มต้นเป็น US Letter ซึ่งอาจทำให้เลย์เอาต์เสียหายสำหรับผู้ใช้ต่างประเทศ ค่า margin ยังใช้หน่วยมิลลิเมตร ทำให้จับคู่กับการออกแบบที่พร้อมพิมพ์ได้ง่าย + +> **Pro tip:** หากต้องการขนาดกำหนดเอง ให้แทนที่ `PdfPageSize.A4` ด้วย `new com.aspose.html.saving.PdfPageSize(width, height)` โดยที่ width และ height มีหน่วยเป็น points + +--- + +## ขั้นตอนที่ 2: สร้าง PDF จาก HTML + +เมื่อรูปแบบผลลัพธ์ถูกกำหนดแล้ว การแปลงจริงเป็นบรรทัดเดียว `Converter.convert` จะจัดการการพาร์ส HTML, การใช้ CSS, และการเรสเตอร์หน้าเป็น PDF + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**วิธีการทำงาน** – ภายใต้พื้นฐาน Aspose จะอ่าน HTML, สร้าง DOM, แก้ไขทรัพยากรภายนอก (รูปภาพ, ฟอนต์, CSS) แล้วเขียนแต่ละหน้าที่เรนเดอร์ลงสตรีม PDF เนื่องจากเราได้ส่งอ็อบเจกต์ `pdfSaveOptions` ไปแล้ว เอนจินจะเคารพขนาดหน้า, margin, และการตั้งค่าการปฏิบัติตามที่กำหนดไว้ก่อนหน้า + +> **Common question:** *ถ้า HTML ของฉันอ้างอิงรูปภาพด้วยพาธสัมพันธ์ล่ะ?* +> เพียงตรวจสอบให้ไดเรกทอรีทำงานของกระบวนการ Java ตรงกับตำแหน่งไฟล์ HTML, หรือใช้ URL แบบเต็ม Aspose จะดึงทรัพยากรเหล่านั้นโดยอัตโนมัติ + +--- + +## ขั้นตอนที่ 3: ส่งออก HTML เป็น PDF – ตัวอย่างทำงานเต็มรูปแบบ + +รวมส่วนต่าง ๆ เข้าด้วยกัน นี่คือคลาส Java ที่เป็นอิสระคุณสามารถคอมไพล์และรันได้ รวมการนำเข้า, การจัดการข้อยกเว้น, และคอมเมนต์อธิบายแต่ละส่วน + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### ผลลัพธ์ที่คาดหวัง + +หลังจากรันโปรแกรม คุณจะพบ `output.pdf` ในโฟลเดอร์เดียวกับที่ระบุ เปิดด้วยโปรแกรมดู PDF ใดก็ได้—Adobe Reader, Foxit หรือแม้แต่เบราว์เซอร์—คุณจะเห็นการเรนเดอร์ของ `input.html` อย่างแม่นยำ พร้อมขนาดหน้า A4 และ margin 20 mm ที่ตั้งค่าไว้ หากเปิดใช้งาน PDF/A‑1b ไฟล์จะมีเมตาดาต้าที่จำเป็นสำหรับการเก็บรักษาระยะยาว + +--- + +## คำถามที่พบบ่อยและกรณีขอบ + +| Question | Answer | +|----------|--------| +| **Can I convert a URL instead of a local file?** | Yes. Replace the first argument with the URL string, e.g., `"https://example.com/report.html"`. | +| **What if I need a different page orientation?** | Use `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` before conversion. | +| **Is it possible to embed a custom font?** | Absolutely. Place the font file in the same directory as the HTML or reference it via `@font-face` in your CSS; Aspose will embed it automatically. | +| **How do I handle large HTML files that cause memory issues?** | Consider streaming the HTML or splitting it into sections and converting each part separately, then merging the PDFs with Aspose.PDF. | +| **Do I need a license for Aspose.HTML?** | A free evaluation license works for testing, but for production you’ll need a paid license to remove the evaluation watermark. | + +--- + +## ภาพประกอบ + +ด้านล่างเป็นภาพหน้าจอสั้น ๆ ของ PDF ที่สร้างขึ้น (ภาพตัวอย่าง) แอตทริบิวต์ **alt** ใช้คีย์เวิร์ดหลัก ช่วย SEO และการเข้าถึง + +ตัวอย่างการแปลง html เป็น pdf แสดงหน้าขนาด A4 พร้อมขอบกระดาษ + +--- + +## สรุป + +เราได้ครอบคลุมวิธี **แปลง HTML เป็น PDF** ด้วย Aspose.HTML for Java, วิธี **ตั้งค่าขนาดหน้าของ PDF**, และขั้นตอนที่แม่นยำเพื่อ **สร้าง PDF จาก HTML** โดยทำให้กระบวนการง่ายพอสำหรับผู้เริ่มต้นและยืดหยุ่นพอสำหรับนักพัฒนาที่มีประสบการณ์ + +ถ้าคุณพร้อมจะก้าวต่อไป ลองทดลองกับ: + +- ขนาดหน้าต่าง ๆ (`PdfPageSize.LETTER`, ขนาดกำหนดเอง) +- การเพิ่มลายน้ำหรือหัว/ท้ายหน้า ผ่าน `PdfSaveOptions` +- การแปลงหลายไฟล์ HTML ในลูปและรวมเป็น PDF ไฟล์เดียว + +ส่วนขยายเหล่านี้ต่อยอดจากแนวคิดหลักที่เราได้สำรวจไว้แล้ว ทำให้คุณรู้สึกสบายใจในการปรับโค้ดให้เข้ากับเวิร์กโฟลว์ใด ๆ + +**Happy coding!** หากเจออุปสรรคใด ๆ ฝากคอมเมนต์ด้านล่างหรือดูเอกสาร Aspose เพื่อเจาะลึกฟีเจอร์ขั้นสูง + +{{< /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-various-image-formats/_index.md b/html/thai/java/conversion-html-to-various-image-formats/_index.md index 755481956..d930c6be5 100644 --- a/html/thai/java/conversion-html-to-various-image-formats/_index.md +++ b/html/thai/java/conversion-html-to-various-image-formats/_index.md @@ -95,6 +95,8 @@ weight: 24 เรียนรู้วิธีการแปลง HTML เป็น JPEG ด้วย Aspose.HTML สำหรับ Java คู่มือทีละขั้นตอนสำหรับการประมวลผลเอกสารอย่างราบรื่น ### [การแปลง HTML เป็น PNG](./convert-html-to-png/) เรียนรู้วิธีการแปลง HTML เป็นภาพ PNG ใน Java ด้วย Aspose.HTML คู่มือฉบับสมบูรณ์พร้อมคำแนะนำทีละขั้นตอน +### [บันทึกหน้า HTML เป็น PNG ใน Java – คู่มือฉบับสมบูรณ์](./save-html-page-as-png-in-java-complete-tutorial/) +เรียนรู้วิธีบันทึกหน้า HTML เป็นไฟล์ PNG ใน Java ด้วย Aspose.HTML อย่างละเอียดและครบถ้วน ### [การแปลง HTML เป็น TIFF](./convert-html-to-tiff/) เรียนรู้วิธีการแปลง HTML เป็น TIFF ได้อย่างง่ายดายโดยใช้ Aspose.HTML สำหรับ Java คู่มือทีละขั้นตอนเพื่อการจัดการเอกสารอย่างมีประสิทธิภาพ ### [แปลง HTML เป็น WebP – คู่มือ Java ฉบับสมบูรณ์ด้วย Aspose.HTML](./convert-html-to-webp-complete-java-guide-with-aspose-html/) diff --git a/html/thai/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/thai/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..e905fb506 --- /dev/null +++ b/html/thai/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,234 @@ +--- +category: general +date: 2026-03-17 +description: เรียนรู้วิธีบันทึกหน้า HTML เป็น PNG อย่างรวดเร็ว คู่มือนี้แสดงวิธีเรนเดอร์ + HTML เป็น PNG และตั้งค่าขนาด viewport ใน Java ด้วย Aspose.HTML +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: th +og_description: บันทึกหน้า HTML เป็น PNG ด้วย Java. ทำตามบทเรียนนี้เพื่อเรียนรู้วิธีแปลง + HTML เป็น PNG และตั้งขนาด viewport ใน Java ด้วย Aspose.HTML. +og_title: บันทึกหน้า HTML เป็น PNG ใน Java – คู่มือขั้นตอนโดยละเอียด +tags: +- Java +- AsposeHTML +- Image Rendering +title: บันทึกหน้า HTML เป็น PNG ใน Java – คู่มือเต็ม +url: /th/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +Let's craft translation. + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# บันทึกหน้า HTML เป็น PNG ใน Java – คู่มือฉบับสมบูรณ์ + +เคยต้องการ **save HTML page as PNG** แต่ไม่แน่ใจว่าจะเริ่มจากตรงไหนหรือไม่? คุณไม่ได้อยู่คนเดียว—นักพัฒนาหลายคนเจออุปสรรคนี้เมื่อต้องการภาพหน้าจอของเว็บเพจอย่างรวดเร็วสำหรับรายงาน, รูปย่อ, หรือการทดสอบ ในคู่มือนี้เราจะอธิบาย **how to render HTML to PNG** ด้วย Aspose.HTML สำหรับ Java และเราจะสาธิตวิธี **set viewport size Java** เพื่อให้ผลลัพธ์ออกมาตรงตามที่คุณคาดหวัง + +เราจะครอบคลุมทุกอย่างตั้งแต่การติดตั้งไลบรารีจนถึงการปรับค่า device pixel ratio และเมื่อคุณทำตามจนจบแล้ว คุณจะได้โปรแกรมที่พร้อมรันซึ่งสร้างไฟล์ PNG คมชัดจาก URL ใดก็ได้ ไม่มีการอ้างอิงที่คลุมเครือ เพียงโซลูชันครบถ้วนในตัวเดียว + +## สิ่งที่คุณต้องมี + +ก่อนที่เราจะลงลึก โปรดตรวจสอบว่าคุณมี: + +- Java 11 หรือใหม่กว่า (เวอร์ชัน LTS ปัจจุบันทำงานได้อย่างสมบูรณ์) +- Maven หรือ Gradle เพื่อจัดการ dependencies (เราจะแสดงตัวอย่าง Maven) +- การเชื่อมต่ออินเทอร์เน็ตสำหรับ URL ตัวอย่าง (`https://example.com`) หรือหน้าใดก็ได้ที่คุณต้องการจับภาพ +- ไดเรกทอรีที่สามารถเขียนได้บนดิสก์เพื่อบันทึกไฟล์ PNG + +เท่านี้—ไม่มี SDK เพิ่มเติม, ไม่มีไบนารีเนทีฟ Aspose.HTML จะจัดการงานหนักทั้งหมดภายใน + +## ขั้นตอนที่ 1: เพิ่ม Dependency ของ Aspose.HTML + +ก่อนอื่นให้ดึงไลบรารี Aspose.HTML เข้ามาในโปรเจกต์ของคุณ หากคุณใช้ Maven ให้เพิ่มโค้ดต่อไปนี้ในไฟล์ `pom.xml` ของคุณ: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +ผู้ใช้ Gradle สามารถวางโค้ดนี้ลงใน `build.gradle`: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Pro tip:** ตรวจสอบ [Aspose.HTML release notes](https://docs.aspose.com/html/java/) เพื่อดูเวอร์ชันล่าสุด; การสร้างใหม่มักรวมการปรับปรุงประสิทธิภาพสำหรับการเรนเดอร์ + +## ขั้นตอนที่ 2: โหลด HTML Document จาก URL + +ต่อไปเราจะสร้างอ็อบเจ็กต์ `HTMLDocument` ที่ชี้ไปยังหน้าเว็บที่คุณต้องการจับภาพ ขั้นตอนนี้เป็นหัวใจของ **how to render HTML to PNG** เนื่องจากไลบรารีจะทำการพาร์ส markup และสร้าง DOM ภายใน + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +หากคุณต้องการใช้ไฟล์ในเครื่อง ให้แทนที่สตริง URL ด้วยพาธไฟล์เช่น `"file:///C:/mypage.html"` แทน + +## ขั้นตอนที่ 3: กำหนดค่า Sandbox และตั้งค่า Viewport Size + +Sandbox จะทำให้การเรนเดอร์แยกออกจากเธรดหลักของแอปพลิเคชันและให้คุณกำหนดคุณลักษณะของอุปกรณ์เสมือน นี่คือจุดที่เราจะ **set viewport size Java** เพื่อควบคุมขนาดของบิตแมปที่เรนเดอร์ + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +ทำไมต้องใช้ sandbox? มันช่วยป้องกันผลข้างเคียงเช่นคำขอเครือข่ายที่รั่วไหลออกจากบริบทการเรนเดอร์ และให้ผลลัพธ์ที่กำหนดได้อย่างแน่นอน—สำคัญมากเมื่อคุณรันโค้ดบนเซิร์ฟเวอร์ CI + +## ขั้นตอนที่ 4: เตรียม Image Save Options + +Aspose.HTML สามารถส่งออกเป็นหลายรูปแบบ (PNG, JPEG, BMP, ฯลฯ) เราจะกำหนดค่า `ImageSaveOptions` ให้มุ่งเป้าไปที่หน้าแรกของเอกสารและระบุ PNG เป็นรูปแบบผลลัพธ์ + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +คุณสามารถเปลี่ยน `setPageNumber` เป็น `2` หรือ `-1` (ทั้งหมด) หากต้องการลำดับภาพหลายหน้า + +## ขั้นตอนที่ 5: เรนเดอร์และบันทึกไฟล์ PNG + +สุดท้ายให้เรียก `save` บน `HTMLDocument` วิธีนี้จะเคารพการตั้งค่า sandbox ทั้งหมดที่เราได้กำหนดไว้ก่อนหน้า ทำให้ได้ภาพหน้าจอที่พิกเซล‑เพอร์เฟ็กต์ + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +เมื่อคุณรันโปรแกรม ควรเห็นข้อความในคอนโซลยืนยันตำแหน่งไฟล์ เปิดไฟล์ PNG—คุณจะเห็นการแสดงผลที่แม่นยำของ `https://example.com` ที่ขนาด 1280 × 800 พิกเซล เรนเดอร์ด้วยอัตราส่วนพิกเซลของอุปกรณ์ที่ 2.0 (ทำให้ภาพคมชัดบนหน้าจอ Retina) + +### ผลลัพธ์ที่คาดหวัง + +``` +✅ PNG saved to: rendered_page.png +``` + +ไฟล์ `rendered_page.png` ที่ได้จะเป็นภาพคุณภาพสูง พร้อมสำหรับฝังในรายงาน, อีเมล, หรือพรีวิว UI + +## วิธีการเรนเดอร์ HTML เป็น PNG – ตัวแปรทั่วไป + +### การเรนเดอร์ขนาดหน้าที่แตกต่าง + +หากต้องการขนาดที่ต่างออกไป เพียงเปลี่ยนค่า `Size` ดังนี้: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### การเปลี่ยนค่า Device Pixel Ratio + +ค่า DPR `1.0` ให้ภาพความละเอียดมาตรฐาน ส่วน `3.0` จะจำลองหน้าจอความหนาแน่นสูงมาก ปรับตามความต้องการ: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### การเพิ่ม Header หรือ Cookie แบบกำหนดเอง + +บางครั้งหน้าเป้าหมายต้องการการยืนยันตัวตน คุณสามารถฉีด Header ก่อนโหลดได้ดังนี้: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### การเรนเดอร์หลายหน้า + +เพื่อส่งออกทุกหน้าเป็น PNG แยกไฟล์ ให้วนลูปตามจำนวนหน้า: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## เคล็ดลับการแก้ไขปัญหา + +- **Blank Image:** ตรวจสอบให้แน่ใจว่า URL สามารถเข้าถึงได้และ sandbox มีการเชื่อมต่ออินเทอร์เน็ต หากคุณอยู่หลังพร็อกซี ให้ตั้งค่าคุณสมบัติพร็อกซีของ JVM (`-Dhttp.proxyHost=…`). +- **Out‑of‑Memory Errors:** การเรนเดอร์ viewport ขนาดใหญ่มากอาจใช้ RAM มาก ลดขนาด viewport หรือค่าต่ำลงของ DPR +- **Missing Fonts:** Aspose.HTML ใช้ฟอนต์ระบบโดยค่าเริ่มต้น หากหน้าเว็บของคุณพึ่งพาเว็บฟอนต์ ให้แน่ใจว่าสามารถเข้าถึงได้หรือฝังฟอนต์ผ่าน CSS `@font-face` + +## ตัวอย่างทำงานเต็มรูปแบบ (โค้ดทั้งหมดในที่เดียว) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +คัดลอก‑วางโค้ดนี้ลงใน IDE ของคุณ ปรับ URL หรือพาธการบันทึก แล้วกด **Run** หากทุกอย่างตั้งค่าอย่างถูกต้อง คุณจะได้ไฟล์ PNG ภายในไม่กี่วินาที + +## สรุป + +ในบทเรียนนี้เราได้แสดงวิธี **save HTML page as PNG** ด้วย Java, ครอบคลุมรายละเอียดของ **how to render HTML to PNG**, และสาธิตขั้นตอนที่แน่นอนเพื่อ **set viewport size Java** เพื่อควบคุมผลลัพธ์อย่างแม่นยำ ตอนนี้คุณมีส니พเพตที่นำกลับไปใช้ใหม่ได้ในโปรเจกต์ Java ใดก็ได้—ไม่ว่าจะเป็นบริการแบ็กเอนด์ที่สร้างรูปย่อหรือชุดทดสอบที่ตรวจสอบเลย์เอาต์เชิงภาพ + +### ขั้นตอนต่อไป? + +- ทดลองค่า `DevicePixelRatio` ต่าง ๆ เพื่อสร้างสินทรัพย์พร้อม Retina +- ผสานวิธีนี้กับ headless browser เพื่อจับภาพหน้าเว็บที่มี JavaScript หนัก +- สำรวจรูปแบบการส่งออกอื่น ๆ เช่น JPEG หรือ PDF โดยเปลี่ยน `SaveFormat.PNG` เป็น `SaveFormat.JPEG` หรือ `SaveFormat.PDF` + +อย่าลังเลที่จะแก้ไขโค้ด, แบ่งปันผลลัพธ์, หรือถามคำถามในคอมเมนต์ ขอให้เรนเดอร์อย่างสนุกสนาน! + +![Screenshot of rendered HTML saved as PNG](https://example.com/placeholder.png "save html page as png example") + +{{< /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 b9af7690c..851a010af 100644 --- a/html/turkish/java/conversion-html-to-other-formats/_index.md +++ b/html/turkish/java/conversion-html-to-other-formats/_index.md @@ -85,6 +85,8 @@ Sonuç olarak, **html to pdf java** ve daha geniş dönüşüm setine hâkim olm ## Dönüştürme - HTML'den Diğer Formatlara Eğitimleri ### [HTML'yi PDF'ye Dönüştürme](./convert-html-to-pdf/) HTML içeriğinizden sorunsuz bir şekilde yüksek kaliteli PDF'ler oluşturun. +### [HTML'yi Java ile PDF'ye Dönüştürme – Adım‑Adım Kılavuz](./convert-html-to-pdf-with-java-step-by-step-guide/) +Java kullanarak HTML'yi PDF'ye dönüştürmenin adım adım ayrıntılı rehberi. ### [HTML'yi PDF'ye Dönüştürme Java’da – Sayfa Boyutu Ayarlarıyla Adım‑Adım Kılavuz](./convert-html-to-pdf-in-java-step-by-step-guide-with-page-siz/) Java’da HTML'yi PDF'ye dönüştürürken sayfa boyutu ayarlarını nasıl yapılandıracağınızı adım adım gösterir. ### [HTML'yi MHTML'ye Dönüştürme](./convert-html-to-mhtml/) diff --git a/html/turkish/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/turkish/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..dc5d6922f --- /dev/null +++ b/html/turkish/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,172 @@ +--- +category: general +date: 2026-03-17 +description: Aspose HTML for Java kullanarak HTML'yi PDF'ye dönüştürün. PDF sayfa + boyutunu nasıl ayarlayacağınızı, HTML'den PDF oluşturmayı ve HTML'yi tek bir öğreticide + PDF olarak dışa aktarmayı öğrenin. +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: tr +og_description: HTML'yi hızlı bir şekilde PDF'ye dönüştürün. Bu kılavuz, PDF sayfa + boyutunu nasıl ayarlayacağınızı, HTML'den PDF oluşturmayı ve Aspose HTML for Java + kullanarak HTML'yi PDF olarak dışa aktarmayı gösterir. +og_title: Java ile HTML'yi PDF'ye Dönüştür – Tam Programlama Rehberi +tags: +- Aspose +- Java +- PDF generation +title: Java ile HTML'yi PDF'ye Dönüştür – Adım Adım Rehber +url: /tr/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML'yi PDF'ye Dönüştürme Java ile – Adım Adım Kılavuz + +HTML'yi **PDF'ye dönüştürmek** istediğinizde ancak hangi kütüphanenin çıktının tam kontrolünü sağlayacağını bilemediğiniz oldu mu? Yalnız değilsiniz. Birçok projede—fatura oluşturucular, rapor dışa aktarıcıları veya e‑öğrenme platformları gibi—web sayfalarını yazdırılabilir PDF'lere dönüştürmek için güvenilir bir yola ihtiyacınız olacak. + +Bu öğreticide, **HTML'yi PDF'ye dönüştüren**, **PDF sayfa boyutunu ayarlamanıza** izin veren ve **HTML'den PDF oluşturma** sürecini temiz ve sürdürülebilir bir kodla nasıl yapacağınızı adım adım göstereceğiz. Sonunda, herhangi bir Java uygulamasına ekleyebileceğiniz yeniden kullanılabilir bir snippet elde edeceksiniz. Belirsiz referanslar yok, sadece somut kod ve net açıklamalar. + +## Öğrenecekleriniz + +- **PdfSaveOptions**'ı sayfa boyutları ve kenar boşluklarını tanımlamak için nasıl yapılandıracağınızı. +- Aspose.HTML for Java kullanarak **HTML'yi PDF olarak dışa aktarmak** için gereken tam çağrıyı. +- Arşivleme için kritik olan PDF/A‑1b uyumluluğunu nasıl yöneteceğinize dair ipuçları. +- Kopyalayıp yapıştırıp uyarlayabileceğiniz tam, çalıştırılabilir bir örnek. + +**Önkoşullar** – Java 8 veya daha yenisi, Aspose.HTML kütüphanesini çekmek için Maven ya da Gradle ve PDF'ye dönüştürmek istediğiniz basit bir HTML dosyası gerekir. Hepsi bu; ekstra framework ya da web sunucusu gerekmez. + +--- + +## Adım 1: PDF Sayfa Boyutu ve Kenar Boşluklarını Ayarlama + +İlk olarak genellikle kontrol etmek istediğiniz şey, ortaya çıkan belgenin boyutudur. Avrupa standartları için A4 ya da ABD için Letter ihtiyacınız olsun, Aspose bunu tek bir nesneyle belirtmenizi sağlar. + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**Neden önemli** – Sayfa boyutunu açıkça ayarlamazsanız, kütüphane varsayılan olarak US Letter kullanabilir ve bu da uluslararası kullanıcılar için düzeni bozabilir. Kenar boşluğu değerleri milimetre cinsindendir, bu da baskıya hazır tasarımlarla eşleşmeyi kolaylaştırır. + +> **Pro ipucu:** Özel bir boyuta ihtiyacınız varsa, `PdfPageSize.A4` yerine `new com.aspose.html.saving.PdfPageSize(width, height)` kullanın; burada genişlik ve yükseklik point cinsindendir. + +--- + +## Adım 2: HTML'den PDF Oluşturma + +Çıktı formatı tanımlandıktan sonra, gerçek dönüşüm tek satırda gerçekleşir. `Converter.convert` metodu HTML'i ayrıştırır, CSS'i uygular ve sayfayı PDF'e rasterleştirir. + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**Nasıl çalışır** – Aspose, HTML'i okur, bir DOM oluşturur, dış kaynakları (görseller, yazı tipleri, CSS) çözer ve ardından her render edilen sayfayı PDF akışına yazar. `pdfSaveOptions` nesnesini geçtiğimiz için motor, daha önce tanımladığımız sayfa boyutu, kenar boşlukları ve uyumluluk ayarlarına uyar. + +> **Sık sorulan soru:** *HTML'im göreceli yollarla görsellere referans veriyorsa ne olur?* +> Java sürecinizin çalışma dizini HTML dosyasının konumuyla aynı olduğundan emin olun ya da mutlak URL'ler kullanın. Aspose kaynakları otomatik olarak çeker. + +--- + +## Adım 3: HTML'yi PDF Olarak Dışa Aktarma – Tam Çalışan Örnek + +Parçaları bir araya getirerek, derleyip çalıştırabileceğiniz bağımsız bir Java sınıfı sunuyoruz. Gerekli import'ları, istisna yönetimini ve her bölümü açıklayan yorumları içerir. + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### Beklenen Sonuç + +Programı çalıştırdıktan sonra, belirttiğiniz aynı klasörde `output.pdf` dosyasını bulacaksınız. Adobe Reader, Foxit ya da bir tarayıcı gibi herhangi bir PDF görüntüleyicide açın; `input.html`'in A4 sayfa boyutu ve ayarladığınız 20 mm kenar boşluklarıyla sadık bir render'ını görmelisiniz. PDF/A‑1b'yi etkinleştirdiyseniz, dosya uzun vadeli saklama için gerekli meta verileri de içerir. + +--- + +## Sıkça Sorulan Sorular ve Kenar Durumları + +| Soru | Cevap | +|----------|--------| +| **Yerel bir dosya yerine bir URL'yi dönüştürebilir miyim?** | Evet. İlk argümanı URL dizesiyle değiştirin, örneğin `"https://example.com/report.html"`. | +| **Farklı bir sayfa yönlendirmesine ihtiyacım olursa?** | Dönüştürmeden önce `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` kullanın. | +| **Özel bir yazı tipini gömmek mümkün mü?** | Kesinlikle. Yazı tipi dosyasını HTML ile aynı dizine koyun veya CSS içinde `@font-face` ile referans verin; Aspose otomatik olarak gömer. | +| **Büyük HTML dosyaları bellek sorunlarına yol açıyorsa ne yapmalıyım?** | HTML'i akış olarak işlemek ya da bölümlere ayırıp her bölümü ayrı ayrı dönüştürmek, ardından PDF'leri Aspose.PDF ile birleştirmek düşünün. | +| **Aspose.HTML için bir lisansa ihtiyacım var mı?** | Ücretsiz deneme lisansı test için çalışır, ancak üretimde değerlendirme filigranını kaldırmak için ücretli bir lisans gerekir. | + +--- + +## Görsel Açıklama + +Aşağıda oluşturulan PDF'in hızlı bir ekran görüntüsü (yer tutucu görsel) yer alıyor. **alt** özniteliği ana anahtar kelimeyi kullanarak hem SEO'yu hem de erişilebilirliği destekler. + +A4 sayfa ve kenar boşlukları gösteren html'yi pdf'ye dönüştürme örneği + +--- + +## Özet + +Aspose.HTML for Java kullanarak **HTML'yi PDF'ye dönüştürme**, **PDF sayfa boyutunu ayarlama** ve **HTML'den PDF oluşturma** adımlarını, süreci yeni başlayanlar için yeterince basit, deneyimli geliştiriciler için ise esnek tutacak şekilde ele aldık. + +Daha ileri gitmek isterseniz şunları deneyin: + +- Farklı sayfa boyutları (`PdfPageSize.LETTER`, özel boyutlar). +- `PdfSaveOptions` ile filigranlar veya başlık/alt bilgi ekleme. +- Bir döngü içinde birden fazla HTML dosyasını dönüştürüp tek bir PDF'de birleştirme. + +Bu genişletmeler, keşfettiğimiz aynı temel kavramlar üzerine inşa edildiği için kodu herhangi bir iş akışına uyarlarken rahat hissedeceksiniz. + +**İyi kodlamalar!** Herhangi bir sorunla karşılaşırsanız aşağıya yorum bırakın ya da ileri seviye özellikler için Aspose belgelerine göz atın. + +{{< /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-various-image-formats/_index.md b/html/turkish/java/conversion-html-to-various-image-formats/_index.md index 38a68b543..66103bbbf 100644 --- a/html/turkish/java/conversion-html-to-various-image-formats/_index.md +++ b/html/turkish/java/conversion-html-to-various-image-formats/_index.md @@ -60,7 +60,7 @@ HTML'yi BMP'ye dönüştürmek, web sayfalarını arşivleme veya kayıpsız kal ## HTML'yi GIF'ye Dönüştürme -**HTML'yi GIF'ye dönüştürmek** ister misiniz? Animasyonlu ön izlemeler veya hafif grafikler için ideal bir çözümdür. Aspose.HTML for Java bu süreci basitleştirir. Bu eğitim, yüksek kaliteli çıktıyı minimum kodla elde etmenizi sağlar. +**HTML'yi GIF'ye dönüştürmek**, animasyonlu ön izlemeler veya hafif grafikler için ideal bir çözümdür. Aspose.HTML for Java bu süreci basitleştirir. Bu eğitim, yüksek kaliteli çıktıyı minimum kodla elde etmenizi sağlar. ## HTML'yi JPEG'ye Dönüştürme @@ -100,6 +100,8 @@ Aspose.HTML ile Java'da HTML'yi PNG görüntülerine dönüştürmeyi öğrenin. Aspose.HTML for Java kullanarak HTML'yi TIFF'ye kolayca dönüştürmeyi öğrenin. Verimli belge işleme için adım‑adım bir rehber. ### [HTML'yi WebP'ye Dönüştür – Aspose.HTML ile Tam Java Rehberi](./convert-html-to-webp-complete-java-guide-with-aspose-html/) Aspose.HTML for Java kullanarak HTML'yi WebP formatına yüksek kaliteyle dönüştürmeyi adım adım öğrenin. +### [HTML Sayfasını PNG Olarak Kaydet – Java Tam Rehberi](./save-html-page-as-png-in-java-complete-tutorial/) +Aspose.HTML for Java kullanarak HTML sayfasını PNG formatında kaydetmeyi adım adım öğrenin. ## Sıkça Sorulan Sorular diff --git a/html/turkish/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/turkish/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..7080000d6 --- /dev/null +++ b/html/turkish/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,246 @@ +--- +category: general +date: 2026-03-17 +description: HTML sayfasını hızlıca PNG olarak kaydetmeyi öğrenin. Bu kılavuz, Aspose.HTML + kullanarak Java'da HTML'yi PNG'ye nasıl render edeceğinizi ve görünüm alanı boyutunu + nasıl ayarlayacağınızı gösterir. +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: tr +og_description: HTML sayfasını Java ile PNG olarak kaydedin. Aspose.HTML kullanarak + HTML'yi PNG'ye nasıl dönüştüreceğinizi ve Java'da viewport boyutunu nasıl ayarlayacağınızı + öğrenmek için bu öğreticiyi izleyin. +og_title: Java'da HTML Sayfasını PNG Olarak Kaydet – Adım Adım Rehber +tags: +- Java +- AsposeHTML +- Image Rendering +title: Java'da HTML Sayfasını PNG Olarak Kaydet – Tam Kılavuz +url: /tr/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +Also "### Changing the Device Pixel Ratio", "### Adding Custom Headers or Cookies", "### Rendering Multiple Pages". + +Also "## Troubleshooting Tips" and bullet points. + +Also "## Full Working Example (All Code in One Place)". + +Also "## Conclusion" and final paragraphs. + +Also "### What’s Next?" and bullet points. + +Make sure to keep markdown formatting. + +Let's produce final answer.{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML Sayfasını PNG Olarak Kaydetme – Java Tam Kılavuzu + +Hiç **HTML sayfasını PNG olarak kaydetmek** gerektiğinde nereden başlayacağınızı bilemediniz mi? Tek başınıza değilsiniz—birçok geliştirici, raporlar, küçük resimler veya testler için bir web sayfasının hızlı bir ekran görüntüsüne ihtiyaç duyduğunda bu sorunu yaşıyor. Bu rehberde **HTML'yi PNG'ye nasıl render edeceğinizi** Aspose.HTML for Java kullanarak adım adım gösterecek ve **viewport boyutunu Java’da nasıl ayarlayacağınızı** açıklayacağız, böylece çıktı tam istediğiniz gibi olur. + +Kütüphanenin kurulumundan cihaz piksel oranını (device pixel ratio) ayarlamaya kadar her şeyi ele alacağız ve sonunda herhangi bir URL'den keskin bir PNG dosyası üreten, çalıştırmaya hazır bir program elde edeceksiniz. Belirsiz referanslar yok, sadece eksiksiz, kendi içinde çalışan bir çözüm. + +## Gereksinimler + +Başlamadan önce şunların kurulu olduğundan emin olun: + +- Java 11 veya daha yeni bir sürüm (güncel LTS sürümü mükemmel çalışır) +- Bağımlılık yönetimi için Maven ya da Gradle (Maven örneğini göstereceğiz) +- Örnek URL (`https://example.com`) ya da yakalamak istediğiniz herhangi bir sayfa için internet bağlantısı +- PNG'nin kaydedileceği, yazılabilir bir klasör + +Hepsi bu—ekstra SDK, yerel ikili dosyalar yok. Aspose.HTML tüm ağır işleri dahili olarak halleder. + +## Adım 1: Aspose.HTML Bağımlılığını Ekleyin + +İlk olarak Aspose.HTML kütüphanesini projenize ekleyin. Maven kullanıyorsanız `pom.xml` dosyanıza aşağıdakileri ekleyin: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Gradle kullanıcıları ise bunu `build.gradle` dosyasına ekleyebilir: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Pro tip:** En son sürüm için [Aspose.HTML sürüm notlarını](https://docs.aspose.com/html/java/) kontrol edin; yeni derlemeler genellikle render performans iyileştirmeleri içerir. + +## Adım 2: URL’den HTML Belgesini Yükleyin + +Şimdi yakalamak istediğiniz sayfaya işaret eden bir `HTMLDocument` nesnesi oluşturacağız. Bu adım **HTML'yi PNG'ye nasıl render edeceğiniz** için temel oluşturur; kütüphane işaretlemi (markup) ayrıştırır ve dahili bir DOM oluşturur. + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +Yerel bir dosya kullanmak isterseniz, URL dizesini `"file:///C:/mypage.html"` gibi bir dosya yolu ile değiştirmeniz yeterlidir. + +## Adım 3: Sandbox’ı Yapılandırın ve Viewport Boyutunu Ayarlayın + +Sandbox, render işlemini ana uygulama iş parçacığından izole eder ve sanal cihaz özelliklerini tanımlamanıza olanak verir. İşte **viewport boyutunu Java’da ayarladığınız** yer; render edilen bitmap'in boyutlarını kontrol eder. + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +Neden sandbox kullanmalı? Ağ isteklerinin render bağlamı dışına sızmasını önler ve deterministik sonuçlar verir—özellikle CI sunucusunda kod çalıştırırken çok önemlidir. + +## Adım 4: Görüntü Kaydetme Seçeneklerini Hazırlayın + +Aspose.HTML birçok formata (PNG, JPEG, BMP vb.) dışa aktarabilir. `ImageSaveOptions` nesnesini belgenin ilk sayfasına hedefleyecek ve PNG formatını belirtecek şekilde yapılandıracağız. + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +`setPageNumber` değerini `2` ya da `-1` (tüm sayfalar) olarak değiştirerek çok sayfalı bir görüntü dizisi oluşturabilirsiniz. + +## Adım 5: PNG Dosyasını Render Edin ve Kaydedin + +Son olarak `HTMLDocument` üzerinde `save` metodunu çağırın. Metod, önceki adımlarda uyguladığımız sandbox ayarlarını dikkate alarak piksel‑tam bir ekran görüntüsü üretir. + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +Programı çalıştırdığınızda, dosya konumunu onaylayan bir konsol mesajı görmelisiniz. PNG'yi açın— `https://example.com` sayfasının 1280 × 800 piksel boyutunda, cihaz piksel oranı 2.0 olan (Retina ekranlarda keskin görünen) tam bir görsel temsilini göreceksiniz. + +### Beklenen Çıktı + +``` +✅ PNG saved to: rendered_page.png +``` + +Oluşan `rendered_page.png` yüksek kaliteli bir görüntü dosyası olacak ve raporlar, e‑postalar ya da UI ön izlemeleri için kullanılmaya hazır. + +## HTML'yi PNG'ye Render Etme – Yaygın Varyasyonlar + +### Farklı Sayfa Boyutu Render Etme + +Farklı bir boyut istiyorsanız, sadece `Size` değerlerini değiştirin: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### Cihaz Piksel Oranını (Device Pixel Ratio) Değiştirme + +`1.0` DPR standart çözünürlük verirken, `3.0` çok yüksek yoğunluklu ekranları taklit eder. İhtiyacınıza göre ayarlayın: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Özel Header’lar veya Çerezler Ekleme + +Bazen hedef sayfa kimlik doğrulama ister. Yüklemeden önce header ekleyebilirsiniz: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Birden Fazla Sayfayı Render Etme + +Her sayfayı ayrı bir PNG olarak dışa aktarmak için sayfa sayısı üzerinden döngü oluşturun: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Sorun Giderme İpuçları + +- **Boş Görüntü:** URL'nin erişilebilir olduğundan ve sandbox'ın internet erişimine sahip olduğundan emin olun. Proxy arkasındaysanız, JVM proxy özelliklerini (`-Dhttp.proxyHost=…`) ayarlayın. +- **Bellek Yetersizliği (Out‑of‑Memory) Hataları:** Çok büyük viewport'lar çok fazla RAM tüketir. Viewport boyutunu küçültün veya DPR'yi düşürün. +- **Eksik Fontlar:** Aspose.HTML varsayılan olarak sistem fontlarını kullanır. Sayfanız web fontlarına dayanıyorsa, bu fontların erişilebilir olduğundan veya CSS `@font-face` ile gömülü olduğundan emin olun. + +## Tam Çalışan Örnek (Tüm Kod Tek Bir Yerde) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +Bunu IDE'nize kopyalayıp yapıştırın, URL ya da çıktı yolunu ayarlayın ve **Run** tuşuna basın. Her şey doğru kurulduysa, birkaç saniye içinde bir PNG elde edeceksiniz. + +## Sonuç + +Bu öğreticide **HTML sayfasını PNG olarak kaydetmenin** Java ile nasıl yapılacağını, **HTML'yi PNG'ye nasıl render edeceğinizi** ve **viewport boyutunu Java’da nasıl ayarlayacağınızı** adım adım gösterdik. Artık herhangi bir Java projesine kolayca ekleyebileceğiniz, thumbnail üreten bir backend servisi ya da görsel düzenleri doğrulayan bir test çerçevesi gibi yeniden kullanılabilir bir snippetiniz var. + +### Sırada Ne Var? + +- Retina‑hazır varlıklar için farklı `DevicePixelRatio` değerleriyle deneyler yapın. +- Bu yaklaşımı, dinamik ve JavaScript‑ağır sayfaları yakalamak için bir headless tarayıcıyla birleştirin. +- `SaveFormat.PNG` yerine `SaveFormat.JPEG` ya da `SaveFormat.PDF` kullanarak JPEG ya da PDF gibi diğer dışa aktarma formatlarını keşfedin. + +Kodunuzu özelleştirmekten, sonuçlarınızı paylaşmaktan ya da yorumlarda sorular sormaktan çekinmeyin. İyi renderlamalar! + +![Render edilmiş HTML'nin PNG olarak kaydedildiği Ekran Görüntüsü](https://example.com/placeholder.png "html sayfasını png olarak kaydetme örneği") + +{{< /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 ec6e7a78c..40f30f57a 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. +### [Chuyển đổi HTML sang PDF với Java – Hướng dẫn từng bước](./convert-html-to-pdf-with-java-step-by-step-guide/) +Hướng dẫn chi tiết cách chuyển đổi HTML sang PDF trong Java bằng Aspose.HTML, bao gồm các bước cấu hình và tùy chỉnh đầu ra. + ### [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/convert-html-to-pdf-with-java-step-by-step-guide/_index.md b/html/vietnamese/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md new file mode 100644 index 000000000..4ad0ecd84 --- /dev/null +++ b/html/vietnamese/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/_index.md @@ -0,0 +1,171 @@ +--- +category: general +date: 2026-03-17 +description: Chuyển đổi HTML sang PDF bằng Aspose HTML cho Java. Tìm hiểu cách thiết + lập kích thước trang PDF, tạo PDF từ HTML và xuất HTML dưới dạng PDF trong một hướng + dẫn duy nhất. +draft: false +keywords: +- convert html to pdf +- set pdf page size +- generate pdf from html +- export html as pdf +- java html to pdf +language: vi +og_description: Chuyển đổi HTML sang PDF nhanh chóng. Hướng dẫn này chỉ cách đặt kích + thước trang PDF, tạo PDF từ HTML và xuất HTML thành PDF bằng Aspose HTML cho Java. +og_title: Chuyển đổi HTML sang PDF bằng Java – Hướng dẫn lập trình toàn diện +tags: +- Aspose +- Java +- PDF generation +title: Chuyển đổi HTML sang PDF bằng Java – Hướng dẫn từng bước +url: /vi/java/conversion-html-to-other-formats/convert-html-to-pdf-with-java-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Chuyển đổi HTML sang PDF bằng Java – Hướng dẫn từng bước + +Bạn đã bao giờ cần **chuyển đổi HTML sang PDF** nhưng không chắc thư viện nào sẽ cho bạn kiểm soát đầy đủ đầu ra? Bạn không cô đơn. Trong nhiều dự án—như trình tạo hoá đơn, xuất báo cáo, hay nền tảng e‑learning—bạn sẽ cần một cách đáng tin cậy để biến các trang web thành PDF có thể in được. + +Trong hướng dẫn này, chúng ta sẽ đi qua một giải pháp hoàn chỉnh, sẵn sàng chạy, **chuyển đổi HTML sang PDF**, cho phép bạn **đặt kích thước trang PDF**, và chỉ ra cách **tạo PDF từ HTML** trong khi giữ mã nguồn sạch sẽ và dễ bảo trì. Khi kết thúc, bạn sẽ có một đoạn mã có thể tái sử dụng trong bất kỳ ứng dụng Java nào. Không có tham chiếu mơ hồ, chỉ có mã cụ thể và giải thích rõ ràng. + +## Những gì bạn sẽ học + +- Cách cấu hình **PdfSaveOptions** để định nghĩa kích thước trang và lề. +- Lệnh chính xác bạn cần để **xuất HTML dưới dạng PDF** bằng Aspose.HTML for Java. +- Mẹo xử lý tuân thủ PDF/A‑1b, rất quan trọng cho việc lưu trữ. +- Một ví dụ đầy đủ, có thể chạy ngay mà bạn có thể sao chép‑dán và tùy chỉnh. + +**Yêu cầu trước** – bạn sẽ cần Java 8 hoặc mới hơn, Maven hoặc Gradle để tải thư viện Aspose.HTML, và một tệp HTML đơn giản mà bạn muốn chuyển thành PDF. Đó là tất cả; không cần framework hay máy chủ web bổ sung. + +--- + +## Bước 1: Đặt kích thước trang PDF và lề + +Điều đầu tiên bạn thường muốn kiểm soát là kích thước của tài liệu kết quả. Dù bạn cần A4 cho tiêu chuẩn châu Âu hay Letter cho Mỹ, Aspose cho phép bạn chỉ định bằng một đối tượng duy nhất. + +```java +import com.aspose.html.saving.PdfSaveOptions; +import com.aspose.html.saving.PdfPageSize; +import com.aspose.html.saving.PdfMargin; +import com.aspose.html.saving.PdfACompliance; + +// Create PDF save options +PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + +// Set the page size – here we choose A4 +pdfSaveOptions.setPageSize(PdfPageSize.A4); + +// Define margins in millimeters (top, right, bottom, left) +pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); + +// Optional: enforce PDF/A‑1b compliance for long‑term archiving +pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); +``` + +**Tại sao điều này quan trọng** – Nếu không đặt kích thước trang một cách rõ ràng, thư viện có thể mặc định là US Letter, gây lỗi bố cục cho người dùng quốc tế. Các giá trị lề cũng được tính bằng milimet, giúp dễ dàng khớp với thiết kế sẵn sàng in. + +> **Mẹo chuyên nghiệp:** Nếu bạn cần kích thước tùy chỉnh, thay `PdfPageSize.A4` bằng `new com.aspose.html.saving.PdfPageSize(width, height)` trong đó width và height tính bằng points. + +--- + +## Bước 2: Tạo PDF từ HTML + +Bây giờ định dạng đầu ra đã được xác định, việc chuyển đổi thực tế chỉ là một dòng lệnh. Phương thức `Converter.convert` xử lý việc phân tích HTML, áp dụng CSS, và raster hoá trang thành PDF. + +```java +import com.aspose.html.converters.Converter; + +// Convert the HTML file to PDF using the configured options +Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); +``` + +**Cách hoạt động** – Bên trong, Aspose đọc HTML, xây dựng DOM, giải quyết các tài nguyên bên ngoài (hình ảnh, phông chữ, CSS), và sau đó ghi mỗi trang đã render vào luồng PDF. Vì chúng ta đã truyền đối tượng `pdfSaveOptions`, engine sẽ tuân thủ kích thước trang, lề và các cài đặt tuân thủ mà chúng ta đã định nghĩa trước đó. + +> **Câu hỏi thường gặp:** *Nếu HTML của tôi tham chiếu đến hình ảnh bằng đường dẫn tương đối thì sao?* +> Hãy chắc chắn thư mục làm việc của tiến trình Java trùng với vị trí của tệp HTML, hoặc sử dụng URL tuyệt đối. Aspose sẽ tự động tải các tài nguyên này. + +--- + +## Bước 3: Xuất HTML thành PDF – Ví dụ làm việc đầy đủ + +Kết hợp các phần lại, dưới đây là một lớp Java tự chứa mà bạn có thể biên dịch và chạy. Nó bao gồm các import cần thiết, xử lý ngoại lệ, và các chú thích giải thích từng phần. + +```java +import com.aspose.html.*; +import com.aspose.html.converters.*; +import com.aspose.html.saving.*; + +public class HtmlToPdfTutorial { + public static void main(String[] args) throws Exception { + + // --------------------------------------------------------- + // Step 1: Create PDF save options and define the page layout + // --------------------------------------------------------- + PdfSaveOptions pdfSaveOptions = new PdfSaveOptions(); + pdfSaveOptions.setPageSize(PdfPageSize.A4); + pdfSaveOptions.setMargin(new PdfMargin(20, 20, 20, 20)); // margins in mm + pdfSaveOptions.setPdfACompliance(PdfACompliance.PDFA_1B); // enable PDF/A‑1b compliance + + // --------------------------------------------------------- + // Step 2: Convert the HTML file to PDF using the configured options + // --------------------------------------------------------- + Converter.convert( + "YOUR_DIRECTORY/input.html", // source HTML file + "YOUR_DIRECTORY/output.pdf", // destination PDF file + pdfSaveOptions); + } +} +``` + +### Kết quả mong đợi + +Sau khi chạy chương trình, bạn sẽ thấy `output.pdf` trong cùng thư mục mà bạn đã chỉ định. Mở nó bằng bất kỳ trình xem PDF nào—Adobe Reader, Foxit, hoặc thậm chí trình duyệt—bạn sẽ thấy bản render trung thực của `input.html`, với kích thước trang A4 và lề 20 mm mà bạn đã đặt. Nếu bạn đã bật PDF/A‑1b, tệp cũng sẽ chứa siêu dữ liệu cần thiết cho việc bảo tồn lâu dài. + +--- + +## Câu hỏi thường gặp & Trường hợp đặc biệt + +| Câu hỏi | Trả lời | +|----------|--------| +| **Tôi có thể chuyển đổi một URL thay vì tệp cục bộ không?** | Có. Thay đối số đầu tiên bằng chuỗi URL, ví dụ: `"https://example.com/report.html"`. | +| **Nếu tôi cần hướng trang khác?** | Sử dụng `pdfSaveOptions.setPageOrientation(PdfPageOrientation.LANDSCAPE);` trước khi chuyển đổi. | +| **Có thể nhúng phông chữ tùy chỉnh không?** | Chắc chắn. Đặt tệp phông chữ trong cùng thư mục với HTML hoặc tham chiếu qua `@font-face` trong CSS; Aspose sẽ tự động nhúng nó. | +| **Làm sao xử lý các tệp HTML lớn gây vấn đề bộ nhớ?** | Xem xét streaming HTML hoặc chia thành các phần và chuyển đổi từng phần riêng biệt, sau đó hợp nhất các PDF bằng Aspose.PDF. | +| **Tôi có cần giấy phép cho Aspose.HTML không?** | Giấy phép dùng thử miễn phí đủ cho việc thử nghiệm, nhưng trong môi trường sản xuất bạn sẽ cần giấy phép trả phí để loại bỏ watermark đánh giá. | + +--- + +## Minh hoạ hình ảnh + +Dưới đây là một ảnh chụp nhanh của PDF đã tạo (hình placeholder). Thuộc tính **alt** sử dụng từ khóa chính, hỗ trợ SEO và khả năng truy cập. + +ví dụ chuyển đổi html sang pdf hiển thị trang A4 với lề + +--- + +## Tổng kết + +Chúng ta vừa khám phá cách **chuyển đổi HTML sang PDF** bằng Aspose.HTML for Java, cách **đặt kích thước trang PDF**, và các bước chính để **tạo PDF từ HTML** trong khi giữ quy trình đủ đơn giản cho người mới bắt đầu và đủ linh hoạt cho các nhà phát triển dày dặn kinh nghiệm. + +Nếu bạn muốn tiến xa hơn, hãy thử: + +- Các kích thước trang khác (`PdfPageSize.LETTER`, kích thước tùy chỉnh). +- Thêm watermark hoặc header/footer qua `PdfSaveOptions`. +- Chuyển đổi nhiều tệp HTML trong một vòng lặp và hợp nhất chúng thành một PDF duy nhất. + +Những mở rộng này dựa trên cùng các khái niệm cốt lõi mà chúng ta đã tìm hiểu, vì vậy bạn sẽ cảm thấy thoải mái khi điều chỉnh mã cho bất kỳ quy trình làm việc nào. + +**Chúc lập trình vui vẻ!** Nếu gặp khó khăn, hãy để lại bình luận bên dưới hoặc tham khảo tài liệu Aspose để khám phá sâu hơn các tính năng nâng cao. + +{{< /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-various-image-formats/_index.md b/html/vietnamese/java/conversion-html-to-various-image-formats/_index.md index 88c812212..4b1ec130d 100644 --- a/html/vietnamese/java/conversion-html-to-various-image-formats/_index.md +++ b/html/vietnamese/java/conversion-html-to-various-image-formats/_index.md @@ -90,6 +90,8 @@ Tìm hiểu cách convert HTML to GIF trong Java bằng Aspose.HTML. Một hư Học cách convert HTML to JPEG với Aspose.HTML for Java. Hướng dẫn từng bước để xử lý tài liệu một cách liền mạch. ### [Converting HTML to PNG](./convert-html-to-png/) Tìm hiểu cách convert HTML to PNG trong Java với Aspose.HTML. Một hướng dẫn toàn diện với các bước chi tiết. +### [Lưu trang HTML dưới dạng PNG trong Java – Hướng dẫn đầy đủ](./save-html-page-as-png-in-java-complete-tutorial/) +Hướng dẫn chi tiết cách lưu trang HTML thành tệp PNG trong Java bằng Aspose.HTML, bao gồm các bước cấu hình và mã mẫu. ### [Converting HTML to TIFF](./convert-html-to-tiff/) Tìm hiểu cách dễ dàng convert HTML to TIFF bằng Aspose.HTML for Java. Hướng dẫn từng bước cho việc xử lý tài liệu hiệu quả. ### [Chuyển đổi HTML sang WebP – Hướng dẫn Java đầy đủ với Aspose.HTML](./convert-html-to-webp-complete-java-guide-with-aspose-html/) diff --git a/html/vietnamese/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md b/html/vietnamese/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md new file mode 100644 index 000000000..9cca972ff --- /dev/null +++ b/html/vietnamese/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/_index.md @@ -0,0 +1,233 @@ +--- +category: general +date: 2026-03-17 +description: Tìm hiểu cách lưu trang HTML thành PNG nhanh chóng. Hướng dẫn này chỉ + cách chuyển đổi HTML sang PNG và thiết lập kích thước viewport trong Java bằng Aspose.HTML. +draft: false +keywords: +- save html page as png +- how to render html to png +- set viewport size java +- Aspose.HTML Java rendering +- export HTML as image +language: vi +og_description: Lưu trang HTML dưới dạng PNG bằng Java. Theo dõi hướng dẫn này để + học cách chuyển đổi HTML sang PNG và thiết lập kích thước viewport trong Java bằng + Aspose.HTML. +og_title: Lưu trang HTML dưới dạng PNG trong Java – Hướng dẫn chi tiết từng bước +tags: +- Java +- AsposeHTML +- Image Rendering +title: Lưu Trang HTML dưới dạng PNG trong Java – Hướng Dẫn Toàn Diện +url: /vi/java/conversion-html-to-various-image-formats/save-html-page-as-png-in-java-complete-tutorial/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Lưu Trang HTML dưới dạng PNG trong Java – Hướng Dẫn Đầy Đủ + +Bạn đã bao giờ cần **lưu trang HTML dưới dạng PNG** nhưng không biết bắt đầu từ đâu? Bạn không phải là người duy nhất—nhiều nhà phát triển gặp khó khăn này khi cần một ảnh chụp nhanh của trang web cho báo cáo, ảnh thu nhỏ, hoặc kiểm thử. Trong hướng dẫn này, chúng tôi sẽ chỉ cho bạn **cách render HTML thành PNG** bằng Aspose.HTML cho Java, và cũng sẽ chỉ cách **đặt kích thước viewport trong Java** để kết quả hiển thị đúng như mong muốn. + +Chúng tôi sẽ bao phủ mọi thứ từ cài đặt thư viện đến điều chỉnh tỷ lệ pixel của thiết bị, và cuối cùng bạn sẽ có một chương trình sẵn sàng chạy, tạo ra file PNG sắc nét từ bất kỳ URL nào. Không có tham chiếu mơ hồ, chỉ có giải pháp hoàn chỉnh, tự chứa. + +## Những gì bạn cần + +Trước khi bắt đầu, hãy chắc chắn rằng bạn có: + +- Java 11 hoặc mới hơn (phiên bản LTS hiện tại hoạt động hoàn hảo) +- Maven hoặc Gradle để quản lý phụ thuộc (chúng tôi sẽ đưa ví dụ Maven) +- Kết nối internet để tải URL mẫu (`https://example.com`) hoặc bất kỳ trang nào bạn muốn chụp +- Thư mục có quyền ghi trên đĩa để lưu file PNG + +Đó là tất cả—không cần SDK bổ sung, không cần binary gốc. Aspose.HTML sẽ xử lý phần nặng bên trong. + +## Bước 1: Thêm phụ thuộc Aspose.HTML + +Đầu tiên, kéo thư viện Aspose.HTML vào dự án của bạn. Nếu bạn dùng Maven, thêm đoạn sau vào `pom.xml` của bạn: + +```xml + + + com.aspose + aspose-html + 22.12 + +``` + +Người dùng Gradle có thể đặt đoạn này vào `build.gradle`: + +```groovy +implementation 'com.aspose:aspose-html:22.12' +``` + +> **Mẹo chuyên nghiệp:** Kiểm tra [Aspose.HTML release notes](https://docs.aspose.com/html/java/) để biết phiên bản mới nhất; các bản dựng mới thường bao gồm các cải tiến hiệu năng cho việc render. + +## Bước 2: Tải tài liệu HTML từ URL + +Bây giờ chúng ta sẽ tạo một đối tượng `HTMLDocument` trỏ tới trang bạn muốn chụp. Bước này là cốt lõi của **cách render HTML thành PNG** vì thư viện sẽ phân tích markup và xây dựng DOM nội bộ. + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // Load an HTML document from a web address + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +Nếu bạn muốn dùng file cục bộ, chỉ cần thay chuỗi URL bằng đường dẫn file như `"file:///C:/mypage.html"`. + +## Bước 3: Cấu hình Sandbox và Đặt Kích thước Viewport + +Sandbox tách việc render ra khỏi luồng chính của ứng dụng và cho phép bạn định nghĩa các đặc tính thiết bị ảo. Đây là nơi chúng ta **đặt kích thước viewport trong Java** để kiểm soát kích thước bitmap được render. + +```java + // Configure a sandboxed rendering device (viewport 1280×800, DPR 2.0) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); // <-- set viewport size Java + deviceSettings.setDevicePixelRatio(2.0); // High‑DPI rendering + deviceSettings.setUserAgent("AsposeHTML/1.0"); // Optional but useful + + // Attach the sandbox to the document so rendering uses the settings above + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); +``` + +Tại sao phải dùng sandbox? Nó ngăn các tác động phụ như yêu cầu mạng rò rỉ ra ngoài ngữ cảnh render, và cung cấp kết quả có tính quyết định—đặc biệt quan trọng khi chạy mã trên máy CI. + +## Bước 4: Chuẩn bị tùy chọn lưu ảnh + +Aspose.HTML có thể xuất ra nhiều định dạng (PNG, JPEG, BMP, …). Chúng ta sẽ cấu hình `ImageSaveOptions` để xuất trang đầu tiên của tài liệu và chỉ định PNG làm định dạng đầu ra. + +```java + // Prepare image save options to export the first page as PNG + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // Render only the first page +``` + +Bạn có thể thay `setPageNumber` thành `2` hoặc `-1` (tất cả các trang) nếu cần một chuỗi ảnh đa trang. + +## Bước 5: Render và Lưu file PNG + +Cuối cùng, gọi `save` trên `HTMLDocument`. Phương thức này sẽ tuân theo tất cả cài đặt sandbox mà chúng ta đã áp dụng trước đó, tạo ra một ảnh chụp màn hình pixel‑perfect. + +```java + // Render and save the page to a file + String outputPath = "rendered_page.png"; // adjust the path as needed + htmlDoc.save(outputPath, pngOptions); + System.out.println("✅ PNG saved to: " + outputPath); + } + } +} +``` + +Khi chạy chương trình, bạn sẽ thấy thông báo trên console xác nhận vị trí file. Mở file PNG—bạn sẽ thấy hình ảnh chính xác của `https://example.com` với kích thước 1280 × 800 pixel, được render với tỷ lệ pixel thiết bị là 2.0 (để ảnh trông sắc nét trên màn hình Retina). + +### Kết quả mong đợi + +``` +✅ PNG saved to: rendered_page.png +``` + +File `rendered_page.png` sẽ là một ảnh chất lượng cao, sẵn sàng nhúng vào báo cáo, email, hoặc preview UI. + +## Cách render HTML thành PNG – Các biến thể phổ biến + +### Render với kích thước trang khác + +Nếu bạn cần kích thước khác, chỉ cần thay đổi các giá trị `Size`: + +```java +deviceSettings.setViewportSize(new Size(1920, 1080)); // Full HD +``` + +### Thay đổi Device Pixel Ratio + +DPR `1.0` cho bạn một ảnh độ phân giải tiêu chuẩn, trong khi `3.0` mô phỏng màn hình siêu dày đặc. Điều chỉnh theo nhu cầu: + +```java +deviceSettings.setDevicePixelRatio(3.0); +``` + +### Thêm Header hoặc Cookie tùy chỉnh + +Đôi khi trang mục tiêu yêu cầu xác thực. Bạn có thể tiêm header trước khi tải: + +```java +htmlDoc.getHeaders().add("Authorization", "Bearer YOUR_TOKEN"); +``` + +### Render nhiều trang + +Để xuất mỗi trang thành một PNG riêng, lặp qua số lượng trang: + +```java +int totalPages = htmlDoc.getPages().size(); +for (int i = 1; i <= totalPages; i++) { + pngOptions.setPageNumber(i); + htmlDoc.save("page_" + i + ".png", pngOptions); +} +``` + +## Mẹo khắc phục sự cố + +- **Ảnh trắng:** Đảm bảo URL có thể truy cập và sandbox có quyền internet. Nếu bạn ở sau proxy, đặt các thuộc tính proxy của JVM (`-Dhttp.proxyHost=…`). +- **Lỗi Out‑of‑Memory:** Render viewport quá lớn có thể tiêu tốn nhiều RAM. Giảm kích thước viewport hoặc hạ DPR. +- **Thiếu font:** Aspose.HTML sử dụng font hệ thống theo mặc định. Nếu trang của bạn dựa vào web font, hãy chắc chắn chúng có thể truy cập hoặc nhúng chúng qua CSS `@font-face`. + +## Ví dụ hoàn chỉnh (Tất cả mã trong một nơi) + +```java +import com.aspose.html.*; +import com.aspose.html.rendering.*; + +public class SandboxRenderTutorial { + public static void main(String[] args) throws Exception { + // 1️⃣ Load the HTML document + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // 2️⃣ Set up sandbox with viewport size (set viewport size java) + RenderingDeviceSettings deviceSettings = new RenderingDeviceSettings(); + deviceSettings.setViewportSize(new Size(1280, 800)); + deviceSettings.setDevicePixelRatio(2.0); + deviceSettings.setUserAgent("AsposeHTML/1.0"); + DocumentSandbox sandbox = new DocumentSandbox(deviceSettings); + htmlDoc.setSandbox(sandbox); + + // 3️⃣ Configure PNG export (how to render html to png) + try (ImageSaveOptions pngOptions = new ImageSaveOptions(SaveFormat.PNG)) { + pngOptions.setPageNumber(1); // first page only + + // 4️⃣ Render and write the file + String output = "rendered_page.png"; + htmlDoc.save(output, pngOptions); + System.out.println("✅ PNG saved to: " + output); + } + } +} +``` + +Sao chép‑dán đoạn này vào IDE, điều chỉnh URL hoặc đường dẫn xuất, và nhấn **Run**. Nếu mọi thứ đã được cấu hình đúng, bạn sẽ có một PNG trong vài giây. + +## Kết luận + +Trong tutorial này, chúng tôi đã chỉ cho bạn **cách lưu trang HTML dưới dạng PNG** bằng Java, đề cập đến các chi tiết của **cách render HTML thành PNG**, và trình bày các bước **đặt kích thước viewport trong Java** để kiểm soát chính xác đầu ra. Giờ đây bạn đã có một đoạn mã có thể tái sử dụng, có thể chèn vào bất kỳ dự án Java nào—dù là dịch vụ backend tạo thumbnail hay bộ kiểm thử xác thực bố cục trực quan. + +### Tiếp theo là gì? + +- Thử nghiệm các giá trị `DevicePixelRatio` khác nhau để tạo tài nguyên sẵn cho retina. +- Kết hợp cách này với trình duyệt headless để chụp các trang động, nặng JavaScript. +- Khám phá các định dạng xuất khẩu khác như JPEG hoặc PDF bằng cách thay `SaveFormat.PNG` thành `SaveFormat.JPEG` hoặc `SaveFormat.PDF`. + +Hãy thoải mái tùy chỉnh mã, chia sẻ kết quả, hoặc đặt câu hỏi trong phần bình luận. Chúc bạn render vui vẻ! + +![Screenshot of rendered HTML saved as PNG](https://example.com/placeholder.png "save html page as png example") + +{{< /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