Document
Vue d’ensemble
Document est le point d’entrée principal d’Aspose.Words pour Python. Il fournit l’API publique pour charger des documents Word (DOC, DOCX, RTF, TXT, Markdown), enregistrer dans plusieurs formats de sortie (PDF, DOCX, Markdown, TXT) et extraire le texte brut.
Défini dans : aspose/words_foss/document.py
Constructeur
| Signature | Description |
|---|---|
Document(filepath=None, *, stream=None, data=None) | Chargez un document à partir d’un chemin de fichier, d’un flux binaire ou de données brutes. Au moins une source doit être fournie. |
Paramètres :
| Nom | Type | Description |
|---|---|---|
filepath | Optional[Union[str, Path]] | Chemin vers le fichier du document à charger. |
stream | Optional[BinaryIO] | Flux binaire contenant les données du document. |
data | Optional[bytes] | Octets bruts du contenu du document. |
Méthodes
| Signature | Description |
|---|---|
save(output_path, save_format_or_options=None) → None | Enregistrez le document au format spécifié. Le format peut être une constante de chaîne SaveFormat ou un objet d’options d’enregistrement (PdfSaveOptions, MarkdownSaveOptions). |
get_text() → str | Extrayez le texte brut du document chargé. |
Propriétés
| Nom | Type | Accès | Description |
|---|---|---|---|
light_document_model | ldm.Document | Lecture | Accédez au modèle de document léger sous-jacent pour une inspection avancée de la structure du document (paragraphes, tableaux, styles, sections). |
Utilisation
import aspose.words_foss as aw
# Load a DOCX file
doc = aw.Document("input.docx")
# Extract plain text
text = doc.get_text()
# Save as PDF
doc.save("output.pdf", aw.SaveFormat.PDF)
# Save as Markdown
doc.save("output.md", aw.SaveFormat.MARKDOWN)Modèle de document léger
La propriété light_document_model permet d’accéder à la structure interne du document (ldm.Document, définie dans light_document_model.py). Ce pydantic BaseModel expose les paragraphes analysés, les tableaux, les styles, les sections, les en‑têtes, les pieds de page et les requêtes structurelles comme find_style() et headings(). La plupart des utilisateurs n’ont pas besoin d’accéder directement au LDM — les méthodes publiques Document ci‑dessus couvrent les flux de travail standard.
