Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 7 additions & 1 deletion html/arabic/net/html-extensions-and-conversions/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,10 @@ url: /ar/net/html-extensions-and-conversions/
## دروس حول امتدادات HTML وتحويلاتها
### [تحويل HTML إلى PDF في .NET باستخدام Aspose.HTML](./convert-html-to-pdf/)
قم بتحويل 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.
### [إنشاء مستند 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/)
تعرف على كيفية تحويل EPUB إلى صور باستخدام Aspose.HTML لـ .NET. برنامج تعليمي خطوة بخطوة مع أمثلة التعليمات البرمجية والخيارات القابلة للتخصيص.
### [تحويل EPUB إلى PDF في .NET باستخدام Aspose.HTML](./convert-epub-to-pdf/)
Expand All @@ -63,6 +67,8 @@ url: /ar/net/html-extensions-and-conversions/
تعرف على كيفية تحويل HTML إلى TIFF باستخدام Aspose.HTML لـ .NET. اتبع دليلنا خطوة بخطوة لتحسين محتوى الويب بكفاءة.
### [تحويل HTML إلى XPS في .NET باستخدام Aspose.HTML](./convert-html-to-xps/)
اكتشف قوة Aspose.HTML لـ .NET: تحويل HTML إلى XPS بسهولة. المتطلبات الأساسية، ودليل خطوة بخطوة، والأسئلة الشائعة متضمنة.
### [كيفية ضغط HTML في C# – حفظ HTML إلى ملف Zip](./how-to-zip-html-in-c-save-html-to-zip/)
تعلم كيفية ضغط ملفات HTML وحفظها كملف Zip باستخدام C# ومكتبة Aspose.HTML.

## خاتمة

Expand All @@ -74,4 +80,4 @@ url: /ar/net/html-extensions-and-conversions/
{{< /blocks/products/pf/main-container >}}
{{< /blocks/products/pf/main-wrap-class >}}

{{< blocks/products/products-backtop-button >}}
{{< blocks/products/products-backtop-button >}}
Original file line number Diff line number Diff line change
@@ -0,0 +1,193 @@
---
category: general
date: 2025-12-29
description: إنشاء مستند HTML في C# وتعلم كيفية تعيين عائلة الخط، وتعيين حجم الخط،
ثم حفظ HTML كملف PDF أو تحويل HTML إلى PDF باستخدام Aspose.HTML.
draft: false
keywords:
- create html document
- set font family
- set font size
- save html as pdf
- convert html to pdf
language: ar
og_description: إنشاء مستند HTML في C# ورؤية كيفية تعيين عائلة الخط، وتعيين حجم الخط
على الفور، ثم حفظ HTML كملف PDF أو تحويل HTML إلى PDF باستخدام Aspose.HTML.
og_title: إنشاء مستند HTML – نص منسق وتصدير PDF
tags:
- aspnet
- csharp
- pdf-generation
title: إنشاء مستند HTML بنص منسق وتصديره إلى PDF – دليل كامل
url: /ar/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/
---

{{< blocks/products/pf/main-wrap-class >}}
{{< blocks/products/pf/main-container >}}
{{< blocks/products/pf/tutorial-page-section >}}

# إنشاء مستند HTML بنص منسق وتصديره إلى PDF

هل احتجت يومًا إلى **إنشاء مستند HTML** في الوقت الفعلي وتحويله إلى PDF دون مغادرة كود C# الخاص بك؟ ربما تقوم ببناء محرك تقارير، مولد فواتير، أو مجرد معاينة سريعة للمستخدمين. الخبر السار هو أنك تستطيع فعل ذلك ببضع أسطر باستخدام Aspose.HTML، وستحصل على تحكم كامل في عائلة الخط، حجم الخط، وحتى تنسيق الخط العريض‑المائل.

في هذا الدرس سنستعرض العملية بالكامل — من إنشاء مستند HTML في الذاكرة إلى حفظه كملف PDF. بنهاية الدرس ستعرف بالضبط كيف **تحدد عائلة الخط**، **تحدد حجم الخط**، و**تحفظ HTML كـ PDF** (المعروف أيضًا بـ **تحويل HTML إلى PDF**) مع مثال كود نظيف وجاهز للإنتاج.

## ما الذي ستحتاجه

- .NET 6+ (تعمل الواجهة البرمجية مع .NET Core و .NET Framework على حد سواء)
- حزمة NuGet Aspose.HTML for .NET (`Aspose.Html`) — تثبيت عبر `dotnet add package Aspose.Html`
- مجلد على القرص حيث يمكن كتابة ملف PDF المُولد

بدون قوالب HTML إضافية، بدون محولات خارجية، فقط C# صافية.

![create html document illustration](/images/create-html-document.png){alt="مثال إنشاء مستند HTML"}

## الخطوة 1: إنشاء مستند HTML

أولاً، نحتاج إلى كائن مستند HTML فارغ. فكر فيه كقماش جديد ستحكم عليه لاحقًا بفقرة منسقة.

```csharp
using Aspose.Html;
using Aspose.Html.Drawing;
using Aspose.Html.Saving;

// Step 1 – initialize a new HTML document in memory
HTMLDocument htmlDocument = new HTMLDocument();

// Grab a reference to the <body> element for later use
HTMLBodyElement body = htmlDocument.Body;
```

**لماذا هذا مهم:** `HTMLDocument` يمنحك بنية شبيهة بـ DOM يمكنك تعديلها برمجيًا. لا حاجة للتعامل مع سلاسل نصية خام أو عمليات I/O للملفات حتى النهاية.

## الخطوة 2: إضافة فقرة وتحديد عائلة الخط وحجم الخط

الآن سننشئ عنصر `<p>`، ندرج بعض النص، ونحدد صراحةً عائلة الخط والحجم. هنا يأتي دور كلمات المفتاح **set font family** و **set font size**.

```csharp
// Step 2 – create a <p> element with some sample text
HtmlElement paragraph = htmlDocument.CreateElement("p");
paragraph.InnerHtml = "Bold & Italic text";

// Define the base font style
paragraph.Style.FontFamily = "Arial"; // set font family
paragraph.Style.FontSize = "18px"; // set font size

// Attach the paragraph to the document body
body.AppendChild(paragraph);
```

**نصيحة احترافية:** إذا كنت بحاجة إلى بديل آمن للويب، يمكنك توفير قائمة مفصولة بفواصل مثل `"Arial, Helvetica, sans-serif"`؛ المتصفح (أو Aspose) سيختار أول خط متاح.

## الخطوة 3: تطبيق تنسيق عريض ومائل باستخدام علامات WebFontStyle

تقدم Aspose.HTML تعدادًا مفيدًا `WebFontStyle` يتيح لك دمج الأنماط باستخدام OR بتري. لنجعل النص عريضًا **ومائلًا** في آنٍ واحد.

```csharp
// Step 3 – apply bold and italic using WebFontStyle flags
paragraph.Style.FontStyle = WebFontStyle.Bold | WebFontStyle.Italic;
```

**ما الذي يحدث خلف الكواليس؟** خاصية `FontStyle` تُترجم إلى إعلانات CSS `font-weight` و `font-style`. عبر دمج العلامات نتجنب كتابة سطرين منفصلين من CSS.

## الخطوة 4: تحويل HTML إلى PDF (حفظ HTML كـ PDF)

الخطوة الأخيرة هي التحويل الفعلي. باستدعاء واحد لـ `Save`، تقوم Aspose.HTML برندر الـ DOM وتكتب ملف PDF إلى القرص. هذا يلبي متطلبات **save html as pdf** و **convert html to pdf**.

```csharp
// Step 4 – save the HTML document as a PDF file
string outputPath = @"C:\Temp\styled.pdf";
htmlDocument.Save(outputPath, new PDFSaveOptions());

// Optional: open the PDF automatically (Windows only)
System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo
{
FileName = outputPath,
UseShellExecute = true
});
```

**النتيجة المتوقعة:** افتح `styled.pdf` وسترى فقرة واحدة تحتوي على النص “Bold & Italic text” بحجم 18‑px خط Arial، مُظهرًا بخط عريض ومائل. أبعاد PDF تتطابق مع صفحة A4 قياسية، والنص قابل للتحديد — بفضل الرندر المتجه.

## مثال كامل يعمل

بتجميع كل شيء معًا، إليك البرنامج الكامل الجاهز للتنفيذ:

```csharp
using System;
using Aspose.Html;
using Aspose.Html.Drawing;
using Aspose.Html.Saving;

class Program
{
static void Main()
{
// 1️⃣ Create a new HTML document
HTMLDocument htmlDocument = new HTMLDocument();
HTMLBodyElement body = htmlDocument.Body;

// 2️⃣ Add a styled paragraph
HtmlElement paragraph = htmlDocument.CreateElement("p");
paragraph.InnerHtml = "Bold & Italic text";

// Set font family and size
paragraph.Style.FontFamily = "Arial";
paragraph.Style.FontSize = "18px";

// 3️⃣ Apply bold + italic
paragraph.Style.FontStyle = WebFontStyle.Bold | WebFontStyle.Italic;

// Append to body
body.AppendChild(paragraph);

// 4️⃣ Save as PDF (convert HTML to PDF)
string outputFile = @"C:\Temp\styled.pdf";
htmlDocument.Save(outputFile, new PDFSaveOptions());

Console.WriteLine($"PDF generated at: {outputFile}");
}
}
```

### تشغيل الكود

1. تثبيت حزمة NuGet Aspose.HTML:
```bash
dotnet add package Aspose.Html
```
2. استبدل `C:\Temp\styled.pdf` بمسار مجلد لديك صلاحية كتابة فيه.
3. ابنِ وشغّل: `dotnet run`.

ستظهر لك رسالة في وحدة التحكم تؤكد موقع الملف، وسيحتوي PDF على الفقرة المنسقة.

## أسئلة شائعة وحالات خاصة

- **ماذا لو احتجت إلى خط ويب مخصص؟**
حمّل الخط باستخدام `HTMLFontFaceRule` أو أشر إلى ملف CSS `@font-face` بعيد قبل إنشاء الفقرة.

- **هل يمكن إضافة صور قبل التحويل؟**
بالتأكيد. استخدم `HTMLImageElement img = (HTMLImageElement)htmlDocument.CreateElement("img");` واضبط `img.Source` إلى مسار محلي أو URI بيانات.

- **ماذا عن ملفات PDF متعددة الصفحات؟**
أضف المزيد من العناصر (جداول، divs، إلخ) وستقوم Aspose.HTML تلقائيًا بعملية التقسيم عندما يتجاوز المحتوى ارتفاع الصفحة.

- **هل هناك طريقة للتحكم ببيانات تعريف PDF؟**
مرّر كائن `PdfSaveOptions` واضبط خصائص مثل `Author`، `Title`، أو `PdfAConformanceLevel`.

## ملخص

غطّينا كيفية **إنشاء مستند HTML** في C#، **تحديد عائلة الخط**، **تحديد حجم الخط**، تطبيق تنسيقات عريض‑مائل، وأخيرًا **حفظ HTML كـ PDF** — أي **تحويل HTML إلى PDF** باستخدام Aspose.HTML. الشيفرة مختصرة بما يكفي لتدرجها في أي مشروع .NET، لكنها كاملة بما يكفي لتكون أساسًاًا لسيناريوهات تقارير أكثر تعقيدًا.

## الخطوات التالية

- جرّب استخدام فئات CSS لتنسيق قابل لإعادة الاستخدام.
- اجمع فقرات متعددة، جداول، وصور لبناء PDFs أغنى.
- استكشف توافق PDF/A إذا كنت تحتاج إلى مستندات أرشيفية.

لا تتردد في تعديل الخط، الحجم، أو الألوان — لا حدود لما يمكنك توليده برمجيًا. برمجة سعيدة، ولتظهر ملفات PDF دائمًا كما تصورتها!

{{< /blocks/products/pf/tutorial-page-section >}}
{{< /blocks/products/pf/main-container >}}
{{< /blocks/products/pf/main-wrap-class >}}
{{< blocks/products/products-backtop-button >}}
Loading