Jak začít s FOSS pro Python?

Jak začít s FOSS pro Python?

aspose-note for Python er et gratis, MIT-licenseret bibliotek til at læse og konvertere Microsoft OneNote.one` filer til PDF ingen Microsoft Office kræves, ingen native udvidelser, ren Python fra PyPI .

Trin-for-trin vejledning

  • Jeg er ikke i gang.

Trin 1: Installer pakken

Installer fra PyPI med pip:

pip install aspose-note>=26.3.2

Kontrollér, at installationen er korrekt indlæst:

from aspose.note import Document
print("aspose-note is ready.")

Trin 2: Import af krævede klasser

Import af de moduler, du har brug for til at indlæse dokumenter, krydse knudepunkter og gemme:

from aspose.note import Document, Page, Outline, RichText, SaveFormat

Trin 3: Lade en OneNote-fil op

Pass en filvej til Document for at indlæse et hvilket som helst understøttet OneNote-format. Brug egenskaben ̋FileFormat⌒ for, hvilken variant der blev opdaget:

from aspose.note import Document

doc = Document("notebook.one")
print(f"Format : {doc.FileFormat}")
print(f"Pages  : {len(list(doc))}")

Trin 4: Gennemse siderne og læs teksten

Brug `GetChildNodes (() ̋ til at hente alle ∂Page∂ noder, og bogfør derefter ned til ˆRichText∂ leafnoder for at læse den faktiske tekstindhold:

from aspose.note import Document, Page, RichText

doc = Document("notebook.one")
for page in doc.GetChildNodes(Page):
    if page.Title and page.Title.TitleText:
        print(f"Page: {page.Title.TitleText}")
    for rt in page.GetChildNodes(RichText):
        text = "".join(rt)
        if text.strip():
            print(f"  {text[:120]}")

Trin 5: Eksport til PDF-fil

`Document.Save()⌒ accepterer ̋SavesFormat.Pdf∂ til at skrive en PDF-fil. Eksporten foregår helt under processen uden nogen ekstern rendering:

import io
from aspose.note import Document, SaveFormat

doc = Document("notebook.one")

# Save to a file
doc.Save("output.pdf", SaveFormat.Pdf)

# Save to an in-memory buffer
buf = io.BytesIO()
doc.Save(buf, SaveFormat.Pdf)
print(f"PDF bytes: {len(buf.getvalue())}")
  • Jeg er ikke i gang.

Almindelige problemer og løsninger

ModuleNotFoundError: Der er ingen modul med navnet 'aspose' Pakken er ikke installeret i det aktive Python-miljø. Run ̋pip install aspose-note∂ i samme virtuelle miljø, som du bruger til at køre dit script. Bekræft med ̨pipp show aspuse-not∂.

FileNotFoundError når du ringer til ̋Document(“path”)̅ Den vej, du har kørt igennem, findes ikke eller bruger den forkerte separator. Brug ∂ pathlib.Path⌒ til at konstruere veje på en bærbar måde:

from pathlib import Path
from aspose.note import Document

doc = Document(str(Path("folder") / "notebook.one"))

GetChildNodes()⌒ returnerer en tom liste Sørg for, at du kalder ̋Get ChildNods ((Page) på ∂Documentrooten og ikke på en ゚Pagenet node ̇ når du forventer børn på sideniveau. Hvert trin i træet returnere kun sine egne direkte efterkommere af den angivne type.

PDF-udgangen er tom eller mangler indhold PDF rendereren læser `RichText⌒ nodes. Hvis filen kun indeholder billeder eller vedhæftede filer uden ̋RICHTEXT∂ nodeer, vil PDF siderne være tomme. Undersøg dokumenttræet for at kontrollere, om ̨RicchTeXT゚ nodeerne findes og indeholder tekst.

page.Title er ̋None⌒ Ikke alle sider har en titel. Vær altid opmærksom på: ∂if side.Titel og side .Titl.titleText: …゚ før du åbner for titleteksten, så du undgår AttributeError゚.

Ofte stillede spørgsmål

Er det nødvendigt med Microsoft Office i aspose-note?

Biblioteket læser OneNote binært format og eksporterer til PDF på rent Python uden at være afhængig af Microsoft Office, COM-automatisering eller Windows API’er.

Hvilke Python-versioner understøttes?

Python 3.10 eller nyere. Pakken kører på Windows, macOS, Linux, Docker-containere og serverløse funktioner.

Er biblioteket gratis til kommerciel brug?

Ja. Den er udgivet under MIT-licensen. Du kan bruge, ændre og videregiv den til ethvert formål, herunder kommercielle applikationer.

Kan jeg skrive nye OneNote-filer fra bunden?

Ja. Opbyg et dokument ved hjælp af Document(), tilføj ̋Page゚-noder via ∂AppendChildLast (), vedhæft ̆Outline (∂) og ̨RichText (≈) -børn, og eksporter til PDF med ̇Dokument.Save (√“output.pdf”, SaveFormat.Pdf) ̊. Gemme tilbage til ゙.one (∆) format er ikke understøttet.

Kan jeg gemme til andre formater end PDF?

Den nuværende udgave 26.3.2 understøtter kun eksport til PDF. Det er ikke muligt at gemme tilbage til OneNote .one-format eller eksportere til PNG, HTML eller andre formater i denne FOSS-udgave.

Se også:

  • FAQ Aspose.Note FOSS for Python
  • Hvordan eksporterer man en OneNote-fil til PDF i Python
  • Hvordan man udtrækker tekst fra OneNote i Python
  • Begyndelse Docs
  • API-reference
 Dansk