Cómo comenzar con Aspose.Note FOSS para Python

aspose-note Python es una biblioteca gratuita y licenciada por MIT para la lectura y el uso de las aplicaciones. Convertir Microsoft OneNote .one archivos en PDF — no se requiere Microsoft Office, no es nativo Extensiones, Python puro de PyPI.

Guía paso a paso

Paso 1: Instalar el paquete

Instalar desde PyPI con pip:

pip install aspose-note>=26.3.2

Verifique la instalación cargada correctamente:

from aspose.note import Document
print("aspose-note is ready.")

Paso 2: Importar las clases necesarias

Importa los módulos que necesitas para cargar documentos, cruzar nodos y ahorrar:

from aspose.note import Document, Page, Outline, RichText, SaveFormat

Paso 3: Cargar un archivo de OneNote

Pasar un archivo de ruta a Document para cargar cualquier formato de OneNote compatible. FileFormat Propiedad para comprobar qué variante se detectó:

from aspose.note import Document

doc = Document("notebook.one")
print(f"Format : {doc.FileFormat}")
print(f"Pages  : {len(list(doc))}")

Paso 4: Caminar las páginas y leer el texto

Uso GetChildNodes() para recuperar todos Page los nodos, luego desciende a RichText Lea Nódulos para leer el contenido del texto real:

from aspose.note import Document, Page, RichText

doc = Document("notebook.one")
for page in doc.GetChildNodes(Page):
    if page.Title and page.Title.TitleText:
        print(f"Page: {page.Title.TitleText}")
    for rt in page.GetChildNodes(RichText):
        text = "".join(rt)
        if text.strip():
            print(f"  {text[:120]}")

Paso 5: Exportación a PDF

Document.Save() aceptan SaveFormat.Pdf para escribir un PDF. la exportación funciona completamente En el proceso sin ningún render externo:

import io
from aspose.note import Document, SaveFormat

doc = Document("notebook.one")

# Save to a file
doc.Save("output.pdf", SaveFormat.Pdf)

# Save to an in-memory buffer
buf = io.BytesIO()
doc.Save(buf, SaveFormat.Pdf)
print(f"PDF bytes: {len(buf.getvalue())}")

Problemas y soluciones comunes

ModuleNotFoundError: No module named 'aspose' El paquete no está instalado en el entorno de Python activo. pip install aspose-note en el mismo entorno virtual que está utilizando para ejecutar su script. confirmar con pip show aspose-note.

FileNotFoundError Cuando llamar Document("path") El camino que pasaste no existe o utiliza el separador equivocado. pathlib.Path para Construcción de caminos por vía:

from pathlib import Path
from aspose.note import Document

doc = Document(str(Path("folder") / "notebook.one"))

GetChildNodes() Devolver una lista vacía Asegúrese de que está llamando GetChildNodes(Page) En el Document ROSA - No en el Page nodo — cuando esperas niños de nivel de página. cada nivel del árbol sólo regresa su propio descendientes del tipo especificado.

La salida de PDF es blanca o el contenido que falta El PDF Renderer lea RichText Nódulos: Si el archivo contiene sólo imágenes o ficheros anexados. con no RichText nódulos, las páginas PDF serán vacías. inspeccionar el árbol de documento para verificar que ese RichText Los nódulos están presentes y contienen texto.

page.Title Es el None No todas las páginas tienen un título. siempre guarda: if page.Title and page.Title.TitleText: ... antes de acceder al título para evitar el uso del texto AttributeError.

Preguntas frecuentes

¿Es necesario un apodo de Microsoft Office?

No. La biblioteca lee el formato binario de OneNote y exporta a PDF nativo en Python puro sin depender de Microsoft Office, COM automation o Windows APIs.

¿Qué versiones de Python se apoyan?

Python 3.10 o más tarde. el paquete se ejecuta en Windows, macOS, Linux, contenedores de Docker y funciones sin servidor.

¿La biblioteca es libre para uso comercial?

Se publica bajo la Licencia MIT. Puede utilizar, modificar y redistribuirlo para cualquier propósito, incluidas las aplicaciones comerciales.

¿Puedo escribir nuevos archivos de OneNote desde el escudo?

Crea un documento utilizando Document(),y añade Page Nódulos por medio AppendChildLast(),Añadir Outline y RichText niños, y exportar a PDF con Document.Save("output.pdf", SaveFormat.Pdf).- Salvar de vuelta a .one El formato no está apoyado.

¿Puedo guardar en formatos distintos de PDF?

La actual versión 26.3.2 solo soporta la exportación a PDF. .one El formato o la exportación a PNG, HTML u otros formatos no está disponible en esta edición de FOSS.