Convertir presentaciones PowerPoint a Markdown en Android

De qué trata esta página

Convertir presentaciones PPT y PPTX a Markdown en Android mediante Java y controlar dónde se guardan y se referencian las imágenes exportadas (bitmap, metafile y SVG).

Descripción general

Aspose.Slides for Android via Java puede convertir presentaciones PPT y PPTX a Markdown para documentación, sitios estáticos, migración de contenidos y flujos de trabajo de control de versiones. Puedes elegir un sabor de Markdown, controlar cómo se renderiza el contenido de las diapositivas y decidir dónde se guardan las imágenes exportadas y cómo el Markdown generado las referencia.

De forma predeterminada, la exportación a Markdown utiliza salida solo de texto. Para exportar contenido visual, establece el tipo de exportación con el método MarkdownSaveOptions.setExportType a los valores Sequential o Visual del enumerado MarkdownExportType. Sequential renderiza los elementos de la diapositiva por separado y en orden, mientras que Visual mantiene los elementos agrupados juntos para preservar su relación visual. El valor TextOnly no emite recursos de imagen, por lo que los callbacks de guardado de imágenes no se invocan en ese modo.

Convertir una presentación a Markdown

Carga el archivo fuente con la clase Presentation y luego llama al método Presentation.save con el valor Md del enumerado 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();
}

Seleccionar una variante Markdown

El método MarkdownSaveOptions.setFlavor controla la especificación de Markdown utilizada para la salida. El enumerado Flavor incluye CommonMark, GitHub Flavored Markdown y otras variantes compatibles.

El siguiente ejemplo exporta una presentación como 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();
}

Exportar imágenes usando el comportamiento predeterminado de guardado local

La clase MarkdownSaveOptions proporciona dos métodos para configurar imágenes guardadas localmente:

setBasePath especifica el directorio base para el documento Markdown y sus recursos.
setImagesSaveFolderName especifica el subdirectorio de imágenes. Su valor predeterminado es Images.

El siguiente ejemplo renderiza contenido visual, escribe imágenes en output/assets y crea referencias de imágenes relativas en el documento Markdown:

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();
}

Este comportamiento también sirve como alternativa cuando un controlador personalizado de guardado de imágenes devuelve false.

Personalizar el guardado de imágenes y los enlaces Markdown

Utiliza el método MarkdownSaveOptions.setImageSaving para registrar un callback para recursos de mapa de bits y metafile que no sean SVG emitidos durante la exportación a Markdown. Su callback MarkdownImageSavingHandler recibe el objeto IImage, su valor ImageFormat y el enlace Markdown generado como un parámetro String[] de un solo elemento. Guarda o sube la imagen con el formato suministrado y reemplaza link[0] con la referencia que debe aparecer en la salida Markdown.

Los recursos emitidos en formato SVG se manejan por separado. Registra un callback con el método MarkdownSaveOptions.setSvgImageSaving. Su callback MarkdownSvgImageSavingHandler recibe un objeto ISvgImage y el parámetro String[] link de un solo elemento. Un SVG no tiene argumento ImageFormat; escribe o sube sus datos XML mediante el método ISvgImage.getSvgData en su lugar. Según el modo de exportación y el agrupamiento visual, un SVG en la presentación fuente puede rasterizarse o combinarse con otro contenido; el recurso no SVG resultante se pasa entonces al callback de guardado de imágenes. Registra ambos callbacks cuando cada recurso visual exportado requiere procesamiento personalizado.

El valor de retorno del controlador determina quién procesa la imagen:

Devuelve true después de que el controlador haya guardado, subido, transformado o procesado la imagen y haya asignado un valor válido a link[0]. Aspose.Slides escribe ese valor en el documento Markdown y no realiza su guardado local predeterminado.
Devuelve false para que Aspose.Slides guarde la imagen localmente y genere su enlace según los valores establecidos con MarkdownSaveOptions.setBasePath y MarkdownSaveOptions.setImagesSaveFolderName.

Importante

Un controlador que devuelve true asume la responsabilidad de la imagen. Si devuelve true sin asignar un enlace válido y no vacío, la exportación falla con una InvalidOperationException.

Guardar imágenes en un directorio de origen CDN y usar URLs externas

El siguiente ejemplo trata cdn-origin/presentations/quarterly-report como un directorio de origen CDN montado o sincronizado. Cada controlador extrae el nombre de archivo generado, guarda la imagen en ese directorio personalizado y reemplaza la referencia local generada con una URL pública de CDN. El ejemplo en sí no realiza ninguna subida a la red: la URL solo se vuelve válida después de que el directorio esté montado como origen CDN o sus archivos se publiquen en el CDN. Para almacenamiento de objetos, reemplaza la escritura en el sistema de archivos por la operación de subida del SDK de almacenamiento y asigna link[0] solo después de que la subida haya tenido éxito.

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();
}

El controlador de mapa de bits devuelve deliberadamente false para imágenes menores de 128 × 128 píxeles, por lo que Aspose.Slides guarda esas imágenes en output/fallback-images usando el comportamiento predeterminado. Los recursos de mapa de bits y metafile más grandes, así como los recursos SVG, son manejados por el código personalizado. Por ejemplo, una referencia local generada como fallback-images/image1.png se convierte en https://cdn.example.com/presentations/quarterly-report/image1.png. Los controladores usan rutas del sistema operativo solo al escribir archivos; los enlaces escritos en Markdown utilizan barras diagonales y nombres de archivo escapados en URL. Aplica la misma regla al crear enlaces relativos: usa /, no el separador de directorios propio de la plataforma.

FAQ

¿Puede un mismo controlador procesar tanto imágenes raster como imágenes SVG?

No. Utiliza MarkdownSaveOptions.setImageSaving para los recursos bitmap y metafile emitidos y MarkdownSaveOptions.setSvgImageSaving para los recursos emitidos como SVG. El primero proporciona un objeto IImage y un valor ImageFormat; el segundo proporciona un objeto ISvgImage cuyo dato SVG puede leerse con ISvgImage.getSvgData. Un SVG fuente que se rasteriza durante la exportación se procesa mediante el callback de guardado de imágenes.

¿Qué ocurre cuando un controlador de guardado de imágenes devuelve false?

Aspose.Slides utiliza su comportamiento predeterminado de guardado local. La ubicación de la imagen y la referencia generada se controlan con los valores establecidos mediante MarkdownSaveOptions.setBasePath y MarkdownSaveOptions.setImagesSaveFolderName.

¿Puede un controlador proporcionar una URL sin guardar la imagen localmente?

Sí. El controlador puede subir la imagen a un almacenamiento de objetos o pasarla a otro servicio, asignar la URL resultante a link[0] y devolver true. El controlador debe completar el procesamiento por sí mismo; devolver true impide el guardado local predeterminado.

¿Por qué la exportación a Markdown lanza una InvalidOperationException desde un controlador?

Esta excepción ocurre cuando el controlador devuelve true pero no proporciona un enlace válido. Asigna la ruta relativa o la URL externa que debe escribirse en Markdown antes de devolver true.

¿Qué separador de rutas deben usar los enlaces de imágenes?

Utiliza barras diagonales (/) en los enlaces Markdown y en las URLs. Usa Path.resolve solo para rutas del sistema de archivos y luego construye o normaliza la referencia Markdown por separado.

¿Se conservan los hipervínculos durante la exportación a Markdown?

Sí. Los hipervínculos de texto se conservan como enlaces Markdown estándar. Las transiciones y animaciones de las diapositivas no se convierten.

¿Pueden las presentaciones convertirse a Markdown en paralelo?

Puedes procesar diferentes archivos de presentación en paralelo, pero no compartas la misma instancia de Presentation entre hilos. Sigue las pautas de multihilo y utiliza una instancia separada para cada archivo.

Convertir presentaciones de PowerPoint a video en Android Convertir presentaciones de PowerPoint a XML en Android