1. محصولات
  2.   Aspose.Slides
  3.   Aspose.Slides FOSS for Python

Aspose.Slides FOSS برای Python

ایجاد، خواندن و ویرایش ارائه‌های PowerPoint از Python — رایگان و منبع باز، بدون نیاز به وابستگی به Office.

Aspose.Slides FOSS for Python Aspose.Slides FOSS
for Python

مستندات GitHub

کتابخانهٔ منبع باز Python برای ارائه‌های PowerPoint

Aspose.Slides FOSS برای Python یک کتابخانهٔ pure-Python با مجوز MIT برای کار با فایل‌های .pptx پاورپوینت است. آن را با یک فرمان pip نصب کنید و بلافاصله شروع به ایجاد، خواندن و ویرایش ارائه‌ها کنید بدون نصب Microsoft Office یا هر زمان‌اجرای مالکیتی.

کتابخانه یک Presentation API را ارائه می‌دهد که حول Presentation، Slide، Shape، TextFrame، Paragraph و Portion ساخته شده است، مدل مفهومی که خود PowerPoint از آن استفاده می‌کند. اسلایدها را اضافه و حذف کنید، AutoShapes، Tables و Connectors را وارد کنید، متن را در سطح کاراکتر با bold، italic، font size و color قالب‌بندی کنید، پرکننده‌های ثابت یا گرادیان اعمال کنید، و افکت‌های بصری (shadow, glow, blur, reflection) را اضافه کنید.

الگوی مدیر زمینه تضمین می‌کند که پاک‌سازی منابع به‌صورت قابل اعتماد انجام شود: همیشه یک Presentation را با with slides.Presentation(...) as prs: باز کنید. بخش‌های ناشناخته XML که در حین بارگذاری مواجه می‌شوند، به‌صورت کلمه به کلمه در زمان ذخیره حفظ می‌شوند، به‌طوری که round‑tripping هرگز محتوایی را که کتابخانه هنوز درک نکرده است، از بین نمی‌برد. کتابخانه به Python 3.10 یا بالاتر نیاز دارد و فقط به lxml وابسته است که به‌صورت خودکار نصب می‌شود. برای ویژگی‌ها و پشتیبانی‌های اضافی، استفاده از Aspose.Slides for Python را در نظر بگیرید.

API ارائه و اسلاید

  • ایجاد و باز کردن PPTX: ارائه‌های جدید ایجاد کنید یا فایل‌های .pptx موجود را باز کنید.
  • اسلایدها را اضافه و حذف کنید: به‌صورت برنامه‌نویسی مجموعه اسلایدها را مدیریت کنید.
  • AutoShapes: مستطیل‌ها، بیضی‌ها، خطوط و سایر انواع AutoShape را وارد کنید.
  • جداول و اتصال‌دهنده‌ها: افزودن اشکال جدول ساختاریافته و خطوط اتصال بین اشکال.
  • یادداشت‌های گوینده: خواندن و نوشتن یادداشت‌های گوینده برای هر اسلاید.
  • Threaded comments: دسترسی به رشته‌های نظرات در سطح اسلاید.

جایی که Aspose.Slides FOSS می‌تواند استفاده شود

  • تولید گزارش: اسلایدهای برند شده را از منابع داده بدون Office بسازید.
  • خودکارسازی قالب: قالب‌های PPTX را با محتوای پویا در خطوط لوله CI/CD پر کنید.
  • مهاجرت محتوا: ارائه‌های موجود را بخوانید و اسلایدها را بازساخت یا بازطراحی کنید.
  • پشت‌صحنه‌های بدون سرور: فایل‌های PPTX را داخل کانتینرهای Docker یا توابع Lambda پردازش کنید.
  • پردازش دسته‌ای: اعمال تغییرات قالب‌بندی یکنواخت در کتابخانه‌های بزرگ اسلاید.

قالب‌بندی متن و جلوه‌های بصری

  • قالب‌بندی سطح کاراکتر: اعمال بولد، ایتالیک، اندازهٔ فونت و رنگ به اشیای Portion جداگانه.
  • پر کردن‌های جامد و گرادیان: پر کردن شکل را به یک رنگ جامد یا گرادیان خطی چند نقطه‌ای تنظیم کنید.
  • افکت‌های سایه و درخشندگی: سایه خارجی، درخشندگی، تاری و بازتاب را بر روی هر شکلی اعمال کنید.
  • تراز پاراگراف: تراز چپ، مرکز، راست یا توجیه‌شده را برای هر پاراگراف تنظیم کنید.
  • ایمن در سفر رفت و برگشت: قسمت‌های ناشناخته XML به‌صورت کلمه به کلمه در زمان ذخیره‌سازی مجدد حفظ می‌شوند.

تجربه توسعه‌دهنده

Aspose.Slides FOSS با یک فرمان pip install aspose-slides-foss نصب می‌شود. تنها وابستگی زمان اجرا lxml است که به‌صورت خودکار نصب می‌شود. هیچ افزونه بومی برای کامپایل وجود ندارد.

API مدل شیء PowerPoint را بازتاب می‌دهد (Presentation, Slide, Shape, TextFrame, Paragraph, Portion)، بنابراین هر کسی که با مدل شیء PowerPoint آشناست می‌تواند بلافاصله از کتابخانه استفاده کند. این کتابخانه تحت مجوز MIT است، به صورت منبع باز در GitHub موجود است و به Python 3.10 یا بالاتر نیاز دارد.

یک ارائه ایجاد کنید و یک شکل اضافه کنید

از مدیر زمینه (with slides.Presentation() as prs:) استفاده کنید تا اطمینان حاصل شود که PPTX همیشه بسته می‌شود و منابع آزاد می‌شوند. add_auto_shape() یک مقدار enum ShapeType می‌گیرد، سپس موقعیت x/y و عرض/ارتفاع را بر حسب نقاط دریافت می‌کند — add_text_frame() را روی شکل فراخوانی کنید تا یک فریم متن متصل شود و برچسب را در یک خط تنظیم کنید.

pip install aspose-slides-foss

import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat

with slides.Presentation() as prs:
    slide = prs.slides[0]

    # Add a rectangle AutoShape
    shape = slide.shapes.add_auto_shape(
        slides.ShapeType.RECTANGLE, 50, 50, 400, 150
    )
    shape.add_text_frame("Hello, Aspose.Slides!")

    prs.save("output.pptx", SaveFormat.PPTX)

متن را قالب‌بندی کنید و یک اثر پر کردن اعمال کنید

قالب‌بندی متن در سطح Portion کار می‌کند — کوچک‌ترین واحد یک دنباله از کاراکترها. فایل ذخیره‌شده را باز کنید، به بخش اول اولین پاراگراف بروید و ویژگی‌های قلم را به‌صورت مستقیم تنظیم کنید. پر کردن شکل مستقل است: fill_type را به SOLID تنظیم کنید و یک رنگ به solid_fill_color.color اختصاص دهید.

import aspose.slides_foss as slides
from aspose.slides_foss import NullableBool, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat

with slides.Presentation("output.pptx") as prs:
    shape = prs.slides[0].shapes[0]
    portion = shape.text_frame.paragraphs[0].portions[0]

    # Bold, 18pt, dark-blue text
    portion.portion_format.font_bold = NullableBool.TRUE
    portion.portion_format.font_height = 18
    portion.portion_format.fill_format.fill_type = FillType.SOLID
    portion.portion_format.fill_format.solid_fill_color.color = Color.dark_blue

    # Solid background fill on the shape
    shape.fill_format.fill_type = FillType.SOLID
    shape.fill_format.solid_fill_color.color = Color.alice_blue

    prs.save("formatted.pptx", SaveFormat.PPTX)

سوالات متداول

Aspose.Slides FOSS - FOSS Aspose.Slides برای Python چیست؟

این یک کتابخانهٔ رایگان، تحت مجوز MIT، pure-Python برای ایجاد، خواندن و ویرایش ارائه‌های PowerPoint .pptx بدون نیاز به Microsoft Office است.

کدام فرمت‌های فایل پشتیبانی می‌شوند؟

.pptx فرمت پشتیبانی‌شده برای خواندن/نوشتن است. خروجی به PDF، HTML، SVG یا تصاویر در این نسخه موجود نیست.

آیا به Microsoft Office یا PowerPoint نیاز دارد؟

خیر. Aspose.Slides FOSS یک کتابخانهٔ خالص-Python است که هیچ وابستگی به Microsoft Office، خودکارسازی COM، یا هیچ زمان‌اجرای مالکیتی ندارد.

چگونه آن را نصب کنم؟

اجرای pip install aspose-slides-foss. تنها وابستگی lxml است که به‌صورت خودکار نصب می‌شود. Python نسخهٔ 3.10 یا بالاتر مورد نیاز است.

آیا می‌توانم افکت‌های بصری مانند سایه و درخشندگی اعمال کنم؟

بله. این کتابخانه از افکت‌های سایهٔ خارجی، درخشندگی، تاری و انعکاس بر روی هر شیء شکل‌دار پشتیبانی می‌کند.

آیا الگوی مدیر زمینه (context manager) توصیه می‌شود؟

بله. همیشه یک Presentation را با with slides.Presentation(...) as prs: باز کنید تا پاک‌سازی منابع به‌صورت قابل‌اعتماد انجام شود.

آیا دور زدن (round‑tripping) یک فایل PPTX محتویات ناشناخته را خراب می‌کند؟

خیر. بخش‌های ناشناختهٔ XML که در هنگام بارگذاری مواجه می‌شوند، به‌صورت دقیق در زمان ذخیره‌سازی حفظ می‌شوند، بنابراین محتوایی که کتابخانه هنوز درک نمی‌کند، هرگز از دست نمی‌رود.

کجا می‌توانم کد منبع را پیدا کنم؟

این کتابخانه تحت مجوز MIT است و در GitHub میزبانی می‌شود. گزارش‌های باگ و درخواست‌های کشش (pull request) خوش‌آمدید.

  

منابع پشتیبانی و آموزش

 فارسی