# Converti presentazioni PowerPoint in HTML in Java > Converti le presentazioni PowerPoint in HTML con Java. Usa Aspose.Slides per esportare file PPT e PPTX, diapositive selezionate, note, caratteri, immagini, SVG e media. Source: https://docs.aspose.com/slides/it/java/convert-powerpoint-to-html/ Updated: 2026-06-12 ## **Panoramica** Aspose.Slides per Java può salvare presentazioni PowerPoint come HTML senza Microsoft PowerPoint. La conversione di base consiste in un singolo caricamento di [Presentation](https://reference.aspose.com/slides/it/java/com.aspose.slides/presentation/) e una chiamata `save` con [SaveFormat](https://reference.aspose.com/slides/it/java/com.aspose.slides/saveformat/). Usa [HtmlOptions](https://reference.aspose.com/slides/it/java/com.aspose.slides/htmloptions/) quando devi controllare il layout esportato, i caratteri, le immagini, le note, i commenti, l'output SVG o le risorse collegate. Questa guida si concentra su scenari pratici di esportazione HTML: - Esporta un’intera presentazione o diapositive selezionate. - Genera HTML a layout fisso, responsive o basato su SVG. - Includi note del relatore e commenti. - Controlla la qualità delle immagini e i dati delle aree ritagliate. - Incorporare i caratteri o salvare i file dei caratteri separatamente. - Scegli come scrivere e fare riferimento a risorse esterne e file multimediali. Per impostazione predefinita, l’esportazione HTML produce un documento HTML autonoma in cui la maggior parte delle risorse è incorporata. Questo è comodo per condividere un unico file, ma può aumentare le dimensioni dell’output. Per la pubblicazione web, considera risorse esterne, DPI più bassi per le immagini e l’incorporamento solo dei caratteri che non sono disponibili in modo affidabile nell’ambiente di destinazione. ## **Convertire una presentazione in HTML** Per esportare una presentazione in HTML, caricala con [Presentation](https://reference.aspose.com/slides/it/java/com.aspose.slides/presentation/) e salvala con [SaveFormat.Html](https://reference.aspose.com/slides/it/java/com.aspose.slides/saveformat/). ```java Presentation presentation = new Presentation("presentation.pptx"); try { presentation.save("presentation.html", SaveFormat.Html); } finally { presentation.dispose(); } ``` Questo esempio scrive un singolo file HTML. L’oggetto presentazione viene eliminato nel blocco `finally`, che rilascia i handle dei file e le risorse di rendering dopo l’esportazione. ## **Utilizzare HtmlOptions** [HtmlOptions](https://reference.aspose.com/slides/it/java/com.aspose.slides/htmloptions/) è la classe di configurazione principale per l’esportazione HTML. Le impostazioni più comuni includono: - `SlidesLayoutOptions`: aggiunge note, commenti, dispense o altre informazioni di layout. - `HtmlFormatter`: modifica la struttura del documento HTML o delega la formattazione a un controller. - `SlideImageFormat`: cambia il modo in cui le diapositive sono rappresentate, ad esempio come SVG. - `PicturesCompression`: controlla DPI dell’immagine e dimensioni dell’output. - `DeletePicturesCroppedAreas`: mantiene o rimuove i dati delle aree ritagliate delle immagini. - `SvgResponsiveLayout`: rende il contenuto SVG esportato adattabile al suo contenitore. - `ShowHiddenSlides`: include le diapositive nascoste quando necessario. Le sezioni seguenti mostrano le opzioni più comuni separatamente, così puoi combinare solo quelle necessarie al tuo flusso di lavoro. ## **Convertire diapositive selezionate in HTML** Il sovraccarico `Presentation.save` che accetta numeri di diapositiva utilizza posizioni basate su 1. Il ciclo qui sotto salva ogni diapositiva in un file HTML separato. ```java Presentation presentation = new Presentation("presentation.pptx"); try { int slideCount = presentation.getSlides().size(); for (int slideIndex = 0; slideIndex < slideCount; slideIndex++) { int slideNumber = slideIndex + 1; int[] slideNumbers = { slideNumber }; String htmlFileName = "slide-" + slideNumber + ".html"; presentation.save(htmlFileName, slideNumbers, SaveFormat.Html); } } finally { presentation.dispose(); } ``` Usa questo modello quando un sito web o un’applicazione richiedono una pagina HTML per diapositiva. Se tutte le diapositive devono avere lo stesso layout, crea una singola istanza di [HtmlOptions](https://reference.aspose.com/slides/it/java/com.aspose.slides/htmloptions/) e passala a ogni chiamata `save`. ## **Creare HTML responsive** [ResponsiveHtmlController](https://reference.aspose.com/slides/it/java/com.aspose.slides/responsivehtmlcontroller/) fornisce output HTML responsive tramite [HtmlFormatter](https://reference.aspose.com/slides/it/java/com.aspose.slides/htmlformatter/). Usalo quando la pagina esportata deve adattarsi meglio alla larghezza del browser. ```java Presentation presentation = new Presentation("presentation.pptx"); try { ResponsiveHtmlController controller = new ResponsiveHtmlController(); HtmlFormatter formatter = HtmlFormatter.createCustomFormatter(controller); HtmlOptions htmlOptions = new HtmlOptions(); htmlOptions.setHtmlFormatter(formatter); presentation.save("presentation-responsive.html", SaveFormat.Html, htmlOptions); } finally { presentation.dispose(); } ``` Per un layout responsive basato su SVG, imposta `SvgResponsiveLayout` su [HtmlOptions](https://reference.aspose.com/slides/it/java/com.aspose.slides/htmloptions/). Questo è utile quando il contenuto della diapositiva è esportato come markup SVG scalabile. ```java Presentation presentation = new Presentation("presentation.pptx"); try { HtmlOptions htmlOptions = new HtmlOptions(); htmlOptions.setSvgResponsiveLayout(true); presentation.save("presentation-svg-responsive.html", SaveFormat.Html, htmlOptions); } finally { presentation.dispose(); } ``` ## **Includere note del relatore e commenti** Usa [NotesCommentsLayoutingOptions](https://reference.aspose.com/slides/it/java/com.aspose.slides/notescommentslayoutingoptions/) tramite `HtmlOptions.setSlidesLayoutOptions` per includere note del relatore o commenti. Le note e i commenti sono nascosti per impostazione predefinita, a meno che non ne specifichi le posizioni. Supponiamo che la presentazione sorgente contenga note del relatore: ![Diapositiva con note del relatore in PowerPoint](slide_with_notes.png) Il codice seguente esporta il contenuto della diapositiva con le note del relatore sotto la diapositiva. ```java Presentation presentation = new Presentation("presentation.pptx"); try { NotesCommentsLayoutingOptions layoutOptions = new NotesCommentsLayoutingOptions(); layoutOptions.setNotesPosition(NotesPositions.BottomFull); HtmlOptions htmlOptions = new HtmlOptions(); htmlOptions.setSlidesLayoutOptions(layoutOptions); presentation.save("presentation-with-notes.html", SaveFormat.Html, htmlOptions); } finally { presentation.dispose(); } ``` L’HTML esportato include l’area delle note: ![Output HTML con la diapositiva e le note del relatore](HTML_with_notes.png) Per esportare i commenti, imposta `CommentsPosition`, ad esempio su `CommentsPositions.Right` o `CommentsPositions.Bottom`. Se ti servono solo i commenti, ometti `NotesPosition`. Se ti servono sia note che commenti, imposta entrambe le proprietà. ## **Controllare la qualità delle immagini e le aree ritagliate** L’esportazione HTML può comprimere le immagini delle diapositive per ridurre le dimensioni dell’output. Imposta `PicturesCompression` a un valore di [PicturesCompression](https://reference.aspose.com/slides/it/java/com.aspose.slides/picturescompression/) quando è necessaria una qualità dell’immagine più elevata. ```java Presentation presentation = new Presentation("presentation.pptx"); try { HtmlOptions htmlOptions = new HtmlOptions(); htmlOptions.setPicturesCompression(PicturesCompression.Dpi150); presentation.save("presentation-dpi-150.html", SaveFormat.Html, htmlOptions); } finally { presentation.dispose(); } ``` Per impostazione predefinita, le aree ritagliate delle immagini possono essere rimosse dall’output esportato. Mantieni i dati ritagliati solo quando gli utenti devono poter recuperarli o ispezionarli. Mantenerli può aumentare le dimensioni dell’HTML. ```java Presentation presentation = new Presentation("presentation.pptx"); try { HtmlOptions htmlOptions = new HtmlOptions(); htmlOptions.setDeletePicturesCroppedAreas(false); presentation.save("presentation-with-cropped-areas.html", SaveFormat.Html, htmlOptions); } finally { presentation.dispose(); } ``` ## **Aggiungere CSS** Per uno styling semplice, passa una stringa CSS a `HtmlFormatter.createDocumentFormatter`. Questo modifica il documento HTML circostante mentre Aspose.Slides continua a renderizzare il contenuto della diapositiva. ```java Presentation presentation = new Presentation("presentation.pptx"); try { String cssRules = "body { margin: 0; background: #f7f7f7; } .slide { margin: 24px auto; }"; HtmlFormatter formatter = HtmlFormatter.createDocumentFormatter(cssRules, true); HtmlOptions htmlOptions = new HtmlOptions(); htmlOptions.setHtmlFormatter(formatter); presentation.save("presentation-styled.html", SaveFormat.Html, htmlOptions); } finally { presentation.dispose(); } ``` Per un’intestazione di documento personalizzata, un file CSS collegato o markup personalizzato intorno a diapositive e forme, implementa [IHtmlFormattingController](https://reference.aspose.com/slides/it/java/com.aspose.slides/ihtmlformattingcontroller/) e passalo a [HtmlFormatter](https://reference.aspose.com/slides/it/java/com.aspose.slides/htmlformatter/) con `createCustomFormatter`. ## **Incorporare i caratteri** Se l’ambiente di destinazione potrebbe non avere i caratteri della presentazione installati, incorpora i caratteri nell’HTML con [EmbedAllFontsHtmlController](https://reference.aspose.com/slides/it/java/com.aspose.slides/embedallfontshtmlcontroller/). L’incorporamento migliora la fedeltà visiva ma aumenta le dimensioni dell’output. ```java Presentation presentation = new Presentation("presentation.pptx"); try { String[] fontNamesToExclude = { "Arial" }; EmbedAllFontsHtmlController fontController = new EmbedAllFontsHtmlController(fontNamesToExclude); HtmlFormatter formatter = HtmlFormatter.createCustomFormatter(fontController); HtmlOptions htmlOptions = new HtmlOptions(); htmlOptions.setHtmlFormatter(formatter); presentation.save("presentation-embedded-fonts.html", SaveFormat.Html, htmlOptions); } finally { presentation.dispose(); } ``` Escludi i caratteri solo quando sei certo che i browser o i sistemi di destinazione li forniscano già. Per i caratteri del brand o quelli meno comuni, l’incorporamento è solitamente più sicuro. ## **Collegare i file dei caratteri invece di incorporarli** Per ridurre le dimensioni del file HTML, puoi scrivere i dati dei caratteri in file WOFF separati e aggiungere regole `@font-face` all’HTML. L’aiutante qui sotto estende [EmbedAllFontsHtmlController](https://reference.aspose.com/slides/it/java/com.aspose.slides/embedallfontshtmlcontroller/) e sovrascrive `writeFont`. ```java class LinkedFontsHtmlController extends EmbedAllFontsHtmlController { private final java.nio.file.Path fontOutputDirectory; private final String fontUrlPrefix; LinkedFontsHtmlController( java.nio.file.Path fontOutputDirectory, String fontUrlPrefix) throws java.io.IOException { super(new String[0]); this.fontOutputDirectory = fontOutputDirectory; this.fontUrlPrefix = fontUrlPrefix.endsWith("/") ? fontUrlPrefix : fontUrlPrefix + "/"; java.nio.file.Files.createDirectories(fontOutputDirectory); } @Override public void writeFont( IHtmlGenerator generator, IFontData originalFont, IFontData substitutedFont, String fontStyle, String fontWeight, byte[] fontData) { try { IFontData font = substitutedFont == null ? originalFont : substitutedFont; String safeFontName = makeSafeFileName(font.getFontName()); String safeFontStyle = fontStyle == null || fontStyle.trim().isEmpty() ? "normal" : fontStyle; String safeFontWeight = fontWeight == null || fontWeight.trim().isEmpty() ? "normal" : fontWeight; String fontFileName = safeFontName + "-" + safeFontStyle + "-" + safeFontWeight + ".woff"; java.nio.file.Path fontFilePath = fontOutputDirectory.resolve(fontFileName); java.nio.file.Files.write(fontFilePath, fontData); String encodedFontFileName = java.net.URLEncoder.encode(fontFileName, "UTF-8"); String fontUrl = fontUrlPrefix + encodedFontFileName.replace("+", "%20"); String escapedBackslashes = font.getFontName().replace("\\", "\\\\"); String fontFamily = escapedBackslashes.replace("'", "\\'"); generator.addHtml(""); } catch (java.io.IOException exception) { throw new RuntimeException("Unable to write an exported font.", exception); } } private String makeSafeFileName(String fileName) { String invalidCharacters = "\\/:*?\"<>|"; char[] safeCharacters = fileName.toCharArray(); for (int characterIndex = 0; characterIndex < safeCharacters.length; characterIndex++) { if (invalidCharacters.indexOf(safeCharacters[characterIndex]) >= 0) { safeCharacters[characterIndex] = '_'; } } return new String(safeCharacters); } } java.nio.file.Path outputDirectory = java.nio.file.Paths.get(System.getProperty("user.dir"), "html-output"); java.nio.file.Path fontsDirectory = outputDirectory.resolve("fonts"); java.nio.file.Files.createDirectories(outputDirectory); Presentation presentation = new Presentation("presentation.pptx"); try { LinkedFontsHtmlController fontController = new LinkedFontsHtmlController(fontsDirectory, "fonts"); HtmlFormatter formatter = HtmlFormatter.createCustomFormatter(fontController); HtmlOptions htmlOptions = new HtmlOptions(); htmlOptions.setHtmlFormatter(formatter); java.nio.file.Path htmlFilePath = outputDirectory.resolve("presentation.html"); presentation.save(htmlFilePath.toString(), SaveFormat.Html, htmlOptions); } finally { presentation.dispose(); } ``` In questo esempio, i file dei caratteri vengono salvati in `html-output/fonts`, e l’HTML li richiama con URL tipo `fonts/BrandFont-normal-400.woff`. Se il file HTML e i caratteri vengono distribuiti in un percorso diverso, scegli `fontUrlPrefix` in modo che corrisponda al percorso URL pubblicato. ## **Salvare le risorse esternamente** L’HTML autonomo è facile da spostare, ma le risorse Base64 incorporate possono rendere il file molto grande. Se la tua applicazione necessita di file immagine esterni, implementa [ILinkEmbedController](https://reference.aspose.com/slides/it/java/com.aspose.slides/ilinkembedcontroller/) e passalo al costruttore di [HtmlOptions](https://reference.aspose.com/slides/it/java/com.aspose.slides/htmloptions/). Quando esternalizzi le risorse, scegli due percorsi in modo deliberato: - Il percorso di output sul file system, dove l’applicazione scrive le immagini, i caratteri, l’audio o il video generati. - Il percorso URL, che è quello che il browser utilizza dal documento HTML per caricare quei file. ## **Esportare file multimediali** [VideoPlayerHtmlController](https://reference.aspose.com/slides/it/java/com.aspose.slides/videoplayerhtmlcontroller/) esporta video e file audio e scrive HTML che può riprodurli nel browser. Il suo costruttore accetta: - `path`: la directory dove verranno scritti i file multimediali generati. - `fileName`: il nome del file HTML in fase di generazione. - `baseUri`: il prefisso URI assoluto usato nei collegamenti HTML ai file multimediali. Se il file HTML è `html-output/presentation.html` e i file multimediali sono salvati in `html-output/media`, `path` deve puntare alla directory dei media su disco, mentre `baseUri` deve puntare alla stessa directory dal punto di vista del browser. Per l’anteprima locale, puoi costruire un URI `file:///` dalla directory dei media. Per un’applicazione distribuita, usa l’URL assoluto della directory dei media pubblicata. ```java java.nio.file.Path outputDirectory = java.nio.file.Paths.get(System.getProperty("user.dir"), "html-output"); java.nio.file.Path mediaDirectory = outputDirectory.resolve("media"); java.nio.file.Files.createDirectories(outputDirectory); java.nio.file.Files.createDirectories(mediaDirectory); String htmlFileName = "presentation.html"; String mediaBaseUri = mediaDirectory.toUri().toString(); Presentation presentation = new Presentation(); try { java.nio.file.Path videoFilePath = java.nio.file.Paths.get("intro.mp4"); byte[] videoData = java.nio.file.Files.readAllBytes(videoFilePath); IVideo video = presentation.getVideos().addVideo(videoData); ISlide slide = presentation.getSlides().get_Item(0); slide.getShapes().addVideoFrame(20, 20, 480, 270, video); String mediaDirectoryPath = mediaDirectory.toString(); VideoPlayerHtmlController controller = new VideoPlayerHtmlController(mediaDirectoryPath, htmlFileName, mediaBaseUri); HtmlFormatter formatter = HtmlFormatter.createCustomFormatter(controller); SVGOptions svgOptions = new SVGOptions(controller); SlideImageFormat slideImageFormat = SlideImageFormat.svg(svgOptions); HtmlOptions htmlOptions = new HtmlOptions(controller); htmlOptions.setHtmlFormatter(formatter); htmlOptions.setSlideImageFormat(slideImageFormat); java.nio.file.Path htmlFilePath = outputDirectory.resolve(htmlFileName); presentation.save(htmlFilePath.toString(), SaveFormat.Html, htmlOptions); } finally { presentation.dispose(); } ``` Utilizza directory di output uniche per ogni processo di esportazione, soprattutto in applicazioni server. Percorsi di output condivisi possono provocare sovrascritture tra conversioni diverse. ## **Prestazioni e gestione delle risorse** La conversione HTML è un’operazione di rendering, quindi il tempo di elaborazione e l’uso della memoria dipendono dal numero di diapositive, dalla risoluzione delle immagini, dai caratteri, dagli effetti, dai grafici e dai media incorporati. Valori DPI più alti per `PicturesCompression`, caratteri incorporati, output SVG e aree ritagliate mantenute possono migliorare la fedeltà ma solitamente aumentano le dimensioni dell’output. Per conversioni batch: - Elimina prontamente ogni istanza di [Presentation](https://reference.aspose.com/slides/it/java/com.aspose.slides/presentation/). - Usa directory di output separate per lavori distinti. - Evita di incorporare caratteri comuni a meno che non sia necessaria la massima fedeltà. - Abbassa il DPI delle immagini quando l’HTML è destinato a anteprime o miniature. - Mantieni la presentazione sorgente, l’HTML generato e le risorse esterne insieme fino a quando i percorsi di distribuzione non sono definitivi. ## **FAQ** **I collegamenti ipertestuali vengono mantenuti nell'output HTML?** Sì. I collegamenti ipertestuali della presentazione vengono esportati in HTML e rimangono cliccabili quando l'URL di destinazione è valido. **Posso convertire presentazioni in HTML in parallelo?** Sì, ma non condividere un’unica istanza di [Presentation](https://reference.aspose.com/slides/it/java/com.aspose.slides/presentation/) tra più thread. Elabora file diversi con istanze di presentazione separate, flussi separati e directory di output distinte. Consulta la [guidance sul multithreading](/slides/it/java/multithreading/) per i dettagli. **L'oggetto Presentation è thread-safe?** No. Un’unica istanza di [Presentation](https://reference.aspose.com/slides/it/java/com.aspose.slides/presentation/) deve essere caricata, modificata, salvata e eliminata su un solo thread. Per lavori paralleli, crea un'istanza indipendente per ogni thread o processo. **Perché il file HTML generato è così grande?** L’esportazione predefinita può incorporare risorse direttamente nell’HTML. Caratteri incorporati, immagini ad alta DPI, media, contenuto SVG e aree ritagliate mantenute aumentano le dimensioni. Usa risorse esterne, escludi i caratteri comuni dall’incorporamento e abbassa `PicturesCompression` quando un output più piccolo è più importante della massima fedeltà. **Perché una dimensione carattere PowerPoint di 24 pt appare come 17.999819 pt in HTML?** Questo può accadere perché PowerPoint e HTML usano modelli DPI diversi. PowerPoint memorizza le dimensioni del testo in punti tipografici basati su 72 DPI, mentre il layout HTML si basa su pixel CSS in un modello di 96 DPI. Quando Aspose.Slides esporta una presentazione in HTML, la dimensione del carattere viene tradotta tra questi sistemi e la conversione può introdurre piccole differenze di arrotondamento. Questi valori non indicano una reale variazione visiva della dimensione del carattere. Sono solo un effetto matematico secondario della conversione delle metriche del testo da PowerPoint a HTML. **Come devo scegliere baseUri per l'esportazione dei media?** Scegli `baseUri` dal punto di vista del browser e passalo come URI assoluto. Per l’anteprima locale, puoi derivarlo dalla directory di output con `mediaDirectory.toUri().toString()`. Per la distribuzione, usa l'URL assoluto della directory dei media pubblicata. Il percorso file system `path` e il `baseUri` del browser non devono essere la stessa stringa, ma devono descrivere la stessa posizione della risorsa. **Posso includere diapositive nascoste?** Sì. Imposta `ShowHiddenSlides` su `true` su [HtmlOptions](https://reference.aspose.com/slides/it/java/com.aspose.slides/htmloptions/) quando le diapositive nascoste devono essere esportate.