1. Productos
  2.   Aspose.Note
  3.   Aspose.Note FOSS for Python

Aspose.Note FOSS for Python

Leer, recorrer y exportar archivos Microsoft OneNote (.one) desde Python — gratuito y de código abierto, sin necesidad de Microsoft Office.

Aspose.Note FOSS for Python Aspose.Note FOSS
for Python

Documentación GitHub

Biblioteca de Python de código abierto para los archivos OneNote

Aspose.Note FOSS para Python es una biblioteca 100% gratuita, con licencia MIT, que le permite leer archivos Microsoft OneNote (.one) completamente desde Python, sin Microsoft Office, sin automatización COM y sin requerir un tiempo de ejecución propietario. Expone una API pública limpia (aspose.note.*) modelada en el familiar Aspose.Note para la interfaz .NET, respaldada por un analizador binario MS-ONE/OneStore incorporado escrito en puro Python.

Instale desde PyPI con pip install aspose-note (o pip install "aspose-note[pdf]" para habilitar la exportación a PDF). Requiere Python 3.10 o posterior.

La biblioteca es adecuada para scripts de automatización de documentos, canalizaciones de indexación de contenido, herramientas de archivado y cualquier flujo de trabajo del lado del servidor que necesite consumir contenido de OneNote sin una dependencia de Microsoft Office. Para la familia de productos empresariales, consulte Aspose.Note — Enterprise Product Family.

Leer y pasar los documentos de OneNote

  • Cargar .un archivo: Abra cualquier sección de OneNote desde un camino de archivos o flujo binario a través de Document.
  • Total tránsito de DOM: Navega Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile.
  • Rich Text Extraction: Leer el texto crudo a través de RichText.Text o inspeccionar los segmentos TextRun para los metadatos audaces, itálicos, fontales, colores y hiperlink.
  • Parsing de tabla: Traverse las hierarquías Table → TableRow → TableCell; leer las anchas de la columna a través de TableColumn.Width.
  • Inspección de etiquetas: Leer NoteTag metadatos (forma, etiqueta, color, estado de finalización) en los nódulos de texto, imagen y tabla.

Dónde Aspose.Note FOSS se puede usar

  • Indicación de contenido: Extrae y indexan todo el texto de los archivos de OneNote para las pistas de búsqueda.
  • Migración de documentos: Exporta secciones de OneNote a PDF, texto plano o datos estructurados.
  • Tools Archive: Salva imágenes y anexos envueltos al disco de los archivos .one.
  • Fluentes de trabajo CI/CD: Validar o procesar el contenido OneNote dentro de los contenedores Docker.
  • Pubinas basadas en el conocimiento: Extrae contenido estructurado de los notebookes OneNote del equipo.

Exportaciones, imágenes y accesorios

  • Exportación de PDF: Salva cualquier descargado Document a PDF utilizando Document.Save(path, SaveFormat.Pdf). La edición FOSS utiliza una renderización por defecto; las opciones avanzadas de pdf por página no están disponibles en esta publicación.
  • Exportación de imagen: Iterate los nódulos Image para recuperar bajetas crudas (Bytes), el nombre de archivo ( FileName) y las dimensiones ( {OriginalWidth, OriginalHeight).
  • Salva el anexo: Iterate los nódulos AttachedFile para salvar los anxos de archivo incorporados al disco.
  • Carga basada en el flujo: Abre los archivos .one de un fluxo binario (por ejemplo, io.BytesIO) sin escribir al disco.

Experiencia de desarrollador

Aspose.Note FOSS se instala con un solo comando pip install aspose-note. El paquete base no tiene dependencias opcionales; la exportación a PDF requiere ReportLab, instalado a través de pip install "aspose-note[pdf]".

El API está modelado en el familiar Aspose.Note para la interfaz .NET: Document, Page, Outline, RichText, Image, Table, AttachedFile. La biblioteca está bajo licencia MIT, es de código abierto y acepta informes de errores y contribuciones en GitHub.

Carga un archivo de OneNote y extrae todo el texto

Instalar con pip, luego pasar un camino de archivo a Document() para parse el formato binario de OneNote. GetChildNodes(RichText) realiza una búsqueda recursiva profunda y devolve cada nodo de texto en el documento, que es útil para la indicación de todo texto o los tubos de migración.

pip install aspose-note

from aspose.note import Document, RichText
doc = Document("notebook.one")
print(f"Pages: {len(list(doc))}")
# Extract all text across the entire document
texts = [rt.Text for rt in doc.GetChildNodes(RichText) if rt.Text]
for text in texts:
   print(text)

Exportación a PDF y Salva imágenes adjuntas

Exportación de PDF requiere la dependencia opcional ReportLab. Instalarlo con pip install "aspose-note[pdf]". El mismo objeto Document también puede ser iterado para los nódulos Image para extraer y salvar todas las imágenes incorporadas al disco en un solo paso.

from aspose.note import Document, SaveFormat, Image
import pathlib

doc = Document("notebook.one")

# Export the document to PDF (requires aspose-note[pdf])
doc.Save("output.pdf", SaveFormat.Pdf)

# Save all embedded images to disk
out_dir = pathlib.Path("images")
out_dir.mkdir(exist_ok=True)
for i, img in enumerate(doc.GetChildNodes(Image)):
   name = img.FileName or f"image_{i}.bin"
   (out_dir / name).write_bytes(img.Bytes)

Preguntas frecuentes

¿Qué es Aspose.Note FOSS para Python?

Es una biblioteca de Python gratuita y licenciada por MIT para leer los archivos Microsoft OneNote (.uno) sin que se requiera Microsoft Office, automatización COM o cualquier tiempo de trabajo propiedad.

¿Qué variantes de formato OneNote están apoyadas?

OneNote 2010, OneToo Online y OneLine 2007 son variantes de formato.Puede cargarse cualquier archivo válido en la sección .one.

¿Cómo lo instalaré?

Ejecutar pip install aspose-note para la biblioteca de base, o pip install "aspose-note[pdf]" a fin de incluir la dependencia opcional ReportLab para exportación de PDF.

¿Puedo exportar archivos de OneNote a PDF?

Sí. llame Document.Save(path, SaveFormat.Pdf). exportación de PDF requiere la dependencia opcional ReportLab instalada a través del [pdf] extra.

¿Puedo cargar .one archivos de un flujo?

La clase Document acepta un flujo binario (por ejemplo, io.BytesIO o un cuerpo de respuesta HTTP) para que pueda procesar archivos sin escribir en disco.

¿Qué versión de Python es necesaria?

Python 3.10 o más reciente.

¿Puedo escribir o modificar un .one archivo?

No. La edición actual es sólo leído. puede abrir y desmarcar cualquier ficha de sección válida .one, pero no se apoya la vuelta al formato binario OneNote.

¿Se apoyan los documentos encriptados de OneNote?

No. La carga de un archivo protegido por contraseña .one alza un IncorrectPasswordException. Los documentos cifrados no se soportan en la edición actual.

¿Dónde puedo encontrar el código fuente?

La biblioteca está licenciada por MIT y se alojará en GitHub. los informes de bugs y las solicitudes de pilación son bienvenidos.

  

Recursos de soporte y aprendizaje

 Español