diff --git a/html/arabic/net/generate-jpg-and-png-images/_index.md b/html/arabic/net/generate-jpg-and-png-images/_index.md index 432f80cdc..24ae04268 100644 --- a/html/arabic/net/generate-jpg-and-png-images/_index.md +++ b/html/arabic/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Aspose.HTML for .NET هي مكتبة قوية تتيح للمطورين إنشا تعلم كيفية تمكين مضاد التعرج عند تحويل ملفات DOCX إلى صور PNG أو JPG باستخدام Aspose.HTML. ### [تحويل docx إلى png – إنشاء أرشيف zip في C# – دليل تعليمي](./convert-docx-to-png-create-zip-archive-c-tutorial/) تعلم كيفية تحويل ملفات docx إلى صور PNG وإنشاء أرشيف ZIP باستخدام C# و Aspose.HTML. +### [تحويل HTML إلى PNG باستخدام C# – دليل شامل خطوة بخطوة](./render-html-to-png-in-c-complete-step-by-step-guide/) +دليل شامل خطوة بخطوة لتحويل HTML إلى PNG باستخدام C# و Aspose.HTML. ## خاتمة diff --git a/html/arabic/net/generate-jpg-and-png-images/render-html-to-png-in-c-complete-step-by-step-guide/_index.md b/html/arabic/net/generate-jpg-and-png-images/render-html-to-png-in-c-complete-step-by-step-guide/_index.md new file mode 100644 index 000000000..e8f7d7714 --- /dev/null +++ b/html/arabic/net/generate-jpg-and-png-images/render-html-to-png-in-c-complete-step-by-step-guide/_index.md @@ -0,0 +1,186 @@ +--- +category: general +date: 2026-02-17 +description: تعلم كيفية تحويل HTML إلى PNG بسرعة. يوضح هذا الدرس أيضًا كيفية تحويل + صفحة الويب إلى صورة، وتعيين لون خلفية الصورة، وتكوين حجم الصورة. +draft: false +keywords: +- render html to png +- convert webpage to image +- save html as png +- set background color image +- configure image size +language: ar +og_description: قم بتحويل HTML إلى PNG على الفور. اتبع هذا الدليل لتحويل صفحة الويب + إلى صورة، وضبط لون الخلفية وتكوين حجم الصورة باستخدام Aspose.HTML. +og_title: تحويل HTML إلى PNG في C# – دليل برمجة كامل +tags: +- Aspose.HTML +- C# +- Image Rendering +title: تحويل HTML إلى PNG في C# – دليل كامل خطوة بخطوة +url: /ar/net/generate-jpg-and-png-images/render-html-to-png-in-c-complete-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# تحويل HTML إلى PNG في C# – دليل خطوة بخطوة كامل + +هل احتجت يوماً إلى **render HTML to PNG** لكن لم تكن متأكدًا من المكتبة التي تختارها؟ لست وحدك—العديد من المطورين يواجهون هذه المشكلة عندما يرغبون في إنشاء صور مصغرة، معاينات بريد إلكتروني، أو ملفات PDF من صفحة ويب حية. الخبر السار؟ باستخدام Aspose.HTML يمكنك تحويل صفحة ويب إلى صورة ببضع أسطر فقط، كما تحصل على تحكم دقيق في لون الخلفية، أبعاد الصورة، وعرض النص. + +في هذا الدرس سنستعرض العملية بالكامل: من تحميل صفحة عن بُعد، إلى تكوين خيارات التصيير (بما في ذلك كيفية **set background color image** و **configure image size**)، وأخيرًا حفظ النتيجة كملف PNG (**save HTML as PNG**). في النهاية ستحصل على تطبيق C# console جاهز للتشغيل يحول أي عنوان URL إلى لقطة PNG واضحة. + +## ما ستتعلمه + +- كيف تستخدم **render HTML to PNG** باستخدام `ImageRenderer` الخاص بـ Aspose.HTML. +- الخطوات الدقيقة لـ **convert webpage to image** مع عرض، ارتفاع، وخلفية مخصصة. +- طرق **set background color image** للصفحات الشفافة. +- نصائح **configure image size** لإخراج عالي الدقة. +- المشكلات الشائعة ونصائح احترافية تحافظ على وضوح التصيير. + +> **المتطلبات المسبقة** – تحتاج إلى .NET 6+ (أو .NET Framework 4.7+)، Visual Studio 2022 (أو أي بيئة تطوير تفضلها)، وإشارة NuGet إلى `Aspose.HTML`. لا توجد خدمات خارجية أخرى مطلوبة. + +--- + +## كيفية تحويل HTML إلى PNG باستخدام Aspose.HTML + +البرنامج الكامل القابل للتنفيذ أدناه. يمكنك نسخه ولصقه في مشروع console جديد والضغط على **F5**. + +```csharp +// ------------------------------------------------------------ +// Full C# example: render HTML to PNG using Aspose.HTML +// ------------------------------------------------------------ +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Image; +using Aspose.Html.Drawing; +using Aspose.Html.Drawing.Image; + +namespace HtmlToPngDemo +{ + class Program + { + static void Main() + { + // Step 1: Load the HTML document from a URL + // This is where we **convert webpage to image** – the URL can be any public site. + HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); + + // Step 2: Configure image rendering options + var renderingOptions = new ImageRenderingOptions() + { + // Enable antialiasing for smoother edges + UseAntialiasing = true, + + // Improve glyph clarity on low‑resolution output + TextOptions = new TextOptions() { UseHinting = true }, + + // Set output image size – this is how we **configure image size** + Width = 1024, + Height = 768, + + // **Set background color image** – white works for most screenshots + BackgroundColor = Color.White + }; + + // Step 3: Create an ImageRenderer with the document and options + using (var renderer = new ImageRenderer(htmlDoc, renderingOptions)) + { + // Step 4: Render the whole page to an image + renderer.Render(); + + // Step 5: Save the rendered image as PNG – **save HTML as PNG** + renderer.Save("output/page.png"); + } + + Console.WriteLine("✅ Rendering complete! Check the 'output' folder for your PNG."); + } + } +} +``` + +> **ملاحظة:** يحتوي الكود أعلاه على تعليقات تشرح كل سطر غير واضح، مما يسهل تكييفه لمشاريعك الخاصة. + +### شرح خطوة بخطوة + +#### 1️⃣ تحميل مستند HTML (convert webpage to image) + +```csharp +HTMLDocument htmlDoc = new HTMLDocument("https://example.com"); +``` + +- **لماذا؟** تحتاج Aspose.HTML إلى تمثيل DOM قبل أن تتمكن من تحويله إلى صورة. عند تمرير عنوان URL، تقوم المكتبة بجلب الصفحة، تحليلها، وبناء نموذج مستند داخلي. +- **حالة حافة:** إذا كان الموقع المستهدف يتطلب مصادقة، سيتعين عليك توفير رؤوس HTTP مخصصة أو ملفات تعريف الارتباط. يقبل مُنشئ `HTMLDocument` نسخة مفرطة تستقبل `Uri` وكائن `WebRequest`. + +#### 2️⃣ تكوين خيارات التصيير (configure image size & set background color image) + +```csharp +var renderingOptions = new ImageRenderingOptions() +{ + UseAntialiasing = true, + TextOptions = new TextOptions() { UseHinting = true }, + Width = 1024, + Height = 768, + BackgroundColor = Color.White +}; +``` + +- **Antialiasing** يُنعّم الحواف، خاصةً للأشكال المتجهية. +- **Text hinting** يحسّن وضوح الحروف في المخرجات منخفضة DPI. +- **Width/Height** يتيح لك **configure image size** بدقة؛ يمكنك أيضًا تمرير `0` لتحديد الحجم تلقائيًا بناءً على CSS الخاص بالصفحة. +- **BackgroundColor** أمر حاسم عندما يستخدم HTML عناصر شفافة. ضبطه على الأبيض (أو أي `Color` آخر) هو الطريقة الأكثر شيوعًا لـ **set background color image**. + +#### 3️⃣ التصيير والحفظ (render html to png, save html as png) + +```csharp +using (var renderer = new ImageRenderer(htmlDoc, renderingOptions)) +{ + renderer.Render(); + renderer.Save("output/page.png"); +} +``` + +- استدعاء `Render()` يقوم بالعمل الشاق—تخطيط الصفحة، تسلسل CSS، تنفيذ JavaScript (محدود)، والتحويل إلى صورة نقطية. +- `Save()` يكتب البت ماب على القرص بصيغة PNG. يمكنك أيضًا اختيار JPEG أو BMP أو TIFF بتغيير امتداد الملف أو باستخدام `ImageFormat`. + +### التحقق السريع + +بعد تشغيل البرنامج، افتح `output/page.png`. يجب أن ترى لقطة دقيقة لـ `https://example.com` بأبعاد 1024 × 768 بكسل، مع خلفية بيضاء صلبة. إذا ظهرت الصورة غير واضحة، زد الأبعاد أو فعّل DPI أعلى عبر `renderingOptions.DpiX`/`DpiY`. + +![render html to png example](https://via.placeholder.com/1024x768.png?text=Render+HTML+to+PNG "render html to png output") + +*نص بديل: مخرجات render html to png* + +## المشكلات الشائعة & نصائح احترافية + +| المشكلة | لماذا يحدث | الحل / أفضل ممارسة | +|-------|----------------|----------------------| +| **Blank image** | CSS الخاص بالصفحة يخفي المحتوى حتى يتم تشغيل JavaScript. | استخدم `renderer.Render(true)` لتمكين تنفيذ السكريبت، أو عالج الصفحة مسبقًا لتضمين CSS الضروري. | +| **Wrong colors** | الخلفيات الشفافة تظهر باللون الأسود. | اضبط **set background color image** صراحةً (مثلًا `Color.White` أو أي `Color` تحتاجه). | +| **Incorrect size** | العرض/الارتفاع لا يتطابقان مع استعلامات وسائط CSS. | اضبط `renderingOptions.Width`/`Height` *بعد* تحميل الصفحة، أو دع Aspose يكتشف تلقائيًا باستخدام `0`. | +| **Performance bottleneck** | تصيير صفحات كبيرة بشكل متكرر. | أعد استخدام نفس كائن `ImageRenderer` مع كائنات `HTMLDocument` مختلفة، أو فعّل التخزين المؤقت عبر `HtmlLoadOptions`. | +| **Missing fonts** | خطوط الويب المخصصة لم تُحمَّل. | أضف `FontSettings` إلى `HTMLDocument` لتوجيهه إلى مجلد خطوط محلي. | + +**نصيحة احترافية:** عندما تحتاج إلى صورة مصغرة، صِفِّر عند دقة أعلى (مثلاً 1920×1080) ثم قلِّص الحجم باستخدام `System.Drawing`. هذا يحافظ على حدة التفاصيل المتجهية. + +## توسيع المثال + +1. **Batch processing** – كرّر العملية على قائمة من عناوين URL، غيّر اسم ملف الإخراج في كل دورة، وستحصل على مولد صور مصغرة صغير. +2. **Different formats** – استبدل `renderer.Save("output/page.png")` بـ `renderer.Save("output/page.jpg", ImageFormat.Jpeg)` للحصول على ملفات أصغر. +3. **Transparent PNGs** – اضبط `BackgroundColor = Color.Transparent` للحفاظ على قناة ألفا. +4. **Dynamic sizing** – اقرأ `` الخاص بالصفحة واحسب `Width`/`Height` المناسبين وقت التشغيل. + +## الخلاصة + +أصبح لديك الآن وصفة جاهزة للإنتاج **render HTML to PNG** باستخدام Aspose.HTML في C#. يغطي الدليل كل شيء من **convert webpage to image**، عبر **configure image size** و **set background color image**، وصولاً إلى **save HTML as PNG**. + +جرّبه: عدّل الأبعاد، جرّب عنوان URL مختلف، أو احفظ كـ JPEG بدلاً من ذلك. النمط نفسه يعمل مع PDFs، SVGs، أو حتى TIFFs متعددة الصفحات—فقط استبدل فئة الـ renderer. + +إذا واجهت أي صعوبات أو رغبت في استكشاف سيناريوهات متقدمة مثل تنفيذ JavaScript بدون رأس، راجع الوثائق الرسمية لـ 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/net/html-extensions-and-conversions/_index.md b/html/arabic/net/html-extensions-and-conversions/_index.md index 980eb7013..20e2e061e 100644 --- a/html/arabic/net/html-extensions-and-conversions/_index.md +++ b/html/arabic/net/html-extensions-and-conversions/_index.md @@ -41,6 +41,8 @@ url: /ar/net/html-extensions-and-conversions/ قم بتحويل HTML إلى PDF بسهولة باستخدام Aspose.HTML for .NET. اتبع دليلنا خطوة بخطوة واكتشف قوة تحويل HTML إلى PDF. ### [إنشاء PDF من HTML – دليل خطوة بخطوة بلغة C#](./create-pdf-from-html-c-step-by-step-guide/) دليل خطوة بخطوة لإنشاء ملف PDF من HTML باستخدام C# ومكتبة Aspose.HTML. +### [إنشاء PDF من HTML باستخدام Aspose.HTML – دليل خطوة بخطوة](./create-pdf-from-html-with-aspose-html-step-by-step-guide/) +دليل شامل لإنشاء ملف PDF من مستند HTML باستخدام Aspose.HTML خطوة بخطوة. ### [إنشاء مستند HTML بنص منسق وتصديره إلى PDF – دليل كامل](./create-html-document-with-styled-text-and-export-to-pdf-full/) دليل شامل لإنشاء مستند HTML بنص منسق وتصديره إلى PDF باستخدام Aspose.HTML. ### [تحويل EPUB إلى صورة في .NET باستخدام Aspose.HTML](./convert-epub-to-image/) @@ -73,6 +75,10 @@ url: /ar/net/html-extensions-and-conversions/ تعلم كيفية حفظ مستند HTML كملف ZIP باستخدام Aspose.HTML في C# خطوة بخطوة. ### [حفظ HTML إلى ZIP في C# – مثال كامل في الذاكرة](./save-html-to-zip-in-c-complete-in-memory-example/) تعلم كيفية حفظ مستند HTML كملف ZIP في الذاكرة باستخدام C# ومكتبة Aspose.HTML. +### [ملف HTML واحد – حفظ صفحة ويب كملف HTML واحد في C#](./single-file-html-save-a-web-page-as-one-html-file-in-c/) +تعلم كيفية حفظ صفحة ويب كملف HTML واحد باستخدام Aspose.HTML في C#. +### [حفظ HTML كملف ZIP – دليل C# كامل](./save-html-to-zip-in-c-complete-guide/) +تعلم كيفية حفظ مستند HTML كملف ZIP في C# باستخدام Aspose.HTML خطوة بخطوة. ## خاتمة diff --git a/html/arabic/net/html-extensions-and-conversions/create-pdf-from-html-with-aspose-html-step-by-step-guide/_index.md b/html/arabic/net/html-extensions-and-conversions/create-pdf-from-html-with-aspose-html-step-by-step-guide/_index.md new file mode 100644 index 000000000..012fc1b09 --- /dev/null +++ b/html/arabic/net/html-extensions-and-conversions/create-pdf-from-html-with-aspose-html-step-by-step-guide/_index.md @@ -0,0 +1,224 @@ +--- +category: general +date: 2026-02-17 +description: إنشاء ملف PDF من HTML بسرعة باستخدام Aspose.HTML. تعلّم كيفية تحويل HTML + إلى PDF، وتحديد حجم صفحة PDF، وإضافة النمط إلى الوسم head. +draft: false +keywords: +- create pdf from html +- convert html to pdf +- render html as pdf +- set pdf page size +- append style to head +language: ar +og_description: إنشاء PDF من HTML باستخدام Aspose.HTML. يوضح هذا الدليل كيفية تحويل + HTML إلى PDF، وتحديد حجم صفحة PDF، وإضافة نمط إلى الرأس. +og_title: إنشاء PDF من HTML – دليل Aspose.HTML الكامل +tags: +- Aspose.HTML +- C# +- PDF generation +title: إنشاء PDF من HTML باستخدام Aspose.HTML – دليل خطوة بخطوة +url: /ar/net/html-extensions-and-conversions/create-pdf-from-html-with-aspose-html-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# إنشاء PDF من HTML – دليل Aspose.HTML الكامل + +هل احتجت يوماً إلى **إنشاء pdf من html** لكنك لم تكن متأكدًا أي مكتبة ستمنحك تحكمًا دقيقًا في الخطوط، حجم الصفحة، والتنسيق؟ لست وحدك. في هذا الدليل سنستعرض مثالًا واقعيًا **convert html to pdf** باستخدام مكتبة Aspose.HTML لـ .NET، مع توضيح كيفية **set pdf page size** و **append style to head** للخطوط المخصصة. + +سنبدأ بتحميل ملف HTML بسيط، نضيف كتلة CSS صغيرة تستخدم تعداد `WebFontStyle`، نضبط مُعالج PDF، وأخيرًا نكتب الناتج إلى القرص. في النهاية ستحصل على مقتطف جاهز للإنتاج يمكنك إدراجه في أي مشروع C# console أو ASP.NET. + +> **ما ستحصل عليه:** برنامج قابل للتنفيذ يحول `input.html` إلى `output.pdf`، بنص Arial غامق ومائل وصفحة بحجم A4، كل ذلك دون الحاجة إلى ملفات CSS خارجية. + +## المتطلبات المسبقة + +- .NET 6.0 (أو أي نسخة حديثة من .NET) مثبتة على جهازك. +- رخصة صالحة لـ Aspose.HTML for .NET (أو نسخة تجريبية مجانية). +- إلمام أساسي بـ C# و Visual Studio (أو أي بيئة تطوير تفضلها). + +لا توجد مكتبات طرف ثالث أخرى مطلوبة؛ فـ Aspose.HTML يتضمن كل ما تحتاجه للعرض. + +--- + +## إنشاء PDF من HTML – الخطوات الأساسية + +فيما يلي **دليل خطوة بخطوة**. يشرح كل قسم *لماذا* نقوم بشيء ما، وليس فقط *ما* هو شكل الكود. + +### الخطوة 1: تحميل مستند HTML (Convert HTML to PDF) + +أولاً نحتاج إلى إخبار Aspose.HTML بمكان ملف المصدر. تقوم فئة `HTMLDocument` بتحليل العلامات وبناء DOM يمكن للمُعالج استهلاكه لاحقًا. + +```csharp +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +// Load the HTML file from disk +HTMLDocument htmlDoc = new HTMLDocument("YOUR_DIRECTORY/input.html"); + +// Quick sanity check – make sure the document actually loaded +if (htmlDoc == null) +{ + throw new InvalidOperationException("Failed to load the HTML file. Check the path and permissions."); +} +``` + +**لماذا هذا مهم:** تحميل HTML هو الأساس لأي سير عمل **render html as pdf**. إذا تعذر قراءة الملف، سيتوقف المسار بالكامل وستحصل على PDF فارغ. + +### الخطوة 2: إضافة نمط إلى الـ Head – CSS مخصص باستخدام WebFontStyle + +بدلاً من ربط ورقة أنماط خارجية، نقوم بحقن عنصر `