Převod prezentací PowerPoint do Markdownu v Pythonu přes Java

O čem je tato stránka

Převod prezentací PPT a PPTX do Markdownu v Pythonu přes Java a řízení, kde jsou exportované bitmapové, metafile a SVG obrázky uloženy a na které odkazy se odkazuje.

Přehled

Aspose.Slides pro Python přes Java může převádět prezentace PPT a PPTX do Markdownu pro dokumentaci, statické weby, migraci obsahu a workflow verzování. Můžete si vybrat variantu Markdownu, řídit, jak je obsah snímků vykreslen, a rozhodnout, kde jsou exportované obrázky uloženy a jak na ně generovaný Markdown odkazuje.

Ve výchozím nastavení export do Markdownu používá výstup pouze s textem. Pro export vizuálního obsahu nastavte typ exportu metodou MarkdownSaveOptions.setExportType na hodnotu Sequential nebo Visual z výčtu MarkdownExportType. Sequential vykresluje položky snímku samostatně a v pořadí, zatímco Visual zachovává seskupené položky společně, aby se udržel jejich vizuální vztah. Hodnota TextOnly nevytváří obrazové zdroje, takže v tomto režimu není volána žádná zpětná volání pro ukládání obrázků.

Převést prezentaci do Markdownu

Načtěte zdrojový soubor pomocí třídy Presentation a poté zavolejte metodu Presentation.save s hodnotou Md z výčtu SaveFormat.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    presentation.save("presentation.md", SaveFormat.Md)
finally:
    presentation.dispose()

Každý příklad čte soubor presentation.pptx z aktuálního pracovního adresáře. Před spuštěním příkladů nainstalujte Aspose.Slides pro Python přes Java a kompatibilní Java runtime. JVM spusťte jednou na jeden Python proces.

Vybrat variantu Markdownu

Metoda MarkdownSaveOptions.setFlavor určuje, která specifikace Markdownu se použije pro výstup. Výčet Flavor zahrnuje CommonMark, GitHub Flavored Markdown a další podporované varianty.

Následující příklad exportuje prezentaci jako CommonMark:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Flavor, MarkdownSaveOptions, Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    options = MarkdownSaveOptions()
    options.setFlavor(Flavor.CommonMark)

    presentation.save("presentation.md", SaveFormat.Md, options)
finally:
    presentation.dispose()

Exportovat obrázky pomocí výchozího lokálního ukládání

Třída MarkdownSaveOptions poskytuje dvě metody pro konfiguraci lokálně uložených obrázků:

setBasePath určuje základní adresář pro dokument Markdown a jeho zdroje.
setImagesSaveFolderName určuje podadresář pro obrázky. Výchozí hodnota je Images.

Následující příklad vykresluje vizuální obsah, zapisuje obrázky do output/assets a vytváří relativní odkazy na obrázky v dokumentu Markdown:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from pathlib import Path
from asposeslides.api import MarkdownExportType, MarkdownSaveOptions, Presentation, SaveFormat

output_directory = Path("output")
output_directory.mkdir(parents=True, exist_ok=True)

presentation = Presentation("presentation.pptx")
try:
    options = MarkdownSaveOptions()
    options.setExportType(MarkdownExportType.Visual)
    options.setBasePath(str(output_directory))
    options.setImagesSaveFolderName("assets")

    markdown_path = output_directory / "presentation.md"
    presentation.save(str(markdown_path), SaveFormat.Md, options)
finally:
    presentation.dispose()

Toto chování také slouží jako náhradní řešení, když vlastní handler pro ukládání obrázků vrátí False.

Přizpůsobit ukládání obrázků a odkazy v Markdownu

Použijte metodu MarkdownSaveOptions.setImageSaving k registraci zpětné volání pro bitmapové a metafile zdroje, které nejsou ve formátu SVG, a jsou emitovány během exportu do Markdownu. Jeho callback MarkdownImageSavingHandler přijímá objekt obrázku, jeho hodnotu ImageFormat a vygenerovaný odkaz v Markdownu jako jednoprvkový parametr String[]. Uložte nebo nahrajte obrázek ve zvoleném formátu a nahraďte link[0] odkazem, který má být v Markdown výstupu.

Zdroje emitované ve formátu SVG se zpracovávají odděleně. Registrovat zpětnou volání pomocí metody MarkdownSaveOptions.setSvgImageSaving. Jeho callback MarkdownSvgImageSavingHandler přijímá objekt SvgImage a jednoprvkový parametr String[] link. SVG nemá argument ImageFormat; místo toho zapište nebo nahrajte jeho XML data pomocí metody SvgImage.getSvgData. V závislosti na režimu exportu a vizuálním seskupení může být SVG v zdrojové prezentaci rasterizováno nebo sloučeno s jiným obsahem; výsledný ne‑SVG zdroj je pak předán callbacku pro ukládání obrázku. Zaregistrujte oba callbacky, pokud každý exportovaný vizuální zdroj vyžaduje vlastní zpracování.

Návratová hodnota handleru určuje, kdo obrázek zpracuje:

Vraťte True, pokud handler obrázek uložil, nahrál, transformoval nebo jinak zpracoval a přiřadil platnou hodnotu do link[0]. Aspose.Slides zapíše tuto hodnotu do dokumentu Markdown a neprovádí výchozí lokální uložení.
Vraťte False, aby Aspose.Slides uložil obrázek lokálně a vygeneroval odkaz podle hodnot nastavených metodami MarkdownSaveOptions.setBasePath a MarkdownSaveOptions.setImagesSaveFolderName.

Důležité

Handler, který vrátí True, přebírá odpovědnost za obrázek. Pokud vrátí True bez přiřazení platného, ne‑prázdného odkazu, export selže s výjimkou InvalidOperationException.

V Pythonu zaregistrujte tyto callbacky pomocí jpype.JProxy, implementující Java rozhraní callbacku prostřednictvím jeho metody invoke. Argument link je měnitelné pole řetězců Java: před zpracováním převěďte link[0] na Python řetězec, poté přiřaďte nahrazující URL zpět do link[0].

Uložit obrázky do adresáře CDN origin a použít externí URL

Následující příklad zachází s cdn-origin/presentations/quarterly-report jako připojeným nebo synchronizovaným CDN origin adresářem. Každý handler získá vygenerovaný název souboru, uloží obrázek do tohoto vlastního adresáře a nahradí lokální odkaz veřejnou CDN URL. Samotný příklad neprovádí žádné síťové nahrávání: URL je platná až po připojení adresáře jako CDN origin nebo po publikaci souborů na CDN. Pro objektové úložiště nahraďte zápis do souborového systému operací nahrání SDK úložiště a přiřaďte link[0] až po úspěšném nahrání.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from pathlib import Path
from urllib.parse import quote
from asposeslides.api import MarkdownExportType, MarkdownSaveOptions, Presentation, SaveFormat

output_directory = Path("output")
public_base_url = "https://cdn.example.com/presentations/quarterly-report"
storage_directory = Path("cdn-origin", "presentations", "quarterly-report")
output_directory.mkdir(parents=True, exist_ok=True)
storage_directory.mkdir(parents=True, exist_ok=True)

def get_file_name(generated_link):
    normalized_link = str(generated_link).replace("\\", "/")
    return normalized_link.rsplit("/", 1)[-1]

def save_image(image, image_format, link):
    if image.getWidth() < 128 or image.getHeight() < 128:
        return False

    file_name = get_file_name(link[0])
    storage_path = storage_directory / file_name
    image.save(str(storage_path), image_format)
    encoded_file_name = quote(file_name, safe="")
    link[0] = public_base_url + "/" + encoded_file_name
    return True

def save_svg(svg_image, link):
    file_name = get_file_name(link[0])
    storage_path = storage_directory / file_name
    svg_data = svg_image.getSvgData()
    try:
        storage_path.write_bytes(bytes(svg_data))
    except OSError as error:
        print(f"Could not save the SVG image: {error}")
        return False

    encoded_file_name = quote(file_name, safe="")
    link[0] = public_base_url + "/" + encoded_file_name
    return True

image_handler = jpype.JProxy("com.aspose.slides.MarkdownSaveOptions$MarkdownImageSavingHandler", dict(invoke=save_image))
svg_handler = jpype.JProxy("com.aspose.slides.MarkdownSaveOptions$MarkdownSvgImageSavingHandler", dict(invoke=save_svg))

presentation = Presentation("presentation.pptx")
try:
    options = MarkdownSaveOptions()
    options.setExportType(MarkdownExportType.Visual)
    options.setBasePath(str(output_directory))
    options.setImagesSaveFolderName("fallback-images")
    options.setImageSaving(image_handler)
    options.setSvgImageSaving(svg_handler)

    markdown_path = output_directory / "presentation.md"
    presentation.save(str(markdown_path), SaveFormat.Md, options)
finally:
    presentation.dispose()

Bitmapový handler úmyslně vrací False pro obrázky menší než 128 × 128 pixelů, takže Aspose.Slides ukládá tyto obrázky do output/fallback-images pomocí výchozího chování. Větší bitmapy a metafile zdroje, stejně jako SVG zdroje, jsou zpracovány vlastním kódem. Například vygenerovaný lokální odkaz jako fallback-images/image1.png se změní na https://cdn.example.com/presentations/quarterly-report/image1.png. Handlery používají cesty operačního systému jen při zápisu souborů; odkazy zapisované do Markdownu používají lomítka a URL‑kódované názvy souborů. Používejte stejný pravidlo i při vytváření relativních odkazů: použijte /, ne platformově specifický oddělovač adresářů.

Často kladené otázky

Může jeden handler zpracovávat jak rastrové obrázky, tak SVG obrázky?

Ne. Použijte MarkdownSaveOptions.setImageSaving pro bitmapové a metafile zdroje a MarkdownSaveOptions.setSvgImageSaving pro zdroje emitované jako SVG. První poskytuje objekt obrázku a hodnotu ImageFormat; druhý poskytuje objekt SvgImage, jehož SVG data lze načíst metodou SvgImage.getSvgData. SVG zdroj, který je během exportu rasterizován, je zpracován pomocí callbacku pro ukládání obrázku.

Co se stane, když handler pro ukládání obrázků vrátí False?

Aspose.Slides použije své výchozí chování lokálního ukládání. Umístění obrázku a vygenerovaný odkaz jsou řízeny hodnotami nastavenými pomocí MarkdownSaveOptions.setBasePath a MarkdownSaveOptions.setImagesSaveFolderName.

Může handler poskytnout URL bez lokálního uložení obrázku?

Ano. Handler může obrázek nahrát do objektového úložiště nebo jej předat jinému servisu, přiřadit vzniklou URL do link[0] a vrátit True. Handler musí zpracování dokončit sám; vrácení True zabraňuje výchozímu lokálnímu uložení.

Proč export do Markdownu vyvolá InvalidOperationException z handleru?

Tato výjimka nastane, když handler vrátí True, ale neposkytne platný odkaz. Před vrácením True přiřaďte relativní cestu nebo externí URL, která má být zapsána do Markdownu.

Jaký oddělovač cesty by měly používat odkazy na obrázky?

V Markdown odkazech a URL používejte lomítka (/). Pro cesty souborového systému používejte pathlib.Path, pak samostatně vytvořte nebo normalizujte odkaz v Markdownu.

Zachovají se hypertextové odkazy během exportu do Markdownu?

Ano. Textové hyperlinky jsou zachovány jako standardní Markdown odkazy. Přechody a animace snímků nejsou konvertovány.

Lze prezentace převádět do Markdownu paralelně?

Můžete zpracovávat různé soubory prezentací paralelně, ale nesdílejte stejnou instanci Presentation mezi vlákny. Dodržujte pokyny pro multithreading a použijte samostatnou instanci pro každý soubor.

Převod prezentací PowerPoint na video v Pythonu Převod prezentací PowerPoint do XML v Pythonu přes Java