Kurulum

Python için Aspose.Slides FOSS kurulumu

Aspose.Slides FOSS for Python is distributed as a pure-Python package on PyPI. Its only external dependency is lxml, pip otomatik olarak kurar: derlenecek yerel uzantı yok, kurulacak sistem kütüphanesi yok ve Microsoft Office ya da başka bir tescilli çalışma zamanı gerektirmez.


Önkoşullar

GereksinimAyrıntı
Python sürüm3.10 or later
Paket yöneticisipip (CPython ile birlikte gelir)
İşletim sistemiWindows, macOS, Linux (CPython çalışan herhangi bir platform)
Derleyici / derleme araçlarıGerekmiyor
Otomatik bağımlılıklxml (pip tarafından otomatik olarak kurulur)

1. Install via pip (Recommended)

Aspose.Slides FOSS’ı kurmanın en basit yolu doğrudan PyPI’den yapmaktır:

pip install aspose-slides-foss

pip paketi ve birlikte lxml bağımlılığı. Kurulum sonrası yapılandırma gerekmez.

Tekrarlanabilir derlemeler için sabitlenmiş bir sürüm kurmak için:

pip install aspose-slides-foss==26.3.0

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

Sanal ortam kullanmak, kütüphaneyi diğer Python projelerinden izole eder ve sürüm çakışmalarını önler.

Bir sanal ortam oluşturun ve etkinleştirin:

##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

Etkinleştirilmiş ortam içinde kütüphaneyi kurun:

pip install aspose-slides-foss

Tekrarlanabilirlik için bağımlılıkları kaydedin:

pip freeze > requirements.txt

Ortamı başka bir makinede yeniden oluşturmak için:

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

3. Verify the Installation

Kurulumdan sonra, kütüphanenin doğru şekilde içe aktarıldığını ve bir Presentation bir nesne oluşturulabilir:

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)}")

Beklenen çıktı:

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

Kurulu sürümü pip ile de kontrol edebilirsiniz:

pip show aspose-slides-foss

Bu, sürümü, yazarı ve lisansı (MIT).


Hızlı Başlangıç: Şekilli Bir Sunum Oluşturma

Aşağıdaki betik yeni bir sunum oluşturur, metin içeren bir dikdörtgen ekler ve bunu bir .pptx dosya:

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")

Önemli: Her zaman kullan Presentation bağlam yöneticisi olarak (with ifadesi). Bu, blok çıktığında iç kaynakların düzgün temizlenmesini sağlar.


Platform Notları

Windows, macOS, Linux: Kütüphane tüm platformlarda aynıdır. Platforma özgü kod yolları veya ikili uzantılar yoktur, yalnızca lxml.

Docker / serverless: Kütüphane ince Docker görüntülerinde (örneğin python:3.12-slim) with pip install aspose-slides-foss. Ek bir apt veya yum paketi gerekmez, olmadıkça lxml kaynak koddan derlenmesi gerekir (PyPI tekerleği yaygın mimarileri kapsar).

CI/CD: Ekle pip install aspose-slides-foss CI boru hattınızın bağımlılık adımına. Ek bir kurulum gerekmez.

Conda: Projeniz Conda kullanıyorsa, kütüphaneyi Conda ortamı içinde PyPI’dan kurun:

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

Ek Kaynaklar

 Türkçe