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

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

Вимоги

pip install aspose-note

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

Об’єкт 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`	Коли сторінка була створена. Повертає об’єкт Python `datetime` у UTC.
`page.LastModifiedTime`	`datetime \| None`	Коли сторінка була останній раз змінена.
`page.Level`	`int \| None`	Рівень відступу підсторінки. `0` = сторінка верхнього рівня, `1` = підсторінка першого рівня, `2` = другого рівня тощо.

Крок 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.