Document

Prezentare generală

Document este punctul principal de intrare al Aspose.Words pentru Python. Oferă API-ul public pentru încărcarea documentelor Word (DOC, DOCX, RTF, TXT, Markdown), salvarea în multiple formate de ieșire (PDF, DOCX, Markdown, TXT) și extragerea textului simplu.

Definit în: aspose/words_foss/document.py

Constructor

Signature	Description
`Document(filepath=None, *, stream=None, data=None)`	Încarcă un document dintr-o cale de fișier, flux binar sau octeți brute. Trebuie furnizată cel puțin o sursă.

Parametri:

Nume	Tip	Descriere
`filepath`	`Optional[Union[str, Path]]`	Calea către fișierul documentului de încărcat.
`stream`	`Optional[BinaryIO]`	Flux binar care conține datele documentului.
`data`	`Optional[bytes]`	Octeți brute ale conținutului documentului.

Metode

Semnătură	Descriere
`save(output_path, save_format_or_options=None)` → `None`	Salvează documentul în formatul specificat. Formatul poate fi o constantă de tip șir `SaveFormat` sau un obiect de opțiuni de salvare (`PdfSaveOptions`, `MarkdownSaveOptions`).
`get_text()` → `str`	Extrage textul simplu din documentul încărcat.

Proprietăți

Nume	Tip	Acces	Descriere
`light_document_model`	`ldm.Document`	Citire	Accesați modelul de document ușor subiacente pentru inspecție avansată a structurii documentului (paragrafe, tabele, stiluri, secțiuni).

Utilizare

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)

Model de Document Light

Proprietatea light_document_model oferă acces la structura internă a documentului (ldm.Document, definită în light_document_model.py). Acest BaseModel pydantic expune paragrafele analizate, tabelele, stilurile, secțiunile, anteturile, subsolurile și interogările structurale precum find_style() și headings(). Majoritatea utilizatorilor nu au nevoie să acceseze direct LDM — metodele publice Document de mai sus acoperă fluxurile de lucru standard.