Convertir presentaciones a HTML5 en Python mediante Java
Descripción general
Este artículo explica cómo convertir presentaciones de PowerPoint a HTML5 usando Aspose.Slides for Python via Java. Cubre la exportación básica, el control de animaciones de formas y transiciones de diapositivas, y el diseño de comentarios. También compara la salida HTML5 con la salida basada en SVG de la exportación HTML estándar.
Los ejemplos requieren Aspose.Slides for Python via Java y un tiempo de ejecución Java compatible. Coloque las presentaciones de entrada en el directorio de trabajo actual. Cada ejemplo inicia la JVM solo si no está ya en ejecución.
Exportar PowerPoint a HTML5
El siguiente ejemplo carga una presentación desde el directorio de trabajo y la guarda en formato HTML5. Utiliza la configuración de exportación predeterminada; el siguiente ejemplo muestra cómo controlar la reproducción de animaciones de forma explícita. Reemplace la ruta de entrada por la ruta a su presentación.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("pres.pptx")
try:
presentation.save("pres.html", SaveFormat.Html5)
finally:
presentation.dispose()
Nota
Además del documento HTML, la exportación escribe archivos CSS y JavaScript de soporte para el estilo de diapositivas, animaciones, efectos y navegación. Mantenga estos archivos junto al documento HTML al mover o publicar la salida. La página generada también carga jQuery y Anime.js desde CDNs públicas; sin ellos, la navegación de diapositivas y las animaciones no funcionan.Para exportar sin reproducir animaciones de formas ni transiciones de diapositivas, pase False a setAnimateShapes y setAnimateTransitions en Html5Options. Estas configuraciones son independientes, por lo que puede habilitar una mientras deshabilita la otra. El ejemplo exporta la presentación con ambos tipos de animación desactivados en la página generada.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Html5Options, Presentation, SaveFormat
html5_options = Html5Options()
html5_options.setAnimateShapes(False)
html5_options.setAnimateTransitions(False)
presentation = Presentation("pres.pptx")
try:
presentation.save("pres5.html", SaveFormat.Html5, html5_options)
finally:
presentation.dispose()
Exportar PowerPoint a HTML
La exportación HTML estándar utiliza un enfoque de renderizado diferente: el contenido de la diapositiva se representa mediante SVG dentro de una página HTML. El siguiente ejemplo convierte una presentación a un documento HTML usando este enfoque de renderizado.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("pres.pptx")
try:
presentation.save("pres.html", SaveFormat.Html)
finally:
presentation.dispose()
El marcado simplificado a continuación ilustra la estructura de la página generada. El elemento SVG contiene el contenido de la diapositiva renderizado; el texto del marcador de posición representa ese contenido y no es la salida literal de la exportación.
<body>
<div class="slide" name="slide" id="slideslideIface1">
<svg version="1.1">
<g> THE SLIDE CONTENT GOES HERE </g>
</svg>
</div>
</body>
Advertencia
La exportación basada en SVG no expone las formas de PowerPoint como elementos HTML individuales. Utilice la exportación HTML5 cuando necesite las opciones de animación de formas y transiciones de diapositivas demostradas en este artículo.Exportar PowerPoint a vista de diapositivas HTML5
La exportación HTML5 produce una página para ver y navegar por las diapositivas de la presentación en un navegador. Este ejemplo habilita tanto setAnimateShapes como setAnimateTransitions para que la vista de diapositivas exportada pueda reproducir efectos de la presentación original.
Utilice una presentación que ya contenga animaciones de formas y transiciones de diapositivas para ver el efecto de estas configuraciones. Habilitarlas no agrega nuevos efectos a diapositivas que no los tengan. Después de la exportación, abra el documento HTML5 generado en un navegador con sus archivos de soporte disponibles.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Html5Options, Presentation, SaveFormat
html5_options = Html5Options()
html5_options.setAnimateShapes(True)
html5_options.setAnimateTransitions(True)
presentation = Presentation("pres.pptx")
try:
presentation.save("HTML5-slide-view.html", SaveFormat.Html5, html5_options)
finally:
presentation.dispose()
Convertir una presentación a un documento HTML5 con comentarios
Puede incluir los comentarios de diapositiva existentes en la salida HTML5 para que los lectores vean la retroalimentación junto al contenido de la diapositiva. El ejemplo en esta sección espera que la presentación de origen contenga comentarios, como se muestra a continuación. Exporta esos comentarios; no crea nuevos.
Pasar un objeto NotesCommentsLayoutingOptions al método setSlidesLayoutOptions de Html5Options. Utilice setCommentsPosition para seleccionar Right de la enumeración CommentsPositions y colocar los comentarios a la derecha de cada diapositiva.
El siguiente ejemplo exporta la presentación a HTML5 con este diseño de comentarios. Una presentación sin comentarios no tendrá texto de comentario para mostrar.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import CommentsPositions, Html5Options, NotesCommentsLayoutingOptions, Presentation, SaveFormat
layout_options = NotesCommentsLayoutingOptions()
layout_options.setCommentsPosition(CommentsPositions.Right)
html5_options = Html5Options()
html5_options.setSlidesLayoutOptions(layout_options)
presentation = Presentation("sample.pptx")
try:
presentation.save("output.html", SaveFormat.Html5, html5_options)
finally:
presentation.dispose()
Excluir hipervínculos JavaScript durante la exportación
Suponga que hyperlinks.pptx contiene texto vinculado con un destino javascript:alert('Hello') y un enlace ordinario https://example.com/. Para excluir el hipervínculo JavaScript durante la exportación, pase True a SaveOptions.setSkipJavaScriptLinks. El valor predeterminado es False, por lo que estos enlaces no se filtran a menos que habilite la opción.
El siguiente ejemplo carga la presentación desde el directorio de trabajo y la exporta usando Html5Options:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Html5Options, Presentation, SaveFormat
html5_options = Html5Options()
html5_options.setSkipJavaScriptLinks(True)
presentation = Presentation("hyperlinks.pptx")
try:
presentation.save("filtered-html5.html", SaveFormat.Html5, html5_options)
finally:
presentation.dispose()
El archivo exportado omite el hipervínculo JavaScript mientras conserva su texto y el enlace HTTPS ordinario. La presentación original permanece sin cambios.
Esta opción filtra los hipervínculos JavaScript; no elimina todos los scripts ni otro contenido activo, ni garantiza el cumplimiento de CSP. Por ejemplo, la salida HTML5 aún incluye scripts para la navegación y las animaciones de diapositivas.
Preguntas frecuentes
¿Puedo controlar si las animaciones de objetos y las transiciones de diapositivas se reproducirán en HTML5?
Sí, la exportación HTML5 proporciona opciones separadas para habilitar o deshabilitar animaciones de formas y transiciones de diapositivas.
¿Se admiten los comentarios y dónde pueden colocarse respecto a la diapositiva?
Sí, los comentarios existentes pueden incluirse en la salida HTML5 y posicionarse (por ejemplo, a la derecha de la diapositiva) mediante la configuración de diseño de notas y comentarios.
¿Puedo omitir enlaces que invocan JavaScript por razones de seguridad o CSP?
Sí, la configuración setSkipJavaScriptLinks le permite omitir los hipervínculos con llamadas a JavaScript durante el guardado. El valor predeterminado es False. Consulte Excluir hipervínculos JavaScript durante la exportación para un ejemplo de exportación HTML5 y el alcance del filtro. Esta configuración no elimina el JavaScript utilizado por el visor HTML5 para la navegación y las animaciones.