Konvertera PowerPoint-presentationer till Markdown på Android

Vad den här sidan handlar om

Konvertera PPT- och PPTX-presentationer till Markdown på Android via Java och kontrollera var exporterade bitmap-, metafil- och SVG-bilder sparas och refereras.

Översikt

Aspose.Slides för Android via Java kan konvertera PPT‑ och PPTX‑presentationer till Markdown för dokumentation, statiska webbplatser, innehållsmigrering och versionskontrollarbetsflöden. Du kan välja en Markdown‑variant, kontrollera hur bildinnehållet renderas och bestämma var exporterade bilder lagras samt hur den genererade Markdown‑referensen ser ut.

Som standard använder Markdown‑export text‑endast‑utdata. För att exportera visuellt innehåll, ange exporttypen med metoden MarkdownSaveOptions.setExportType till värdet Sequential eller Visual från uppräkningen MarkdownExportType. Sequential renderar bildobjekt separat och i ordning, medan Visual behåller grupperade objekt tillsammans för att bevara deras visuella relation. Värdet TextOnly emitterar inte bildresurser, så bild‑sparande‑återuppringningarna anropas inte i det läget.

Konvertera en presentation till Markdown

Läs in källfilen med klassen Presentation och anropa sedan metoden Presentation.save med värdet Md från uppräkningen SaveFormat.

import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("presentation.pptx");
try {
    presentation.save("presentation.md", SaveFormat.Md);
} finally {
    presentation.dispose();
}

Välj en Markdown‑variant

Metoden MarkdownSaveOptions.setFlavor styr vilken Markdown‑specifikation som används för utdata. Uppräkningen Flavor innehåller CommonMark, GitHub Flavored Markdown och andra stödjade varianter.

Följande exempel exporterar en presentation som CommonMark:

import com.aspose.slides.Flavor;
import com.aspose.slides.MarkdownSaveOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("presentation.pptx");
try {
    MarkdownSaveOptions options = new MarkdownSaveOptions();
    options.setFlavor(Flavor.CommonMark);

    presentation.save("presentation.md", SaveFormat.Md, options);
} finally {
    presentation.dispose();
}

Exportera bilder med standardlokal‑sparbeteende

Klassen MarkdownSaveOptions tillhandahåller två metoder för att konfigurera lokalt sparade bilder:

setBasePath specificerar basmappen för Markdown‑dokumentet och dess resurser.
setImagesSaveFolderName specificerar bildundermappen. Standardvärdet är Images.

Följande exempel renderar visuellt innehåll, skriver bilder till output/assets och skapar relativa bildreferenser i Markdown‑dokumentet:

import com.aspose.slides.MarkdownExportType;
import com.aspose.slides.MarkdownSaveOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

Path outputDirectory = Paths.get("output");
Files.createDirectories(outputDirectory);

Presentation presentation = new Presentation("presentation.pptx");
try {
    MarkdownSaveOptions options = new MarkdownSaveOptions();
    options.setExportType(MarkdownExportType.Visual);
    options.setBasePath(outputDirectory.toString());
    options.setImagesSaveFolderName("assets");

    Path markdownPath = outputDirectory.resolve("presentation.md");
    presentation.save(markdownPath.toString(), SaveFormat.Md, options);
} finally {
    presentation.dispose();
}

Detta beteende fungerar också som återfall när en anpassad bild‑sparande‑återuppringning returnerar false.

Anpassa bildsparande och Markdown‑länkar

Använd metoden MarkdownSaveOptions.setImageSaving för att registrera en återuppringning för icke‑SVG‑bitmap‑ och metafilresurser som emitteras under Markdown‑export. Dess MarkdownImageSavingHandler‑återuppringning får objektet IImage, dess ImageFormat-värde och den genererade Markdown‑länken som ett en‑element String[]‑parameter. Spara eller ladda upp bilden med det angivna formatet och ersätt link[0] med referensen som ska förekomma i Markdown‑utdata.

Resurser som emitteras i SVG‑format hanteras separat. Registrera en återuppringning med metoden MarkdownSaveOptions.setSvgImageSaving. Dess MarkdownSvgImageSavingHandler‑återuppringning får ett ISvgImage-objekt och det en‑element String[] link‑parametern. En SVG har inget ImageFormat‑argument; skriv eller ladda upp dess XML‑data från metoden ISvgImage.getSvgData istället. Beroende på exportläge och visuell gruppering kan en SVG i källpresentationen rasteriseras eller kombineras med annat innehåll; den resulterande icke‑SVG‑resursen skickas sedan till bild‑sparande‑återuppringningen. Registrera båda återuppringningarna när varje exporterad visuell resurs kräver anpassad behandling.

Returvärdet från återuppringningen bestämmer vem som bearbetar bilden:

Returnera true efter att återuppringningen har sparat, laddat upp, transformerat eller på annat sätt bearbetat bilden och tilldelat ett giltigt värde till link[0]. Aspose.Slides skriver det värdet till Markdown‑dokumentet och utför inte sin standardsparning lokalt.
Returnera false för att låta Aspose.Slides spara bilden lokalt och generera länken enligt de värden som satts med MarkdownSaveOptions.setBasePath och MarkdownSaveOptions.setImagesSaveFolderName.

Important

En återuppringning som returnerar true tar ansvar för bilden. Om den returnerar true utan att tilldela en giltig, icke‑tom länk misslyckas exporten med ett InvalidOperationException.

Spara bilder i en CDN‑ursprungs‑katalog och använd externa URL:er

Följande exempel behandlar cdn-origin/presentations/quarterly-report som en monterad eller synkroniserad CDN‑ursprungs‑katalog. Varje återuppringning extraherar det genererade filnamnet, sparar bilden i den anpassade katalogen och ersätter den genererade lokala referensen med en publik CDN‑URL. Själva exemplet utför ingen nätverksuppladdning: URL:en blir giltig först när katalogen är monterad som CDN‑ursprung eller dess filer har publicerats till CDN. För objektlagring, ersätt filsystems‑skrivningen med lagrings‑SDK:ns uppladdningsoperation och tilldela link[0] först efter att uppladdningen lyckats.

import com.aspose.slides.MarkdownExportType;
import com.aspose.slides.MarkdownSaveOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.function.Function;

Path outputDirectory = Paths.get("output");
String publicBaseUrl = "https://cdn.example.com/presentations/quarterly-report";
Path storageDirectory = Paths.get("cdn-origin", "presentations", "quarterly-report");
Files.createDirectories(outputDirectory);
Files.createDirectories(storageDirectory);

Function<String, String> getFileNameFromLink = generatedLink -> {
    String urlCompatibleLink = generatedLink.replace('\\', '/');
    return urlCompatibleLink.substring(urlCompatibleLink.lastIndexOf('/') + 1);
};
Function<String, String> buildPublicUrl = fileName -> {
    try {
        String encodedFileName = URLEncoder.encode(fileName, "UTF-8").replace("+", "%20");
        return publicBaseUrl + "/" + encodedFileName;
    } catch (UnsupportedEncodingException exception) {
        System.err.println("Could not encode the image file name: " + exception.getMessage());
        return null;
    }
};

Presentation presentation = new Presentation("presentation.pptx");
try {
    MarkdownSaveOptions options = new MarkdownSaveOptions();
    options.setExportType(MarkdownExportType.Visual);
    options.setBasePath(outputDirectory.toString());
    options.setImagesSaveFolderName("fallback-images");

    options.setImageSaving((image, format, link) -> {
        if (image.getWidth() < 128 || image.getHeight() < 128) {
            return false;
        }

        String fileName = getFileNameFromLink.apply(link[0]);
        String publicUrl = buildPublicUrl.apply(fileName);
        if (publicUrl == null) {
            return false;
        }
        Path storagePath = storageDirectory.resolve(fileName);
        image.save(storagePath.toString(), format);
        link[0] = publicUrl;
        return true;
    });

    options.setSvgImageSaving((svgImage, link) -> {
        String fileName = getFileNameFromLink.apply(link[0]);
        String publicUrl = buildPublicUrl.apply(fileName);
        if (publicUrl == null) {
            return false;
        }
        Path storagePath = storageDirectory.resolve(fileName);
        try {
            Files.write(storagePath, svgImage.getSvgData());
        } catch (IOException exception) {
            System.err.println("Could not save the SVG image: " + exception.getMessage());
            return false;
        }
        link[0] = publicUrl;
        return true;
    });

    Path markdownPath = outputDirectory.resolve("presentation.md");
    presentation.save(markdownPath.toString(), SaveFormat.Md, options);
} finally {
    presentation.dispose();
}

Bitmap‑återuppringningen returnerar avsiktligt false för bilder mindre än 128 × 128 pixlar, så Aspose.Slides sparar dessa bilder i output/fallback-images med standardbeteendet. Större bitmap‑ och metafilresurser samt SVG‑resurser hanteras av den anpassade koden. Till exempel blir en genererad lokal referens som fallback-images/image1.png till https://cdn.example.com/presentations/quarterly-report/image1.png. Återuppringningarna använder operativsystemets sökvägar endast vid filskrivning; länkar som skrivs till Markdown använder snedstreck och URL‑kodade filnamn. Tillämpa samma regel när du bygger relativa länkar: använd /, inte den plattforms‑specifika katalogseparatoren.

FAQ

Kan en återuppringning behandla både rasterbilder och SVG‑bilder?

Nej. Använd MarkdownSaveOptions.setImageSaving för emitterade bitmap‑ och metafilresurser och MarkdownSaveOptions.setSvgImageSaving för resurser som emitteras som SVG. Den förstnämnda ger ett IImage-objekt och ett ImageFormat-värde; den senare ger ett ISvgImage-objekt vars SVG‑data kan läsas med ISvgImage.getSvgData. En SVG‑källa som rasteriseras under export behandlas av bild‑sparande‑återuppringningen istället.

Vad händer när en bild‑sparande‑återuppringning returnerar false?

Aspose.Slides använder sitt standardsparbeteende lokalt. Bildens plats och den genererade referensen styrs av de värden som satts med MarkdownSaveOptions.setBasePath och MarkdownSaveOptions.setImagesSaveFolderName.

Kan en återuppringning tillhandahålla en URL utan att spara bilden lokalt?

Ja. Återuppringningen kan ladda upp bilden till objektlagring eller vidarebefordra den till en annan tjänst, tilldela den resulterande URL:en till link[0] och returnera true. Återuppringningen måste själv slutföra behandlingen; att returnera true hindrar den lokala standardsparningen.

Varför kastar Markdown‑export ett InvalidOperationException från en återuppringning?

Detta undantag uppstår när återuppringningen returnerar true men inte tillhandahåller en giltig länk. Tilldela den relativa sökvägen eller externa URL:en som ska skrivas till Markdown innan du returnerar true.

Vilken sökvägsseparator bör bildlänkar använda?

Använd snedstreck i Markdown‑länkar och URL:er. Använd Path.resolve endast för filsystem‑sökvägar och bygg eller normalisera Markdown‑referensen separat.

Bevaras hyperlänkar under Markdown‑export?

Ja. Text‑hyperlänkar bevaras som vanliga Markdown‑länkar. Bild‑övergångar och animationer konverteras inte.

Kan presentationer konverteras till Markdown parallellt?

Du kan bearbeta olika presentationsfiler parallellt, men dela inte samma Presentation‑instans mellan trådar. Följ multithreading guidelines och använd en separat instans för varje fil.

Konvertera PowerPoint-presentationer till video på Android Konvertera PowerPoint-presentationer till XML på Android