소개
이 가이드는 몇 분 안에 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을(를) 참고하십시오.
빠른 시작
전체 작업 흐름을 다섯 줄로 보여드립니다 — .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로 변환하는 것은 한 번의 호출로 가능합니다: 파일 경로와 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 조건에 따라 허용됩니다.
