Questions fréquemment posées

Licences & Open Source

Quelle licence utilise le logiciel FOSS pour Python ?

Aspose.Note FOSS for Python is released under the avec licence.Vous pouvez modifier, utiliser et redistribuer la bibliothèque à quelque fin que ce soit, y compris les applications commerciales, sans les droits d’auteur ou les exigences d’attribution en plus de l’inclusion du texte de la licence.

Puis-je utiliser cette bibliothèque dans un produit commercial?

La licence MIT n’impose aucune restriction sur l’utilisation commerciale, la redistribution ou la modification. Il n’y a pas de frais d’exécution, de limites d’utilisation ou de conditions d ́abonnement.

Où est le code source ?

Le document est publié sur PyPI comme aspose-note.Installez-le avec :

pip install aspose-note>=26.3.2

Installation & exigences

Comment installer Aspose.Note FOSS pour Python?

Installer à partir de PyPI en utilisant pip :

pip install aspose-note>=26.3.2

Vérifiez l’installation :

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

Quelles versions de Python sont prises en charge ?

Aspose.Note FOSS for Python requires Python 3.10 ou plus récent.C’est Python sans rien dire extensions compilées, de sorte qu’elle fonctionne de manière identique sur Windows, macOS, Linux, Docker containers, Des fonctions sans serveur.

Vous avez besoin de Microsoft Office ou de OneNote ?

La bibliothèque lit OneNote .one fichiers et exportations vers PDF nativement en Python. Il n’y a pas de dépendance à Microsoft Office, à l’automatisation COM ou à toute API spécifique de Windows.

Prise en charge des formats

Quels formats OneNote puis-je lire ?

La bibliothèque lit les trois variantes binaires de OneNote :

Formats	Extension	Lire	écrire
OneNote 2010 à venir	`.one`	✓	—
OneNote 2007 à venir	`.one`	✓	—
OneNote en ligne	`.one`	✓	—
PDF	`.pdf`	—	✓

Utilisez le FileFormat Propriété sur un chargement Document Pour déterminer quelle variante a été détectée :

from aspose.note import Document

doc = Document("notebook.one")
print(doc.FileFormat)  # e.g. FileFormat.OneNote2010

Puis-je exporter des documents OneNote en PDF?

Oui, le Pass SaveFormat.Pdf Le deuxième argument à Document.Save():

from aspose.note import Document, SaveFormat

doc = Document("notebook.one")
doc.Save("output.pdf", SaveFormat.Pdf)

Vous pouvez également enregistrer dans un tampon mémoire en passant une BytesIO Objet au lieu d’un chemin de fichier.

Puis-je enregistrer à nouveau le format OneNote ?

La bibliothèque lit .one fichiers mais seulement les exportations vers PDF. Appel Document.Save() avec Un format non PDF est disponible UnsupportedSaveFormatException.Utilisez SaveFormat.Pdf pour tous Sauvegarder les opérations.

Utilisation de l’API

Comment télécharger un fichier OneNote ?

Instanté Document Avec le fichier Path :

from aspose.note import Document

doc = Document("notebook.one")

Document est la racine du modèle objet. Page, Outline,et RichText Nôtre Le fichier est accessible à partir de cette racine.

Comment puis-je répéter les pages et leur contenu texte ?

Utilisez GetChildNodes() Pour récupérer les nœuds d’enfant tapés à tout niveau de l’arbre:

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)

Comment créer un document à partir de zéro ?

Construisez les nœuds en haut et en bas et attachez-les avec 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)

Comment puis-je lire les métadonnées de la page, telles que l’auteur et le temps de création?

Chaque Page Node exposé Author, CreationTime,et LastModifiedTime comme des propriétés. Le Title Node fournit TitleText, TitleDate,et TitleTime comme RichText Les enfants :

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}")

Limitations connues

Y a-t-il des limites que je dois connaître ?

La version actuelle (26.3.2) se concentre sur la lecture de OneNote .one fichiers et Exportation vers d’autres formats de raster ou vecteur (PNG, SVG, HTML) n’est pas possible. disponible dans cette édition.

Puis-je contrôler les options d’exportation PDF, telles que la taille de page ou DPI?

PDF est un format à écrire seulement (exportation) — la bibliothèque enregistre le contenu de OneNote dans PDF; PDF n’est pas accepté comme format d’entrée. Les options de sauvegarde avancées PDF ne sont pas exposées dans la surface API actuelle. Document.Save() Méthode avec SaveFormat.Pdf Si vous avez besoin d’un contrôle de sortie finement grain, appliquez des ajustements supplémentaires au fichier résultant à l’aide d’un outil PDF dédié.

Les dimensions d’image sont-elles disponibles sur les nœuds d’image?

Image Les nœuds exposent deux paires d’attributs de dimension. Width et Height sont muables attributs que vous pouvez lire et définir pour contrôler la taille de l’affichage. OriginalWidth et OriginalHeight sont des propriétés uniquement lisibles qui renvoient les dimensions d’image originales. 4 Retour float | None.