Documento
Visión general
Document es el punto de entrada principal de Aspose.Words for Python. Proporciona la API pública para cargar documentos Word (DOC, DOCX, RTF, TXT, Markdown), guardar en múltiples formatos de salida (PDF, DOCX, Markdown, TXT) y extraer texto sin formato.
Definido en: aspose/words_foss/document.py
Constructor
| Signature | Description |
|---|---|
Document(filepath=None, *, stream=None, data=None) | Cargar un documento desde una ruta de archivo, flujo binario o bytes sin procesar. Se debe proporcionar al menos una fuente. |
Parámetros:
| Name | Type | Description |
|---|---|---|
filepath | Optional[Union[str, Path]] | Ruta al archivo del documento que se cargará. |
stream | Optional[BinaryIO] | Secuencia binaria que contiene los datos del documento. |
data | Optional[bytes] | Bytes sin procesar del contenido del documento. |
Métodos
| Firma | Descripción |
|---|---|
save(output_path, save_format_or_options=None) → None | Guardar el documento en el formato especificado. El formato puede ser una constante de cadena SaveFormat o un objeto de opciones de guardado (PdfSaveOptions, MarkdownSaveOptions). |
get_text() → str | Extraer texto sin formato del documento cargado. |
Propiedades
| Nombre | Tipo | Acceso | Descripción |
|---|---|---|---|
light_document_model | ldm.Document | Lectura | Acceso al modelo de documento ligero subyacente para inspección avanzada de la estructura del documento (párrafos, tablas, estilos, secciones). |
Uso
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)Modelo de documento ligero
La propiedad light_document_model proporciona acceso a la estructura interna del documento (ldm.Document, definida en light_document_model.py). Este BaseModel de pydantic expone párrafos analizados, tablas, estilos, secciones, encabezados, pies de página y consultas estructurales como find_style() y headings(). La mayoría de los usuarios no necesitan acceder al LDM directamente — los métodos públicos Document anteriores cubren flujos de trabajo estándar.
