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

Aspose.Note FOSS for Python

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

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

문서 GitHub

원노트 파일용 오픈 소스 파이썬 라이브러리

파이썬용 FOSS는 100% 무료 MIT 라이선스 라이브러리로, 마이크로소프트 오피스, COM 자동화 및 독점 실행 시간이 필요하지 않은 파이톤에서 완전히 Microsoft OneNote (.one) 파일을 읽을 수 있습니다. 그것은 친숙한 .NET 인터페이스에 모델링 된 깨끗한 공개 API (aspose.note.*), 순수한 Python로 작성된 내장 MS-ONE / OneStore 바이너리 파서를 지원합니다.

PyPI에서 pip install aspose-note (또는 PDF 수출을 활성화하기 위해 pip install "aspose-note[pdf]") 로 설치. 파이썬 3.10 이상이 필요합니다.

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

OneNote 문서를 읽고 이동

  • Load .one files: Document를 통해 파일 경로나 바이너리 스트림에서 어떤 OneNote 섹션을 열지.
  • Full DOM traversal: Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile를 탐색합니다.
  • 강한 텍스트 추출: RichText.Text를 통해 원본을 읽거나, 대담함, 간판 글자, 폰트, 색상 및 하이퍼링크 메타데이터를 위해 TextRun 세그먼트를 검사합니다.
  • ** 테이블 분석:** Table → TableRow → TableCell 계층을 가로지르고, TableColumn.Width를 통해 열 너비 를 읽는다.
  • 표자 검사: NoteTag에서 텍스트, 이미지 및 테이블 노드에 대한 메타데이터 ( 모양, 레이블, 색상, 완성 상태) 를 읽어보십시오.

Aspose.Note FOSS 가 사용 될 수 있는 곳

  • 콘텐츠 인덱싱: 검색 파이프라인에서 OneNote 아카이브의 모든 텍스트를 추출하고 인декс화합니다.
  • ** 문서 마이그레이션:** OneNote 섹션을 PDF, 일반 텍스트 또는 구조화된 데이터로 수출합니다.
  • ** 아카이브 도구:** .one 파일에서 디스크에 삽입된 이미지 및 첨부 파일을 저장합니다.
  • CI/CD 워크플로우: Docker 컨테이너 내에서 OneNote 콘텐츠를 확인하거나 처리합니다.
  • 지식 기반 파이프라인: 팀의 OneNote 노트북에서 구조화된 콘텐츠를 추출합니다.

수출, 이미지 및 첨부 파일

  • PDF 수출: 로드된 Document을 PDF에 저장하여 Document.Save(path, SaveFormat.Pdf)를 사용하십시오. FOSS 버전은 기본 렌더링을 사용합니다; 이 릴리즈에서는 페이지 당 고급 PDF 옵션이 제공되지 않습니다.
  • ** 이미지 수출:** Image 노드를 반복하여 원시 바이트 (Bytes), 파일명 ({FileName}) 및 크기 ( {OriginalWidth}}, OriginalHeight}}를 검색합니다.
  • ** 첨부 파일을 저장:** AttachedFile 노드를 반복하여 디스크에 임베디드 파일 첨가 파일을 보관합니다.
  • ** 스트림 기반 로딩:** 디스크에 기록하지 않고도 바이너리 스트림을 통해 .one 파일을 열기 (예를 들어, io.BytesIO).

개발자 경험

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

API은 .NET 인터페이스를 위한 친숙한 Aspose.Note을 모델로 합니다: 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는 무엇입니까?

마이크로소프트 오피스, COM 자동화 또는 독점 실행 시간을 필요로하지 않고 Microsoft OneNote (.one) 파일을 읽을 수있는 무료 MIT 라이선스를 가진 파이썬 라이브러리입니다.

어떤 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 응답체) 받아 들여 디스크에 기록하지 않고 파일을 처리할 수 있습니다.

파이썬 버전이 필요한가요?

파이썬 3.10 이상이 필요합니다.

.one 파일을 작성하거나 수정할 수 있나요?

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

암호화된 OneNote 문서는 지원되나요?

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

소스 코드를 어디서 찾을 수 있을까요?

라이브러리는 MIT에서 사용 허가받았고 GitHub에 호스팅되어 있습니다. 버그 보고와 롤 요청은 환영합니다.

  

지원 및 학습 자료

 한국어