چگونه با Aspose.Email FOSS برای Python شروع کنیم
aspose-slides-foss برای Python یک کتابخانه رایگان و مجوز MIT برای ایجاد و ویرایش است. PowerPoint .pptx فایل ها – هیچ Microsoft Office مورد نیاز، Python خالص از PyPI.
راهنمای گام به گام
مرحله اول: نصب بسته بندی
نصب از پپ با پیت:
pip install aspose-slides-foss>=26.3.2بررسی نصب شده به درستی:
from aspose.slides_foss import Presentation
print("aspose-slides-foss is ready.")مرحله دوم: کلاس های مورد نیاز واردات
وارد کردن ماژول هایی که برای بارگذاری و ذخیره سازی ارائه ها نیاز دارید:
from aspose.slides_foss import Presentation, SaveFormat, ShapeType, FillTypeمرحله سوم: ایجاد یک نمایش
ساختن A Presentation بدون هیچ استدلال برای شروع با یک اسلاید سفید:
from aspose.slides_foss import Presentation, SaveFormat
prs = Presentation()
slide = prs.slides[0]
print(f"Slides: {len(prs.slides)}")
prs.save("new_presentation.pptx", SaveFormat.PPTX)مرحله چهارم: اضافه کردن یک فرم با متن
استفاده از slide.shapes.add_auto_shape() برای وارد کردن یک دایره، سپس تماس بگیرید. add_text_frame() برای اضافه کردن محتوای متن:
from aspose.slides_foss import Presentation, SaveFormat, ShapeType
prs = Presentation()
slide = prs.slides[0]
shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 400, 150)
tf = shape.add_text_frame("Hello from Aspose.Slides FOSS!")
tf.paragraphs[0].portions[0].portion_format.font_height = 24
prs.save("with_shape.pptx", SaveFormat.PPTX)مرحله پنجم: یک پر کردن و ذخیره کنید.
قبل از صرفه جویی، رنگ را روی شکل قرار دهید:
from aspose.slides_foss import (
Presentation, SaveFormat, ShapeType, FillType, Color
)
prs = Presentation()
slide = prs.slides[0]
shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 100, 100, 400, 200)
shape.fill_format.fill_type = FillType.SOLID
shape.fill_format.solid_fill_color.color = Color.from_argb(255, 70, 130, 180)
shape.add_text_frame("Styled shape")
prs.save("styled.pptx", SaveFormat.PPTX)مشکلات رایج و راهحلها
ModuleNotFoundError: No module named 'aspose' این بسته در محیط فعال Python نصب نشده است. pip install aspose-slides-foss در همان محیط مجازی که برای اجرای اسکریپت استفاده می کنید، تایید کنید. pip show aspose-slides-foss.
FileNotFoundError وقتی تماس می گیرند Presentation("path") مسیر عبور شما وجود ندارد یا از جداساز اشتباه استفاده می کند. pathlib.Path به راه های حمل و نقل را به صورت قابل حمل انجام دهید:
from pathlib import Path
from aspose.slides_foss import Presentation
prs = Presentation(str(Path("folder") / "existing.pptx"))SaveFormat واردات اشتباه واردات SaveFormat به طور مستقیم از aspose.slides_foss بسته بندی : from aspose.slides_foss import Presentation, SaveFormat
شکل اضافه شده اما در خروجی قابل مشاهده نیست هماهنگی ها و ابعاد اطمینان در محدوده اسلاید قرار دارند. 9144000 ام اس × 6858000 (حدود 12 × 9 اینچ) است. استفاده از EMU یا استفاده x, y, width, height پارامترها در نقاط (1 pt ≈ 12700 EMU).
سوالات متداول
آیا برای نصب اسلاید فوس نیاز به Microsoft Office دارد؟?
کتابخانه می سازد و خوانده است. .pptx فایل های بومی در Python خالص بدون وابستگی در Microsoft Office، COM Automation یا Windows API.
کدام نسخه های Python پشتیبانی می شوند؟?
Python 3.10 یا بعد از آن. این بسته در ویندوز، macOS، لینوکس، کنتینر Docker و ویژگی های بدون سرور اجرا می شود.
آیا کتابخانه برای استفاده تجاری رایگان است؟?
بله، تحت مجوز MIT منتشر می شود.شما می توانید آن را برای هر هدف از جمله برنامه های تجاری استفاده کنید، ویرایش و توزیع مجدد.
آیا می توانم یک فایل PPTX موجود را بارگذاری کنم؟?
بله، مسیر فایل را به Presentation:
from aspose.slides_foss import Presentation, SaveFormat
prs = Presentation("existing.pptx")
print(f"Loaded {len(prs.slides)} slides")
prs.save("copy.pptx", SaveFormat.PPTX)آیا می توانم چندین اسلاید اضافه کنم؟?
بله استفاده کنید prs.slides.add_empty_slide(layout) پس از دریافت یک لایه از prs.masters[0].layout_slides[0].