Preguntas frecuentes
Licencia y Open Source
¿Qué licencia utiliza Aspose.Note FOSS para Python?
Aspose.Note FOSS for Python is released under the Licencia MIT.Puedes usar, modificar y redistribuir la biblioteca para cualquier propósito, incluidas las aplicaciones comerciales, sin que se Requisitos de royalties o atribuciones más allá de incluir el texto de la licencia.
¿Puedo utilizar esta biblioteca en un producto comercial?
La Licencia MIT no impone restricciones sobre uso comercial, redistribución o modificación.No hay tarifas de tiempo de trabajo, límites de uso ni requisitos de suscripción.
¿Dónde está el código fuente?
El paquete se publica en PyPI como aspose-note.Instalarlo con:
pip install aspose-note>=26.3.2Instalación y Requisitos
¿Cómo puedo instalar Aspose.Note FOSS para Python?
Instalar desde PyPI utilizando pip:
pip install aspose-note>=26.3.2Verificar la instalación:
from aspose.note import Document
print("aspose-note is ready.")¿Qué versiones de Python se apoyan?
Aspose.Note FOSS for Python requires Python 3.10 o más tarde.Es puro Python con no compilado extensiones, así que se ejecuta de forma idéntica en los contenedores Windows, macOS, Linux, Docker, y funciones sin servidor.
¿Es necesario Microsoft Office o Microsoft OneNote?
No. La biblioteca lee OneNote .one archivos y exportaciones a PDF nativos en Python. no hay Dependencia de Microsoft Office, automatización COM o cualquier API específico de Windows.
Formato de apoyo
¿Qué formatos de OneNote puedo leer?
La biblioteca lee las tres variantes binarias de OneNote:
| Formato | Extensiones | Leer | Escribe |
|---|---|---|---|
| El OneNote 2010 | .one | ✓ | — |
| El OneNote 2007 | .one | ✓ | — |
| OneNote en línea | .one | ✓ | — |
.pdf | — | ✓ |
Utilice el FileFormat Propiedad en una carga Document Para identificar qué variante se detectó:
from aspose.note import Document
doc = Document("notebook.one")
print(doc.FileFormat) # e.g. FileFormat.OneNote2010¿Puedo exportar documentos de OneNote a PDF?
Sí, pasamos SaveFormat.Pdf El segundo argumento de Document.Save():
from aspose.note import Document, SaveFormat
doc = Document("notebook.one")
doc.Save("output.pdf", SaveFormat.Pdf)También puedes guardar en un buffer de memoria al pasar una BytesIO Objeto en lugar de un archivo.
¿Puedo guardar de nuevo en el formato OneNote?
La biblioteca lee .one archivos pero sólo exportan a PDF. llamando Document.Save() con El formato no PDF se alza UnsupportedSaveFormatException.Uso de SaveFormat.Pdf Para todos Salva operaciones.
El uso de API
¿Cómo puedo cargar un archivo de OneNote?
Instantía Document Con el camino de archivo:
from aspose.note import Document
doc = Document("notebook.one")Document es la raíz del modelo de objeto.Todos los Page, Outline,y, RichText Node en El archivo está accesible desde esta raíz.
¿Cómo puedo iterar sobre las páginas y su contenido de texto?
Uso GetChildNodes() para recuperar los nodos de la niña en cualquier nivel del árbol:
from aspose.note import Document, Page, RichText
doc = Document("notebook.one")
for page in doc.GetChildNodes(Page):
print(f"Page author: {page.Author}")
for rt in page.GetChildNodes(RichText):
text = "".join(rt)
if text.strip():
print(text)¿Cómo puedo crear un documento de escratch?
Construye los nodos arriba hacia abajo y los adhiere con AppendChildLast():
from aspose.note import Document, Page, Outline, RichText, TextStyle, Title, SaveFormat
doc = Document()
page = Page()
title_text = RichText()
title_text.Append("My Page Title", TextStyle())
title = Title()
title.TitleText = title_text
page.Title = title
outline = Outline()
page.AppendChildLast(outline)
doc.AppendChildLast(page)
doc.Save("new_notebook.pdf", SaveFormat.Pdf)¿Cómo puedo leer metadatos de página como autor y tiempo de creación?
Cada uno Page Node Exposición Author, CreationTime,y, LastModifiedTime como propiedades. El Title Node proporciona TitleText, TitleDate,y, TitleTime como RichText Los niños:
from aspose.note import Document, Page
doc = Document("notebook.one")
for page in doc.GetChildNodes(Page):
print(f"Author : {page.Author}")
print(f"Created : {page.CreationTime}")
if page.Title and page.Title.TitleText:
print(f"Title : {page.Title.TitleText}")Conocidas limitaciones
¿Hay limitaciones conocidas que debería ser consciente?
La versión actual (26.3.2) se centra en la lectura de OneNote .one Los archivos y Exportación a otros formatos raster o vector (PNG, SVG, HTML) no es Disponible en esta edición FOSS.
¿Puedo controlar las opciones de exportación de PDF como el tamaño de la página o el DPI?
PDF es un formato escrito (exportado) - la biblioteca salva contenido de OneNote en PDF; el PDF no se acepta como formato de entrada. Document.Save() El método con SaveFormat.Pdf producirá una rendición por defecto.Si necesita un control de salida fin-grained, aplique ajustes adicionales al archivo resultante utilizando una herramienta PDF dedicada.
¿Están disponibles las dimensiones de la imagen en los nódulos de imagen?
Image Los nodos exponen dos pares de atributos dimensionales. Width y Height Son mutables Atributos que puede leer y configurar para controlar el tamaño de la pantalla. OriginalWidth y OriginalHeight son propiedades que sólo leyen que devuelven las dimensiones de la imagen original. 4 Retorno float | None.
