Документ

Обзор

Document является основной точкой входа Aspose.Words for Python. Он предоставляет публичный API для загрузки Word‑документов (DOC, DOCX, RTF, TXT, Markdown), сохранения в несколько форматов вывода (PDF, DOCX, Markdown, TXT) и извлечения простого текста.

Определено в: aspose/words_foss/document.py

Конструктор

Signature	Description
`Document(filepath=None, *, stream=None, data=None)`	Загрузить документ из пути к файлу, бинарного потока или необработанных байтов. Должен быть предоставлен хотя бы один источник.

Параметры:

Имя	Тип	Описание
`filepath`	`Optional[Union[str, Path]]`	Путь к файлу документа для загрузки.
`stream`	`Optional[BinaryIO]`	Бинарный поток, содержащий данные документа.
`data`	`Optional[bytes]`	Необработанные байты содержимого документа.

Методы

Signature	Description
`save(output_path, save_format_or_options=None)` → `None`	Сохраните документ в указанный формат. Формат может быть строковой константой `SaveFormat` или объектом параметров сохранения (`PdfSaveOptions`, `MarkdownSaveOptions`).
`get_text()` → `str`	Извлеките простой текст из загруженного документа.

Свойства

Name	Type	Access	Description
`light_document_model`	`ldm.Document`	Чтение	Доступ к базовой облегчённой модели документа для расширенного анализа структуры документа (абзацы, таблицы, стили, разделы).

Использование

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)

Лёгкая модель документа

Свойство light_document_model предоставляет доступ к внутренней структуре документа (ldm.Document, определённой в light_document_model.py). Эта pydantic BaseModel раскрывает разобранные абзацы, таблицы, стили, разделы, колонтитулы и структурные запросы, такие как find_style() и headings(). Большинству пользователей не требуется прямой доступ к LDM — публичные методы Document выше покрывают стандартные рабочие процессы.