はじめに
このガイドでは、pip install から数分で動作するスクリプトまで導きます。aspose-note は、Microsoft OneNote ファイルを Python だけで読み書きできる、無料かつ MIT ライセンスのライブラリで、Microsoft Office、COM 自動化、またはネイティブ拡張への依存はありません。
pip install aspose-note-fossPython 用の Aspose.Note FOSS とは何ですか？
OneNote の .one フォーマットは独自のバイナリコンテナで、Microsoft のライブラリがない状態で解析するには、従来、リバースエンジニアリングされたツールや Windows 固有の COM ブリッジが必要でした。Aspose.Note FOSS は、純粋な Python 実装を提供し、フォーマットを読み取り、Python 3.10 以降をサポートする任意のプラットフォームで PDF にエクスポートします。
このライブラリはドキュメントオブジェクトモデルを公開します：Document ルートが Page ノードを含み、各ノードは Title、Outline、RichText、Image、AttachedFile の子要素を保持することがあります。ツリーは GetChildNodes() で走査し、結果は Document.Save() を使って PDF にエクスポートします。フル機能ツアー（ノートブックのゼロからの構築を含む）については、Introducing Aspose.Note FOSS for Python を参照してください。
クイックスタート
以下は5行で示す全体のワークフローです — .one ファイルを読み込み、直接 PDF に保存します:
from aspose.note import Document, SaveFormat
# Load a .one file
doc = Document("notebook.one")
print(f"Format: {doc.FileFormat}")
# Save to PDF
doc.Save("notebook.pdf", SaveFormat.Pdf)
print("Saved notebook.pdf")
ページとテキストの読み取り
ページは Document 内の Page ノードです。各 Page は Title プロパティを持ち、RichText コンテンツを持つ Outline 要素を含めることができます。ツリーを走査するには GetChildNodes() を使用します:
from aspose.note import Document, Page, RichText
doc = Document("notebook.one")
for page in doc.GetChildNodes(Page):
title = page.Title
if title and title.TitleText:
print(f"Page: {title.TitleText}")
for rt in page.GetChildNodes(RichText):
text = "".join(rt)
if text.strip():
print(f" Text: {text[:80]}")
テキスト、画像、添付ファイル、テーブルの読み取りを詳しく知りたい場合は、Reading OneNote .one Files in Python with Aspose.Note FOSS を参照してください。
PDF への保存
ロードされた Document があれば、PDF への変換は 1 回の呼び出しで行えます: ファイルパスと SaveFormat.Pdf を Document.Save() に渡すと、ライブラリがノートブックをインプロセスで PDF にレンダリングします:
from aspose.note import Document, SaveFormat
doc = Document("notebook.one")
doc.Save("output.pdf", SaveFormat.Pdf)
メモリ内バッファ出力、バッチ変換、エクスポートのみの制限については、Exporting OneNote Files to PDF in Python を参照してください。
サポートされているフォーマット
| フォーマット | 拡張子 | 読み取り | 書き込み |
|---|---|---|---|
| OneNote 2010 | .one | ✓ | — |
| OneNote 2007 | .one | ✓ | — |
| OneNote オンライン | .one | ✓ | — |
.pdf | — | ✓ |
オープンソース & ライセンス
Aspose.Note FOSS for Python は MIT ライセンスの下でリリースされています。パッケージは PyPI に aspose-note として公開されており、商用利用、改変、再配布はすべて MIT の条件で許可されています。
