Python via Java를 사용하여 프레젠테이션을 HTML5로 변환
개요
이 문서에서는 Aspose.Slides for Python via Java를 사용하여 PowerPoint 프레젠테이션을 HTML5로 변환하는 방법을 설명합니다. 기본 내보내기, 모양 애니메이션 및 슬라이드 전환 제어, 댓글 레이아웃을 다룹니다. 또한 표준 HTML 내보내기의 SVG 기반 출력과 HTML5 출력을 비교합니다.
예제는 Aspose.Slides for Python via Java와 호환되는 Java 런타임이 필요합니다. 입력 프레젠테이션 파일을 현재 작업 디렉터리에 배치하십시오. 각 예제는 JVM이 이미 실행 중이 아닌 경우에만 시작합니다.
PowerPoint를 HTML5로 내보내기
다음 예제는 작업 디렉터리에서 프레젠테이션을 로드하고 HTML5 형식으로 저장합니다. 기본 내보내기 설정을 사용합니다; 다음 예제에서는 애니메이션 재생을 명시적으로 제어하는 방법을 보여줍니다. 입력 경로를 실제 프레젠테이션 경로로 바꾸십시오.
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()
Note
HTML 문서 외에도, 내보내기에서는 슬라이드 스타일링, 애니메이션, 효과 및 탐색을 위한 CSS 및 JavaScript 파일을 생성합니다. 출력물을 이동하거나 게시할 때 HTML 문서와 함께 이러한 파일을 보관하십시오. 생성된 페이지는 또한 공개 CDN에서 jQuery와 Anime.js를 로드합니다; 이들이 없으면 슬라이드 탐색 및 애니메이션이 작동하지 않습니다.모양 애니메이션이나 슬라이드 전환을 재생하지 않도록 내보내려면 Html5Options에서 False를 setAnimateShapes와 setAnimateTransitions에 전달하십시오. 이러한 설정은 독립적이며, 하나만 활성화하고 다른 하나는 비활성화할 수 있습니다. 예제에서는 생성된 페이지에서 두 종류의 애니메이션이 모두 비활성화된 상태로 프레젠테이션을 내보냅니다.
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()
PowerPoint를 HTML로 내보내기
표준 HTML 내보내기는 다른 렌더링 방식을 사용합니다: 슬라이드 콘텐츠가 HTML 페이지 내부의 SVG로 표현됩니다. 다음 예제는 이 렌더링 방식을 사용하여 프레젠테이션을 HTML 문서로 변환합니다.
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()
아래의 단순화된 마크업은 생성된 페이지의 구조를 보여줍니다. SVG 요소는 렌더링된 슬라이드 콘텐츠를 포함하고; 플레이스홀더 텍스트는 해당 콘텐츠를 나타내며 실제 내보내기 출력이 아닙니다.
<body>
<div class="slide" name="slide" id="slideslideIface1">
<svg version="1.1">
<g> THE SLIDE CONTENT GOES HERE </g>
</svg>
</div>
</body>
Warning
SVG 기반 내보내기는 PowerPoint 모양을 개별 HTML 요소로 노출하지 않습니다. 이 문서에서 시연된 모양 애니메이션 및 슬라이드 전환 옵션이 필요할 경우 HTML5 내보내기를 사용하십시오.PowerPoint를 HTML5 슬라이드 뷰로 내보내기
HTML5 내보내기는 브라우저에서 프레젠테이션 슬라이드를 보기 및 탐색할 수 있는 페이지를 생성합니다. 이 예제는 setAnimateShapes와 setAnimateTransitions를 모두 활성화하여 내보낸 슬라이드 뷰가 원본 프레젠테이션의 효과를 재생하도록 합니다.
이미 모양 애니메이션과 슬라이드 전환이 포함된 프레젠테이션을 사용해 이러한 설정의 효과를 확인하십시오. 이를 활성화해도 해당 슬라이드에 효과가 없으면 새 효과가 추가되지 않습니다. 내보낸 후, 지원 파일이 존재하는 브라우저에서 생성된 HTML5 문서를 엽니다.
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()
프레젠테이션을 댓글이 포함된 HTML5 문서로 변환하기
HTML5 출력에 기존 슬라이드 댓글을 포함시켜 독자가 슬라이드 콘텐츠와 함께 피드백을 볼 수 있습니다. 이 섹션의 예제는 아래와 같이 소스 프레젠테이션에 댓글이 포함되어 있기를 기대합니다. 해당 댓글을 내보내며, 새로운 댓글을 생성하지는 않습니다.
Html5Options의 setSlidesLayoutOptions 메서드에 NotesCommentsLayoutingOptions 객체를 전달하십시오. CommentsPositions 열거형에서 Right를 선택하기 위해 setCommentsPosition를 사용하면 각 슬라이드 오른쪽에 댓글을 배치할 수 있습니다.
다음 예제는 이 댓글 레이아웃을 사용하여 프레젠테이션을 HTML5로 내보냅니다. 댓글이 없는 프레젠테이션은 표시할 댓글 텍스트가 없습니다.
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()
아래 이미지에서는 슬라이드 옆에 댓글이 표시된 내보낸 HTML5 문서를 보여줍니다.
내보내기 중 JavaScript 하이퍼링크 제외
hyperlinks.pptx에 javascript:alert('Hello') 대상과 일반 https://example.com/ 링크가 포함된 텍스트가 있다고 가정합니다. 내보내기 중 JavaScript 하이퍼링크를 제외하려면 SaveOptions.setSkipJavaScriptLinks에 True를 전달하십시오. 기본값은 False이며, 옵션을 활성화하지 않으면 이러한 링크는 필터링되지 않습니다.
다음 예제는 작업 디렉터리에서 프레젠테이션을 로드하고 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()
내보낸 파일은 JavaScript 하이퍼링크를 제외하고 텍스트와 일반 HTTPS 링크는 유지합니다. 원본 프레젠테이션은 변하지 않습니다.
이 옵션은 JavaScript 하이퍼링크만 필터링하고, 모든 스크립트나 기타 활성 콘텐츠를 제거하지 않으며, CSP 준수를 보장하지도 않습니다. 예를 들어, HTML5 출력에는 여전히 슬라이드 탐색 및 애니메이션을 위한 스크립트가 포함됩니다.
FAQ
HTML5에서 개체 애니메이션 및 슬라이드 전환이 재생되는지 제어할 수 있나요?
예, HTML5 내보내기는 모양 애니메이션와 슬라이드 전환을 별도로 활성화하거나 비활성화할 수 있는 옵션을 제공합니다.
댓글이 지원되며, 슬라이드와 상대적으로 어디에 배치할 수 있나요?
예, 기존 댓글을 HTML5 출력에 포함시킬 수 있으며, 메모 및 댓글에 대한 레이아웃 설정을 통해 (예: 슬라이드 오른쪽) 배치할 수 있습니다.
보안 또는 CSP 이유로 JavaScript를 호출하는 링크를 건너뛸 수 있나요?
예, setSkipJavaScriptLinks 설정을 통해 저장 중에 JavaScript 호출이 포함된 하이퍼링크를 건너뛸 수 있습니다. 기본값은 False입니다. HTML5 내보내기 예제와 필터 범위는 Export 중 JavaScript 하이퍼링크 제외를 참고하십시오. 이 설정은 HTML5 뷰어가 탐색 및 애니메이션에 사용하는 JavaScript를 제거하지 않습니다.