Як читати метадані сторінки з OneNote у Python

OneNote .one файли зберігають метадані, які можна прочитати без розбору повного DOM документа. На документ рівень, Document.FileFormat повідомляє, який варіант OneNote використовується у файлі. На сторінці рівень, кожен Page містить автора, час створення, час останньої модифікації та рівень ієрархії. Aspose.Note FOSS для Python надає їх через Document і Page класи.

Передумови

pip install aspose-note

Метадані на рівні документа

The Document об’єкт надає одну властивість метаданих:

Властивість	Тип	Опис
`doc.FileFormat`	`FileFormat`	Варіант OneNote: `FileFormat.OneNote2010`, `FileFormat.OneNoteOnline`, або `FileFormat.Unknown`.

from aspose.note import Document

doc = Document("MyNotes.one")
print(f"File format: {doc.FileFormat}")

Метадані на рівні сторінки

Кожен Page об’єкт містить:

Властивість	Тип	Опис
`page.Author`	`str	None`
`page.CreationTime`	`datetime	None`
`page.LastModifiedTime`	`datetime	None`
`page.Level`	`int	None`

Крок 1: Читання метаданих для кожної сторінки

from aspose.note import Document, Page

doc = Document("ProjectNotes.one")

for i, page in enumerate(doc, start=1):
    title = ""
    if page.Title and page.Title.TitleText:
        title = page.Title.TitleText.Text.strip()

    level = page.Level or 0
    indent = "  " * level

    author = page.Author or "(unknown)"
    created = page.CreationTime.strftime("%Y-%m-%d") if page.CreationTime else "(none)"
    modified = page.LastModifiedTime.strftime("%Y-%m-%d %H:%M") if page.LastModifiedTime else "(none)"

    print(f"{indent}[{i}] {title or '(untitled)'}")
    print(f"{indent}    Author:   {author}")
    print(f"{indent}    Created:  {created}")
    print(f"{indent}    Modified: {modified}")
    print(f"{indent}    Level:    {level}")

Повний приклад: звіт про метадані

from aspose.note import Document

def print_metadata_report(one_path: str) -> None:
    doc = Document(one_path)

    print()

    for i, page in enumerate(doc, start=1):
        title = ""
        if page.Title and page.Title.TitleText:
            title = page.Title.TitleText.Text.strip()

        level = page.Level or 0
        prefix = "  " * level + f"[{i}]"

        parts = [prefix, f'"{title or "(untitled)"}"']
        if page.Author:
            parts.append(f"by {page.Author}")
        if page.CreationTime:
            parts.append(f"created {page.CreationTime.strftime('%Y-%m-%d')}")
        if page.LastModifiedTime:
            parts.append(f"modified {page.LastModifiedTime.strftime('%Y-%m-%d')}")

        print("  ".join(parts))

print_metadata_report("ProjectNotes.one")

Виявлення підсторінок

У OneNote підсторінки візуально відступають під батьківську сторінку. Це page.Level властивість відображає цю ієрархію:

from aspose.note import Document

doc = Document("MyNotes.one")

for page in doc:
    level = page.Level or 0
    title = ""
    if page.Title and page.Title.TitleText:
        title = page.Title.TitleText.Text.strip()

    indent = "  " * level
    marker = "├─" if level > 0 else "•"
    print(f"{indent}{marker} {title or '(untitled)'}")

Значення рівня:

0: сторінка верхнього рівня
1: підсторінка першого рівня (один відступ)
2: підсторінка другого рівня (два відступи)

Примітки

Усі мітки часу (CreationTime, LastModifiedTime) є datetime об’єкти в UTC, коли присутні.
page.Level повертає None для сторінок, де рівень не зберігався у бінарному форматі. Обробляйте None як 0 використовуючи page.Level or 0.