1. 제품
  2.   Aspose.Note
  3.   Aspose.Note FOSS for Python

Aspose.Note FOSS - Aspose.Note Python용 FOSS

Microsoft OneNote (.one) 파일을 Python에서 읽고, 탐색하고, 내보냅니다 — 무료이며 오픈소스, Microsoft Office가 필요 없습니다.

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

문서 GitHub

OneNote 파일을 위한 오픈소스 Python 라이브러리

Aspose.Note FOSS for Python은 100% 무료이며 MIT-licensed 라이브러리로, Python에서 Microsoft OneNote (.one) 파일을 완전히 읽을 수 있게 해줍니다. Microsoft Office 없이, COM 자동화 없이, 독점 런타임 없이도 사용할 수 있습니다. 친숙한 Aspose.Note for .NET 인터페이스를 모델로 한 깔끔한 공개 API (aspose.note.*)를 제공하며, 순수 Python로 작성된 내장 MS-ONE/OneStore 바이너리 파서를 사용합니다.

PyPI에서 pip install aspose-note으로 설치합니다 (pip install "aspose-note[pdf]"를 사용하여 PDF 내보내기를 활성화). Python 3.10 이상이 필요합니다.

이 라이브러리는 문서 자동화 스크립트, 콘텐츠 인덱싱 파이프라인, 아카이브 도구 및 Microsoft Office 의존성 없이 OneNote 콘텐츠를 활용해야 하는 모든 서버 측 워크플로에 적합합니다. 엔터프라이즈 제품군에 대해서는 Aspose.Note — Enterprise Product Family을(를) 참조하십시오.

OneNote 문서를 읽고 탐색하기

  • .one 파일 로드: 파일 경로나 바이너리 스트림을 통해 Document으로 모든 OneNote 섹션을 엽니다.
  • 전체 DOM 탐색: Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile 탐색.
  • Rich text extraction: 원시 텍스트를 RichText.Text를 통해 읽거나 TextRun 세그먼트를 검사하여 굵게, 기울임, 글꼴, 색상 및 하이퍼링크 메타데이터를 확인합니다.
  • Table parsing: Table → TableRow → TableCell 계층을 순회하고; TableColumn.Width를 통해 열 너비를 읽습니다.
  • 태그 검사: 텍스트, 이미지 및 테이블 노드에서 NoteTag 메타데이터(모양, 레이블, 색상, 완료 상태)를 읽습니다.

Aspose.Note FOSS를 사용할 수 있는 곳

  • Content indexing: 검색 파이프라인을 위해 OneNote 아카이브에서 모든 텍스트를 추출하고 색인합니다.
  • Document migration: OneNote 섹션을 PDF, 일반 텍스트 또는 구조화된 데이터로 내보내기.
  • 아카이브 도구: .one 파일에서 삽입된 이미지와 첨부 파일을 디스크에 저장합니다.
  • CI/CD workflows: Docker 컨테이너 내부에서 OneNote 콘텐츠를 검증하거나 처리합니다.
  • Knowledge-base pipelines: 팀 OneNote 노트북에서 구조화된 콘텐츠를 추출합니다.

내보내기, 이미지 및 첨부 파일

  • PDF export: 로드된 Document를 Document.Save(path, SaveFormat.Pdf)을 사용하여 PDF로 저장합니다. FOSS 에디션은 기본 렌더링을 사용합니다; 고급 페이지별 PDF 옵션은 이번 릴리스에서 제공되지 않습니다.
  • Image export: Image 노드를 반복하여 원시 바이트 (Bytes), 파일 이름 (FileName), 및 차원 (OriginalWidth, OriginalHeight)을 가져옵니다.
  • 첨부 파일 저장: AttachedFile 노드를 반복하여 임베디드 파일 첨부를 디스크에 저장합니다.
  • 스트림 기반 로드: .one 파일을 바이너리 스트림(예: io.BytesIO)에서 디스크에 쓰지 않고 엽니다.

개발자 경험

Aspose.Note FOSS는 단일 pip install aspose-note 명령으로 설치됩니다. 기본 패키지는 선택적 종속성이 없으며; PDF 내보내기에는 ReportLab이 필요하고, pip install "aspose-note[pdf]"을 통해 설치됩니다.

API는 친숙한 Aspose.Note for .NET 인터페이스를 모델로 합니다: Document, Page, Outline, RichText, Image, Table, AttachedFile. 이 라이브러리는 MIT 라이선스를 갖춘 오픈 소스이며, GitHub에서 버그 보고 및 기여를 받습니다.

OneNote 파일을 로드하고 모든 텍스트를 추출합니다

pip으로 설치한 후, Document()에 파일 경로를 전달하여 OneNote 바이너리 형식을 구문 분석합니다. GetChildNodes(RichText)은 깊은 재귀 검색을 수행하고 문서의 모든 텍스트 노드를 반환하며, 이는 전체 텍스트 인덱싱이나 마이그레이션 파이프라인에 유용합니다.

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)

PDF로 내보내고 첨부된 이미지 저장

PDF 내보내기에는 선택적 ReportLab 종속성이 필요합니다. pip install "aspose-note[pdf]"을(를) 사용하여 설치하십시오. 동일한 Document 객체는 Image 노드를 반복하여 모든 포함된 이미지를 한 번에 디스크에 추출하고 저장할 수도 있습니다.

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)

자주 묻는 질문

Aspose.Note FOSS for Python은 무엇인가요?

이 라이브러리는 Microsoft Office, COM 자동화 또는 어떠한 독점 런타임도 필요 없이 Microsoft OneNote (.one) 파일을 읽기 위한 무료 MIT 라이선스 Python 라이브러리입니다.

지원되는 OneNote 형식 변형은 무엇인가요?

OneNote 2010, OneNote Online, 및 OneNote 2007 형식 변형. 유효한 .one 섹션 파일은 모두 로드할 수 있습니다.

어떻게 설치하나요?

기본 라이브러리의 경우 pip install aspose-note을 실행하고, PDF 내보내기를 위한 선택적 ReportLab 종속성을 포함하려면 pip install "aspose-note[pdf]"을 실행하십시오.

OneNote 파일을 PDF로 내보낼 수 있나요?

예. Document.Save(path, SaveFormat.Pdf)을 호출하십시오. PDF 내보내기에는 [pdf] 추가 기능을 통해 설치되는 선택적 ReportLab 종속성이 필요합니다.

.one 파일을 스트림에서 로드할 수 있나요?

예. Document 클래스는 바이너리 스트림(예: io.BytesIO 또는 HTTP 응답 본문)을 받아 디스크에 쓰지 않고 파일을 처리할 수 있습니다.

필요한 Python 버전은 무엇인가요?

Python 3.10 이상이 필요합니다.

.one 파일을 쓰거나 수정할 수 있나요?

아니요. 현재 버전은 읽기 전용입니다. 유효한 .one 섹션 파일을 열고 구문 분석할 수 있지만 OneNote 바이너리 형식으로 다시 쓰는 것은 지원되지 않습니다.

암호화된 OneNote 문서를 지원합니까?

아니요. 비밀번호로 보호된 .one 파일을 로드하면 IncorrectPasswordException이 발생합니다. 현재 버전에서는 암호화된 문서를 지원하지 않습니다.

소스 코드는 어디에서 찾을 수 있나요?

이 라이브러리는 MIT 라이선스를 따르며 GitHub에 호스팅됩니다. 버그 보고 및 풀 리퀘스트를 환영합니다.

  

지원 및 학습 자료

 한국어