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

Aspose.Slides FOSS for Python

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

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

مستندات GitHub

کتابخانه ی منبع باز پایتون برای ارائه های پاورپوینت

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

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

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

نمایش و API اسلاید

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

جایی که Aspose.Slides FOSS می تواند مورد استفاده قرار گیرد

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

فرمت کردن متن و اثرات بصری

  • ** قالب بندی سطح کاراکتر:** استفاده از bold، italic، اندازه فونت و رنگ برای اشیاء Portion فردی.
  • پوشش های جامد و گرادینت: شکل پر کردن را به یک رنگ جامدی یا گرادیانت خطی چند توقف تنظیم کنید.
  • ** اثر سایه و درخشش:** به هر شکل، سایه بیرونی، درخشان، مبهم و بازتاب را اعمال کنید.
  • تطابق پاراگراف: تنظیم چپ، مرکز، راست یا توجیه تعادل در هر پاراګراف.
  • کد سفر دور: قسمت های نامعلوم XML در حفظ مجدد به طور کامل محفوظ می شوند.

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

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

API مدل شیء PowerPoint را (Presentation، Slide, Shape ، TextFrame , Paragraph و Portion) منعکس می کند. بنابراین هر کسی که با مدل شيئۀ پاورپوینت آشنا باشد می تواند از این کتابخانه استفاده کند . این نسخه دارای مجوز 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 برای پایتون چیست؟

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

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

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

آیا این نیاز به مایکروسافت آفیس یا پاورپوینت دارد؟

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

چطوري نصبش کنم؟

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

ميتونم اثرات بصري مثل سايه و درخشش رو اعمال کنم؟

بله، کتابخانه از اثر سایه ی بیرونی، تابش، تیره و بازتاب روی هر شیء شکل پذیرفته شده.

آیا الگوی مدیر زمینه توصیه می شود؟

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

آیا دور و بر کردن یک PPTX محتوای ناشناخته را نابود می کند؟

نه. قسمت های نامعلوم XML که در هنگام بارگیری پیدا می شوند، به طور لفظی در Save حفظ می شود، بنابراین محتوایی که کتابخانه هنوز درک نمی کند هرگز از دست نخواهد رفت.

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

این کتابخانه دارای مجوز MIT است و در GitHub میزبانی می شود. گزارشات خطا و درخواست های کشیدن خوش آمدید هستند.

  

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

 فارسی