文档 – Aspose FOSS API Reference

文档

概述

Document 是 Aspose.Words for Python 的主要入口点。它提供用于加载 Word 文档（DOC、DOCX、RTF、TXT、Markdown）的公共 API，支持保存为多种输出格式（PDF、DOCX、Markdown、TXT），以及提取纯文本。

定义于：aspose/words_foss/document.py

构造函数

Signature	Description
`Document(filepath=None, *, stream=None, data=None)`	从文件路径、二进制流或原始字节加载文档。必须提供至少一个来源。

参数:

Name	Type	Description
`filepath`	`Optional[Union[str, Path]]`	要加载的文档文件路径。
`stream`	`Optional[BinaryIO]`	包含文档数据的二进制流。
`data`	`Optional[bytes]`	文档内容的原始字节。

方法

签名	描述
`save(output_path, save_format_or_options=None)` → `None`	将文档保存为指定的格式。该格式可以是 `SaveFormat` 字符串常量或保存选项对象（`PdfSaveOptions`，`MarkdownSaveOptions`）。
`get_text()` → `str`	从已加载的文档中提取纯文本。

属性

名称	类型	访问	描述
`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 方法已覆盖标准工作流。