نصب

نصب Aspose.Slides FOSS برای Python

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml, که pip به‌صورت خودکار نصب می‌کند: نیازی به کامپایل افزونه‌های بومی نیست، کتابخانه‌های سیستمی برای نصب وجود ندارند، و نیازی به Microsoft Office یا سایر زمان‌اجرای مالکیتی نیست.

پیش‌نیازها

1. Install via pip (Recommended)

ساده‌ترین روش برای نصب Aspose.Slides FOSS مستقیماً از PyPI است:

pip install aspose-slides-foss

pip بسته را دانلود و نصب می‌کند همراه با lxml وابستگی. نیازی به پیکربندی پس از نصب نیست.

برای نصب نسخهٔ ثابت به منظور ساخت‌های قابل تکرار:

pip install aspose-slides-foss==26.3.0

2. Set Up a Virtual Environment (Recommended for Projects)

استفاده از محیط مجازی کتابخانه را از سایر پروژه‌های Python جدا نگه می‌دارد و از تداخل نسخه‌ها جلوگیری می‌کند.

یک محیط مجازی ایجاد و فعال کنید:

##Create the environment
python -m venv .venv

##Activate on Linux / macOS
source .venv/bin/activate

##Activate on Windows (Command Prompt)
.venv\Scripts\activate.bat

##Activate on Windows (PowerShell)
.venv\Scripts\Activate.ps1

کتابخانه را داخل محیط فعال شده نصب کنید:

pip install aspose-slides-foss

وابستگی‌ها را برای قابلیت بازتولید ثبت کنید:

pip freeze > requirements.txt

برای بازسازی محیط در ماشین دیگری:

python -m venv .venv
source .venv/bin/activate   # or the Windows equivalent
pip install -r requirements.txt

3. Verify the Installation

پس از نصب، اطمینان حاصل کنید که کتابخانه به‌درستی ایمپورت می‌شود و یک Presentation می‌توان ایجاد کرد:

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

with slides.Presentation() as prs:
    print("Aspose.Slides FOSS installed successfully")
    print(f"Slides in empty presentation: {len(prs.slides)}")

خروجی مورد انتظار:

Aspose.Slides FOSS installed successfully
Slides in empty presentation: 1

همچنین می‌توانید نسخه نصب‌شده را با pip بررسی کنید:

pip show aspose-slides-foss

این نسخه، نویسنده و مجوز را چاپ می‌کند (MIT).

شروع سریع: ایجاد یک ارائه با یک شکل

اسکریپت زیر یک ارائه جدید ایجاد می‌کند، یک مستطیل با متن اضافه می‌کند و آن را به عنوان یک .pptx فایل:

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

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

    ##Add a rectangle shape and set its text
    shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 50, 50, 400, 150)
    shape.add_text_frame("Hello from Aspose.Slides FOSS!")

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

print("Saved hello.pptx")

مهم: همیشه استفاده کنید Presentation به عنوان یک مدیر زمینه (with بیان). این اطمینان می‌دهد که پاک‌سازی صحیح منابع داخلی هنگام خروج از بلوک انجام شود.

یادداشت‌های پلتفرم

ویندوز، macOS، لینوکس: کتابخانه در تمام پلتفرم‌ها یکسان است. مسیرهای کد یا افزونه‌های باینری مخصوص پلتفرم وجود ندارند، به جز lxml.

Docker / سرورلس: کتابخانه در داخل تصاویر Docker لاغر (مانند python:3.12-slim) با pip install aspose-slides-foss. بسته‌های اضافی apt یا yum نیازی نیست مگر اینکه lxml نیاز به کامپایل از منبع داشته باشد (چرخ PyPI معماری‌های رایج را پوشش می‌دهد).

CI/CD: افزودن pip install aspose-slides-foss به مرحلهٔ وابستگی‌های خط لوله CI خود اضافه کنید. نیازی به تنظیمات اضافی نیست.

Conda: اگر پروژهٔ شما از Conda استفاده می‌کند، کتابخانه را از PyPI داخل یک محیط Conda نصب کنید:

conda create -n slides-env python=3.12
conda activate slides-env
pip install aspose-slides-foss

منابع اضافی

• صفحهٔ محصول: مرور کلی، خلاصهٔ ویژگی‌ها، و شروع سریع
• مجوز: جزئیات مجوز MIT، نیازی به کلید API نیست
• راهنمای توسعه‌دهنده: راهنمای ویژگی‌ها با مثال‌های کد
• مرجع API: مرجع کلاس و متد