diff --git a/html/arabic/python/general/convert-html-to-markdown-complete-guide-with-image-embedding/_index.md b/html/arabic/python/general/convert-html-to-markdown-complete-guide-with-image-embedding/_index.md new file mode 100644 index 000000000..d6cf44657 --- /dev/null +++ b/html/arabic/python/general/convert-html-to-markdown-complete-guide-with-image-embedding/_index.md @@ -0,0 +1,205 @@ +--- +category: general +date: 2026-06-19 +description: حوّل HTML إلى markdown بسهولة وتعلم كيفية تضمين الصور في markdown باستخدام + Python. اتبع هذا الدليل خطوة بخطوة للحصول على تحويل خالٍ من الأخطاء. +draft: false +keywords: +- convert html to markdown +- how to embed images in markdown +language: ar +og_description: حوّل HTML إلى markdown بسرعة. يوضح هذا الدليل كيفية تضمين الصور في + markdown خطوة بخطوة، مع كود Python كامل. +og_title: تحويل HTML إلى Markdown – دليل كامل مع تضمين الصور +schemas: +- author: Aspose + dateModified: '2026-06-19' + description: Convert HTML to markdown easily and learn how to embed images in markdown + using Python. Follow this step‑by‑step tutorial for flawless conversion. + headline: Convert HTML to Markdown – Complete Guide with Image Embedding + type: TechArticle +tags: +- html +- markdown +- python +- conversion +title: تحويل HTML إلى Markdown – دليل شامل مع تضمين الصور +url: /ar/python/general/convert-html-to-markdown-complete-guide-with-image-embedding/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# تحويل HTML إلى Markdown – دليل كامل مع تضمين الصور + +هل تساءلت يومًا **كيف تحوّل HTML إلى markdown** دون فقدان أي من تلك الصور المدمجة الثمينة؟ لست الوحيد. سواء كنت تستخرج المحتوى من نظام إدارة محتوى قديم أو تقوم بجمع مدونة للقراءة دون اتصال، فإن تحويل HTML إلى markdown نظيف هو مهمة شائعة قد تشعر بأنها دقيقة بعض الشيء—خصوصًا عندما تكون الصور متضمنة. + +الأمر هو: يمكنك إجراء التحويل في خطوة واحدة *و* تضمين كل صورة كـ Base64 data‑URI، بحيث يصبح ملف markdown الناتج مكتملًا ذاتيًا. في هذا الدرس سنستعرض ذلك بالضبط، باستخدام مكتبة Aspose.Words للغة Python. في النهاية ستحصل على سكريبت جاهز للتنفيذ **يحوّل HTML إلى markdown** ويظهر **كيفية تضمين الصور في markdown** دون أي مشاكل. + +## ما ستحتاجه + +- **Python 3.8+** (الكود يعمل مع أي نسخة حديثة) +- **Aspose.Words for Python via .NET** – يمكنك الحصول عليها من PyPI باستخدام `pip install aspose-words` +- نسخة محلية من ملف HTML الذي تريد تحويله (مثال: `webpage.html`) +- مساحة تخزين معتدلة للملف markdown الناتج + +هذا كل شيء—لا أدوات إضافية، ولا حيل سطر أوامر معقدة. جاهز؟ لنبدأ. + +![لقطة شاشة لملف markdown تم إنشاؤه من HTML، توضح الصور المضمنة](convert-html-to-markdown.png "مثال تحويل html إلى markdown") + +## الخطوة 1: تحميل مستند HTML المصدر + +أول شيء عليك فعله هو إعطاء المحول شيء ليعمل عليه. في مصطلحات Aspose.Words، هذا يعني إنشاء كائن `HTMLDocument` يشير إلى ملف المصدر الخاص بك. + +```python +from aspose.words import HTMLDocument + +# Load the HTML file from disk +html_path = "YOUR_DIRECTORY/webpage.html" +html_doc = HTMLDocument(html_path) +``` + +*لماذا هذا مهم:* فئة `HTMLDocument` تقوم بتحليل HTML، وتبني نموذج مستند داخلي، وتحافظ على جميع معلومات التنسيق. فكر فيها كجسر بين العلامات الخام والكائنات ذات المستوى الأعلى التي ستتعامل معها لاحقًا. + +## الخطوة 2: إعداد خيارات حفظ Markdown + +بعد ذلك تحتاج إلى إخبار Aspose.Words أنك تريد المخرجات بصيغة markdown. يتم ذلك عبر فئة `MarkdownSaveOptions`. + +```python +from aspose.words import MarkdownSaveOptions + +md_options = MarkdownSaveOptions() +``` + +في هذه المرحلة يكون كائن الخيارات بسيطًا جدًا—مجرد حاوية تنتظر منك تحديد كيفية معالجة الموارد مثل الصور. + +## الخطوة 3: تكوين معالجة الموارد – **كيفية تضمين الصور في Markdown** + +هنا يحدث السحر. بشكل افتراضي، تقوم Aspose.Words بكتابة مراجع الصور كملفات منفصلة وربطها. لتضمين الصور مباشرةً في markdown، تقوم بتمكين علم `embed_resources` داخل كائن `ResourceHandlingOptions` وتربطه بخيارات markdown. + +```python +from aspose.words import ResourceHandlingOptions + +# Create a resource handling configuration +resource_opts = ResourceHandlingOptions() +resource_opts.embed_resources = True # Turn on Base64 embedding + +# Attach the resource options to the markdown save options +md_options.resource_handling_options = resource_opts +``` + +*لماذا قد ترغب في ذلك:* تضمين الصور كـ Base64 data‑URIs يجعل ملف markdown قابلًا للنقل بالكامل—لا حاجة لإرسال مجلد يحتوي على ملفات الصور. هذا مفيد بشكل خاص لملفات README على GitHub أو للملاحظات التي تزامنها عبر الأجهزة. + +### نصيحة سريعة + +إذا كنت تتعامل مع صور كبيرة جدًا (مثل لقطات شاشة تزيد عن 2 ميغابايت)، فكر في تغيير حجمها قبل التحويل. تشفير Base64 يزيد الحجم بحوالي 33 %، لذا قد ينتقل ملف PNG بحجم 3 ميغابايت إلى 4 ميغابايت في ملف markdown. يمكن لسكريبت بسيط باستخدام Pillow تصغيرها دون فقدان ملحوظ في الجودة. + +## الخطوة 4: تنفيذ التحويل وحفظ النتيجة + +الآن بعد أن تم ربط كل شيء، ما عليك سوى استدعاء الطريقة الساكنة `convert_html` في فئة `Converter`، مع تمرير مستند المصدر، الخيارات المكوّنة، ومسار الوجهة. + +```python +from aspose.words import Converter + +# Destination markdown file +md_path = "YOUR_DIRECTORY/webpage.md" + +# Execute the conversion +Converter.convert_html(html_doc, md_options, md_path) + +print(f"Conversion complete! Markdown saved to: {md_path}") +``` + +عند انتهاء السكريبت، افتح `webpage.md` في أي عارض markdown. يجب أن ترى محتوى HTML الأصلي معروضًا كـ markdown، مع استبدال كل وسم `` بسطر `![alt text](data:image/png;base64,…)`. لا ملفات صور خارجية، ولا روابط مكسورة. + +## الخطوة 5: التحقق من النتيجة (اختياري لكن موصى به) + +من الأفضل دائمًا التحقق من أن التحويل تم كما هو متوقع. يمكن إجراء فحص سريع باستخدام حزمة Python `markdown`، التي تحول markdown إلى HTML—مما يتيح لك مقارنة النتيجة بالصفحة الأصلية. + +```python +import markdown + +with open(md_path, "r", encoding="utf-8") as f: + md_content = f.read() + +# Render back to HTML for visual comparison +rendered_html = markdown.markdown(md_content, extensions=["extra"]) + +# Write the rendered HTML to a temporary file +with open("temp_rendered.html", "w", encoding="utf-8") as f: + f.write(rendered_html) + +print("Rendered HTML saved to temp_rendered.html for quick visual diff.") +``` + +افتح `temp_rendered.html` في المتصفح وتفقد بعض الأقسام يدويًا. إذا كان كل شيء متطابقًا، فقد نجحت في **تحويل HTML إلى markdown** وتقن **كيفية تضمين الصور في markdown**. + +## الأخطاء الشائعة وكيفية تجنبها + +| المشكلة | سبب حدوثه | الحل | +|-------|----------------|-----| +| الصور تظهر كروابط مكسورة | `embed_resources` left `False` | Ensure `resource_opts.embed_resources = True` | +| ملف markdown كبير | صور أصلية كبيرة | Pre‑process images with Pillow or limit embedding to specific formats | +| غياب تنسيق CSS | Markdown لا يدعم CSS | Use inline styling in markdown (e.g., HTML ``) if you need exact visual fidelity | +| حروف غير ASCII تتشوه | ترميز الملف غير صحيح | Open files with `encoding="utf-8"` and add `md_options.encoding = "utf-8"` if needed | + +## نصيحة احترافية: التضمين الانتقائي + +إذا كنت تريد فقط تضمين *بعض* الصور (مثل الشعارات) مع إبقاء الصور الكبيرة كملفات خارجية، يمكنك ربط حدث `ResourceSavingCallback` المقدم من Aspose.Words. يسمح لك الـ callback بفحص حجم كل صورة وتحديد في الوقت الفعلي ما إذا كنت تريد تضمينه. أدناه مثال مختصر: + +```python +from aspose.words import IResourceSavingCallback, ResourceSavingInfo + +class SelectiveEmbedCallback(IResourceSavingCallback): + def resource_saving(self, args: ResourceSavingInfo): + # Embed only if the image is smaller than 100 KB + if args.resource_bytes and len(args.resource_bytes) < 100 * 1024: + args.embed_resource = True + else: + args.embed_resource = False + +md_options.resource_saving_callback = SelectiveEmbedCallback() +``` + +الآن ستحصل على أفضل ما في العالمين: الأيقونات الصغيرة تبقى مدمجة، بينما الصور الكبيرة تظل خارجية. + +## ملخص: ما تم تغطيته + +- **تحميل** ملف HTML باستخدام `HTMLDocument` +- **تكوين** `MarkdownSaveOptions` لإخراج markdown +- **تمكين** تضمين الصور بصيغة Base64 عبر `ResourceHandlingOptions` (الإجابة الأساسية على *كيفية تضمين الصور في markdown*) +- **تشغيل** التحويل باستخدام `Converter.convert_html` +- **التحقق** من النتيجة ومعالجة الحالات الخاصة + +باختصار، لديك الآن حل قوي بملف واحد **يحوّل HTML إلى markdown** مع الاعتناء بتضمين الصور تلقائيًا. + +## الخطوات التالية والمواضيع ذات الصلة + +إذا وجدت هذا الدليل مفيدًا، قد ترغب أيضًا في استكشاف: + +- **تحويل دفعي** – تكرار عبر مجلد من ملفات HTML وإنتاج مجموعة مطابقة من مستندات markdown. +- **امتدادات markdown مخصصة** – إضافة دعم للجداول، الحواشي، أو قوائم المهام عن طريق تعديل `MarkdownSaveOptions`. +- **التكامل مع مولدات المواقع الثابتة** – توجيه markdown المُنتج مباشرة إلى Jekyll أو Hugo أو MkDocs للنشر الآلي. +- **معالجة موارد متقدمة** – استخدم `ResourceSavingCallback` لإعادة تسمية الأصول الخارجية أو تخزينها في CDN. + +كل من هذه المواضيع يبني على الأساس الذي وضعناه هنا، مما يمنحك سيطرة أكبر على سير عمل **تحويل html إلى markdown**. + +--- + +لا تتردد في التجربة—استبدل مصدر HTML، جرّب حدود تضمين مختلفة، أو حتى استبدل مكتبة Aspose بمحول آخر إذا كنت تشعر بالمغامرة. الفكرة الأساسية هي أن تضمين الصور مباشرةً في markdown سهل بمجرد معرفة الخيارات الصحيحة، ويمكن إكمال عملية التحويل بالكامل ببضع أسطر من Python. + +برمجة سعيدة، ولتظل ملفات markdown الخاصة بك دائمًا مرتبة ومكتملة ذاتيًا! + +## ماذا يجب أن تتعلم بعد ذلك؟ + +الدروس التالية تغطي مواضيع ذات صلة وثيقة تبني على التقنيات الموضحة في هذا الدليل. كل مورد يتضمن أمثلة شفرة كاملة مع شروحات خطوة بخطوة لمساعدتك على إتقان ميزات API إضافية واستكشاف أساليب تنفيذ بديلة في مشاريعك. + +- [تحويل HTML إلى Markdown في Aspose.HTML للغة Java](/html/english/java/saving-html-documents/convert-html-to-markdown/) +- [تحويل HTML إلى Markdown في .NET باستخدام Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-markdown/) +- [Markdown إلى HTML Java - التحويل باستخدام Aspose.HTML](/html/english/java/conversion-html-to-other-formats/convert-markdown-to-html/) + +{{< /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/python/general/convert-html-to-pdf-in-python-complete-step-by-step-guide/_index.md b/html/arabic/python/general/convert-html-to-pdf-in-python-complete-step-by-step-guide/_index.md new file mode 100644 index 000000000..e025b96ad --- /dev/null +++ b/html/arabic/python/general/convert-html-to-pdf-in-python-complete-step-by-step-guide/_index.md @@ -0,0 +1,281 @@ +--- +category: general +date: 2026-06-19 +description: تحويل HTML إلى PDF في بايثون باستخدام سكريبت بسيط – تعلم كيفية حفظ مستند + HTML كملف PDF وإنشاء PDF من ملف HTML بسرعة. +draft: false +keywords: +- convert html to pdf +- save html document as pdf +- create pdf from html file +- convert html document to pdf +- how to convert html to pdf in python +language: ar +og_description: تحويل HTML إلى PDF في بايثون مع مثال واضح وقابل للتنفيذ. تعلم كيفية + حفظ مستند HTML كملف PDF وإنشاء PDF من ملف HTML. +og_title: تحويل HTML إلى PDF في بايثون – دليل كامل +schemas: +- author: Aspose + dateModified: '2026-06-19' + description: Convert HTML to PDF in Python with a simple script – learn how to save + HTML document as PDF and create PDF from HTML file quickly. + headline: Convert HTML to PDF in Python – Complete Step‑by‑Step Guide + type: TechArticle +- description: Convert HTML to PDF in Python with a simple script – learn how to save + HTML document as PDF and create PDF from HTML file quickly. + name: Convert HTML to PDF in Python – Complete Step‑by‑Step Guide + steps: + - name: Adding a Simple Footer (Bonus) + text: If you need a quick footer on every page—say, a page number or a company + name—you can inject it right after conversion without re‑parsing the original + HTML. + - name: What if the HTML contains relative image paths? + text: Aspose.PDF resolves relative URLs based on the location of the HTML file. + Make sure any images are in the same directory (or a sub‑folder) as `invoice.html`. + If they’re hosted online, use absolute URLs. + - name: Can I convert a string of HTML instead of a file? + text: Absolutely. Use `HTMLDocument.from_string(your_html_string)` instead of + loading from a file path. The rest of the workflow stays identical. + - name: How does this differ from `pdfkit` or `WeasyPrint`? + text: All three libraries can **convert HTML document to PDF**, but Aspose.PDF + offers tighter .NET integration, better handling of complex CSS, and built‑in + PDF manipulation (adding watermarks, merging, etc.) without extra dependencies. + - name: Is the library free for commercial use? + text: Aspose provides a temporary evaluation license (30 days). For production + you’ll need a purchased license, but the API usage remains the same. + - name: What’s Next? + text: '- **Style your PDFs**: experiment with `PdfSaveOptions` to embed CSS, set + margins, or enable PDF/A compliance. - **Explore other libraries**: `pdfkit` + (wkhtmltopdf wrapper) or `WeasyPrint` for open‑source alternatives. - **Automate + batch conversions**: read a directory of `.html` files and output a ' + type: HowTo +tags: +- python +- pdf-generation +- html-conversion +title: تحويل HTML إلى PDF في بايثون – دليل شامل خطوة بخطوة +url: /ar/python/general/convert-html-to-pdf-in-python-complete-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# تحويل HTML إلى PDF في بايثون – دليل شامل خطوة بخطوة + +هل تساءلت يومًا كيف **تحويل HTML إلى PDF** في بايثون دون التعامل مع أدوات سطر الأوامر أو العبث بـ phantomjs؟ لست وحدك. يحتاج العديد من المطورين إلى **حفظ مستند HTML كملف PDF** للفواتير، التقارير، أو الكتب الإلكترونية، ويرغبون في حل يعمل مباشرةً. + +في هذا البرنامج التعليمي سنستعرض سكريبت عملي من البداية إلى النهاية **ينشئ PDF من ملف HTML** باستخدام Aspose.PDF للبايثون. في النهاية ستعرف بالضبط **كيفية تحويل HTML إلى PDF في بايثون**، وسترى الشيفرة الكاملة، وتفهم “السبب” وراء كل سطر. + +## ما ستتعلمه + +- تثبيت مكتبة Aspose.PDF واعتمادياتها +- تحميل ملف HTML وتحضير خيارات حفظ PDF +- تنفيذ التحويل ومعالجة المشكلات الشائعة +- التحقق من النتيجة واستكشاف بعض التخصيصات السريعة + +لا يلزم أي خبرة سابقة مع مكتبات PDF — فقط إعداد بايثون أساسي وملف HTML ترغب في تحويله إلى PDF. + +--- + +## الخطوة 1: تثبيت Aspose.PDF واستيراد الفئات المطلوبة + +قبل أن نتمكن من **تحويل مستند HTML إلى PDF**، نحتاج إلى الأدوات المناسبة. Aspose.PDF للبايثون عبر .NET هي مكتبة تجارية، لكنها توفر طبقة مجانية سخية للمشاريع الصغيرة وتعمل على Windows و macOS و Linux. + +```bash +# Install the library via pip +pip install aspose-pdf +``` + +بمجرد أن تكون الحزمة على جهازك، استورد الفئات التي ستستخدمها: + +```python +# Import Aspose.PDF classes +from aspose.pdf import HTMLDocument, PdfSaveOptions, Converter +``` + +> **نصيحة احترافية:** إذا كنت تعمل داخل حاوية Linux، قد تحتاج أيضًا إلى `libgdiplus` لدعم GDI+. قم بتثبيته باستخدام `apt-get install -y libgdiplus` قبل تشغيل السكريبت. + +## الخطوة 2: تحميل مستند HTML المصدر + +الآن بعد أن أصبحت المكتبة جاهزة، سنقوم **بحفظ مستند HTML كملف PDF** عن طريق تحميل ملف HTML أولاً إلى كائن `HTMLDocument`. هذا الكائن يحلل العلامات ويحافظ على الموارد (الصور، CSS) في الذاكرة. + +```python +# Step 2: Load the source HTML document +html_path = "YOUR_DIRECTORY/invoice.html" # ← replace with your actual path +html_doc = HTMLDocument(html_path) +``` + +> **لماذا هذا مهم:** تحميل HTML مسبقًا يمنحنا الفرصة لتفحص الـ DOM، واكتشاف الموارد المفقودة، أو تعديل الترميز قبل بدء التحويل. + +## الخطوة 3: إنشاء خيارات حفظ PDF (اختياري لكن مفيد) + +الإعدادات الافتراضية `PdfSaveOptions` تعمل جيدًا للتحويل الأساسي، لكن يمكنك تعديلها للتحكم في حجم الصفحة، الضغط، أو ما إذا كانت الروابط القابلة للنقر تظل كذلك. إليك إعدادًا بسيطًا لا يزال يترك لك مساحة للتوسيع لاحقًا: + +```python +# Step 3: Create PDF save options (default options are sufficient for a basic conversion) +pdf_options = PdfSaveOptions() +# Example tweak – force A4 page size +pdf_options.page_size = pdf_options.page_size.a4 +# Example tweak – embed all fonts (helps with cross‑platform rendering) +pdf_options.embed_full_fonts = True +``` + +> **حالة خاصة:** إذا كان HTML الخاص بك يشير إلى خطوط خارجية عبر `@font-face`، تأكد من أن تلك الخطوط متاحة على الجهاز الذي يشغل السكريبت؛ وإلا قد يعود الـ PDF إلى الخط الافتراضي. + +## الخطوة 4: تنفيذ التحويل وحفظ PDF + +هذه هي جوهر البرنامج التعليمي: السطر الواحد الذي **ينشئ PDF من ملف HTML**. طريقة `Converter.convert_html` تأخذ المستند المحمل، الخيارات التي عرفناها للتو، ومسار الملف الهدف. + +```python +# Step 4: Convert the HTML to PDF and save the result +pdf_path = "YOUR_DIRECTORY/invoice.pdf" # ← where you want the PDF saved +Converter.convert_html(html_doc, pdf_options, pdf_path) +print(f"✅ PDF successfully created at: {pdf_path}") +``` + +إذا سارت الأمور بسلاسة، سترى رسالة التأكيد وملف `invoice.pdf` الجديد بجوار ملف HTML الخاص بك. + +## الخطوة 5: التحقق من الناتج وإضافة تخصيص سريع + +بعد التحويل، من العادة الجيدة فتح الـ PDF برمجيًا والتأكد من أنه تم إنشاء صفحة واحدة على الأقل. هذا أيضًا يوضح **كيفية تحويل HTML إلى PDF في بايثون** مع التحقق من الأخطاء. + +```python +# Step 5: Verify the conversion (optional) +from aspose.pdf import Document + +try: + pdf_doc = Document(pdf_path) + page_count = pdf_doc.pages.count + print(f"📄 PDF contains {page_count} page(s).") +except Exception as e: + print(f"❌ Something went wrong while opening the PDF: {e}") +``` + +### إضافة تذييل بسيط (مكافأة) + +إذا كنت بحاجة إلى تذييل سريع على كل صفحة — مثل رقم الصفحة أو اسم الشركة — يمكنك إدراجه مباشرةً بعد التحويل دون إعادة تحليل HTML الأصلي. + +```python +# Bonus: Add a footer to each page +for page in pdf_doc.pages: + footer = page.paragraphs.add() + footer.text = "© 2026 MyCompany – Confidential" + footer.text_state.font_size = 9 + footer.text_state.font = "Helvetica" + footer.text_state.font_style = "Italic" +pdf_doc.save(pdf_path) # Overwrite with the footer added +print("🖋 Footer added to all pages.") +``` + +--- + +## أسئلة شائعة ومشكلات محتملة + +### ماذا لو كان HTML يحتوي على مسارات صور نسبية؟ + +Aspose.PDF يحل عناوين URL النسبية بناءً على موقع ملف HTML. تأكد من أن جميع الصور موجودة في نفس الدليل (أو مجلد فرعي) كملف `invoice.html`. إذا كانت مستضافة على الإنترنت، استخدم عناوين URL المطلقة. + +### هل يمكنني تحويل سلسلة HTML بدلاً من ملف؟ + +بالطبع. استخدم `HTMLDocument.from_string(your_html_string)` بدلاً من التحميل من مسار ملف. بقية سير العمل يبقى متطابقًا. + +### كيف يختلف هذا عن `pdfkit` أو `WeasyPrint`؟ + +جميع المكتبات الثلاث يمكنها **تحويل مستند HTML إلى PDF**، لكن Aspose.PDF توفر تكاملًا أقوى مع .NET، معالجة أفضل للـ CSS المعقد، وت manipulation مدمج للـ PDF (إضافة علامات مائية، دمج، إلخ) دون تبعيات إضافية. + +### هل المكتبة مجانية للاستخدام التجاري؟ + +توفر Aspose ترخيص تقييم مؤقت (30 يومًا). للإنتاج ستحتاج إلى ترخيص مدفوع، لكن استخدام الـ API يبقى نفسه. + +--- + +## السكريبت الكامل العامل (جاهز للنسخ واللصق) + +```python +# convert_html_to_pdf.py +# ------------------------------------------------- +# Complete example: convert HTML to PDF in Python +# ------------------------------------------------- + +# 1️⃣ Install the library first: +# pip install aspose-pdf + +from aspose.pdf import HTMLDocument, PdfSaveOptions, Converter, Document + +def convert_html_to_pdf(html_path: str, pdf_path: str): + """ + Loads an HTML file, converts it to PDF, and saves the result. + Returns the number of pages in the generated PDF. + """ + # Load HTML + html_doc = HTMLDocument(html_path) + + # Set PDF options (customize as needed) + pdf_options = PdfSaveOptions() + pdf_options.page_size = pdf_options.page_size.a4 + pdf_options.embed_full_fonts = True + + # Perform conversion + Converter.convert_html(html_doc, pdf_options, pdf_path) + print(f"✅ PDF saved to {pdf_path}") + + # Verify and optionally add a footer + pdf_doc = Document(pdf_path) + for page in pdf_doc.pages: + footer = page.paragraphs.add() + footer.text = "© 2026 MyCompany – Confidential" + footer.text_state.font_size = 9 + footer.text_state.font = "Helvetica" + footer.text_state.font_style = "Italic" + pdf_doc.save(pdf_path) # Overwrite with footer + print("🖋 Footer added to all pages.") + + return pdf_doc.pages.count + +if __name__ == "__main__": + HTML_FILE = "YOUR_DIRECTORY/invoice.html" + PDF_FILE = "YOUR_DIRECTORY/invoice.pdf" + try: + pages = convert_html_to_pdf(HTML_FILE, PDF_FILE) + print(f"📄 Conversion complete – {pages} page(s) generated.") + except Exception as exc: + print(f"❌ Conversion failed: {exc}") +``` + +**الناتج المتوقع** (تشغيل من الطرفية): + +``` +✅ PDF saved to YOUR_DIRECTORY/invoice.pdf +🖋 Footer added to all pages. +📄 Conversion complete – 1 page(s) generated. +``` + +افتح `invoice.pdf` بأي عارض PDF لتأكيد أن التخطيط يطابق HTML الأصلي. + +--- + +## الخلاصة + +لقد أظهرنا لك الآن كيفية **تحويل HTML إلى PDF** في بايثون باستخدام Aspose.PDF، مع تغطية كل شيء من التثبيت إلى سكريبت كامل المميزات **يحفظ مستند HTML كملف PDF**، **ينشئ PDF من ملف HTML**، وحتى يضيف تذييلًا مخصصًا. النهج قابل للتوسع — فقط كرّر عبر قائمة من ملفات HTML أو دمجه في خدمة ويب، وستحصل على خط أنابيب موثوق لإنشاء PDFs في الوقت الفعلي. + +### ما التالي؟ + +- **صمم PDFs الخاصة بك**: جرب `PdfSaveOptions` لتضمين CSS، ضبط الهوامش، أو تمكين توافق PDF/A. +- **استكشف مكتبات أخرى**: `pdfkit` (غلاف wkhtmltopdf) أو `WeasyPrint` كبدائل مفتوحة المصدر. +- **أتمتة التحويلات الجماعية**: قراءة دليل يحتوي على ملفات `.html` وإنتاج مجموعة مطابقة من PDFs. + +إذا كان لديك أسئلة، اترك تعليقًا أدناه أو قم بعمل fork للسكريبت على GitHub وشارك تعديلاتك. برمجة سعيدة، واستمتع بتحويل HTML إلى PDFs أنيقة! + +## ماذا يجب أن تتعلم بعد ذلك؟ + +الدروس التالية تغطي مواضيع ذات صلة وثيقة تبني على التقنيات الموضحة في هذا الدليل. كل مصدر يتضمن أمثلة شيفرة كاملة مع شروحات خطوة بخطوة لمساعدتك على إتقان ميزات API إضافية واستكشاف أساليب تنفيذ بديلة في مشاريعك. + +- [تحويل HTML إلى PDF باستخدام Aspose.HTML – دليل التلاعب الكامل](/html/english/) +- [تحويل HTML إلى PDF Java – تكوين البيئة في Aspose.HTML](/html/english/java/configuring-environment/) +- [تحويل HTML إلى PDF في .NET باستخدام Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) + +{{< /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/python/general/convert-svg-to-png-in-python-complete-step-by-step-guide/_index.md b/html/arabic/python/general/convert-svg-to-png-in-python-complete-step-by-step-guide/_index.md new file mode 100644 index 000000000..c8fd6f694 --- /dev/null +++ b/html/arabic/python/general/convert-svg-to-png-in-python-complete-step-by-step-guide/_index.md @@ -0,0 +1,308 @@ +--- +category: general +date: 2026-06-19 +description: حوّل SVG إلى PNG في بايثون بسرعة وسهولة. تعلّم كيفية حفظ SVG كـ PNG، + ومعالجة تحويل SVG إلى PNG، وتصدير SVG إلى PNG باستخدام سكريبت بسيط. +draft: false +keywords: +- convert svg to png +- save svg as png +- svg to png conversion +- svg to png python +- export svg to png +language: ar +og_description: حوّل SVG إلى PNG في بايثون مع هذا الدرس العملي. تعلّم عملية التحويل + الكاملة من SVG إلى PNG وكيفية تصدير SVG إلى PNG بكفاءة. +og_title: تحويل SVG إلى PNG في بايثون – دليل كامل +schemas: +- author: Aspose + dateModified: '2026-06-19' + description: Convert SVG to PNG in Python quickly and easily. Learn how to save + SVG as PNG, handle svg to png conversion, and export SVG to PNG with a simple + script. + headline: Convert SVG to PNG in Python – Complete Step‑by‑Step Guide + type: TechArticle +- description: Convert SVG to PNG in Python quickly and easily. Learn how to save + SVG as PNG, handle svg to png conversion, and export SVG to PNG with a simple + script. + name: Convert SVG to PNG in Python – Complete Step‑by‑Step Guide + steps: + - name: Prerequisites + text: '- Python 3.8+ installed on your machine. - Basic familiarity with pip and + virtual environments. - An SVG file you want to transform (we’ll use `logo.svg` + as an example).' + - name: Why This Approach Works + text: '- **Explicit I/O handling:** By reading the SVG as bytes, we avoid issues + with Unicode encodings that sometimes crop up on Windows. - **Custom DPI:** + Scaling is often required when the target PNG must match a specific pixel density + (think print vs. screen). - **Optional background:** Some SVGs have ' + - name: Expected Result + text: '- `output/logo.png` – a 1:1 raster of the original SVG, preserving any + transparency. - `output/logo_highres.png` – a 300 DPI version with a white background, + perfect for print.' + - name: 1. **What if the SVG uses external fonts?** + text: '`cairosvg` tries to embed referenced fonts, but it only sees files on the + local filesystem. Copy the font files next to the SVG or embed them directly + in the SVG with `