Comment commencer avec FOSS pour Python

aspose-slides-foss Python est une bibliothèque gratuite et MIT pour la création et l’édition. PowerPoint .pptx fichiers — pas Microsoft Office requis, pure Python de PyPI.

Guide étape par étape

Étape 1 : Installer le package

Installer de la PIP avec le PAP :

pip install aspose-slides-foss>=26.3.2

Vérifiez que l’installation est correctement chargée :

from aspose.slides_foss import Presentation
print("aspose-slides-foss is ready.")

Étape 2 : Importation des classes requises

Importer les modules dont vous avez besoin pour charger des présentations et économiser:

from aspose.slides_foss import Presentation, SaveFormat, ShapeType, FillType

Étape 3 : Créer une présentation

Construire A Presentation Pas de raison pour commencer par un seul écran :

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)

Étape 4 : Ajouter une forme avec le texte

Utiliser slide.shapes.add_auto_shape() Pour entrer un rectangle, appelez-vous ensuite add_text_frame() Pour ajouter du contenu :

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)

Étape 5 : Appliquer un remplissage et enregistrer

Mettez une couleur de remplissage solide sur la forme avant d’économiser:

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)

Problèmes courants et solutions

ModuleNotFoundError: No module named 'aspose' Le package n’est pas installé dans l’environnement Python actif. pip install aspose-slides-foss dans le même environnement virtuel que vous utilisez pour exécuter votre script.Confirmer avec pip show aspose-slides-foss.

FileNotFoundError Quand on appelle Presentation("path") Le chemin que vous avez traversé n’existe pas ou utilisez le séparateur incorrect. pathlib.Path à Construire des chemins portables :

from pathlib import Path
from aspose.slides_foss import Presentation

prs = Presentation(str(Path("folder") / "existing.pptx"))

SaveFormat Erreur d’importation Importation SaveFormat directement de la aspose.slides_foss Le paquet : from aspose.slides_foss import Presentation, SaveFormat

Formes ajoutées mais pas visibles dans la production Les coordonnées et les dimensions sont dans les limites de la slide. sont 9144000 EMU × 6858000 (environ 12 × 9 pouces). EMU ou utilisez le x, y, width, height Paramètres en points (1 pt ≈ 12700 EMU).

Questions fréquentes

Les foss-sliens nécessitent-ils Microsoft Office ?

La bibliothèque crée et lit .pptx Fichiers natifs en Python pur sans dépendance sur Microsoft Office, COM automation ou Windows APIs.

Quelles versions de Python sont-elles soutenues ?

Python 3.10 ou plus tard. le package fonctionne sur Windows, macOS, Linux, conteneurs Docker et fonctions sans serveur.

La bibliothèque est-elle gratuite pour une utilisation commerciale ?

Oui. Il est libéré sous la licence MIT. Vous pouvez l’utiliser, modifier et redistribuer à tout but, y compris les applications commerciales.

Puis-je télécharger un fichier PPTX existant ?

Oui, passez le chemin de fichier à 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)

Puis-je ajouter plusieurs slides ?

Oui, utilisez prs.slides.add_empty_slide(layout) Après avoir obtenu un layout de prs.masters[0].layout_slides[0].