แปลงงานนำเสนอ PowerPoint เป็น Markdown ใน Python ผ่าน Java

หน้านี้เกี่ยวกับอะไร

แปลงงานนำเสนอ PPT และ PPTX เป็น Markdown ใน Python ผ่าน Java และควบคุมตำแหน่งที่บันทึกและอ้างอิงภาพ bitmap, metafile, และ SVG ที่ส่งออก

ภาพรวม

Aspose.Slides for Python via Java สามารถแปลงงานนำเสนอ PPT และ PPTX เป็น Markdown เพื่อการเขียนเอกสาร, เว็บไซต์แบบสถิต, การย้ายเนื้อหา, และกระบวนการควบคุมเวอร์ชันได้ คุณสามารถเลือกรูปแบบของ Markdown, ควบคุมการเรนเดอร์เนื้อหาสไลด์, และกำหนดว่าภาพที่ส่งออกจะถูกจัดเก็บที่ใดและ Markdown ที่สร้างขึ้นจะอ้างอิงถึงภาพอย่างไร

โดยค่าเริ่มต้น การส่งออก Markdown จะใช้ผลลัพธ์แบบข้อความเท่านั้น หากต้องการส่งออกเนื้อหาภาพ ให้ตั้งค่าประเภทการส่งออกด้วยเมธอด MarkdownSaveOptions.setExportType เป็นค่า Sequential หรือ Visual จาก enumeration MarkdownExportType Sequential จะเรนเดอร์รายการสไลด์แยกกันและตามลำดับ ในขณะที่ Visual จะคงกลุ่มรายการไว้ด้วยกันเพื่อรักษาความสัมพันธ์เชิงภาพ ค่า TextOnly จะไม่สร้างทรัพยากรภาพ ดังนั้นคอลแบ็กการบันทึกภาพจะไม่ถูกเรียกในโหมดนั้น

แปลงงานนำเสนอเป็น Markdown

โหลดไฟล์แหล่งที่มาด้วยคลาส Presentation จากนั้นเรียกเมธอด Presentation.save ด้วยค่า Md จาก enumeration SaveFormat

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    presentation.save("presentation.md", SaveFormat.Md)
finally:
    presentation.dispose()

แต่ละตัวอย่างจะอ่านไฟล์ presentation.pptx จากไดเรกทอรีทำงานปัจจุบัน ก่อนรันตัวอย่างให้ติดตั้ง Aspose.Slides for Python via Java และ Java runtime ที่เข้ากันได้ เริ่ม JVM ครั้งเดียวต่อกระบวนการ Python

เลือกรูปแบบ Markdown

เมธอด MarkdownSaveOptions.setFlavor ควบคุมสเปคของ Markdown ที่ใช้สำหรับผลลัพธ์ enumeration Flavor มี CommonMark, GitHub Flavored Markdown, และรูปแบบที่สนับสนุนอื่นๆ

ตัวอย่างต่อไปนี้ส่งออกงานนำเสนอเป็น CommonMark:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Flavor, MarkdownSaveOptions, Presentation, SaveFormat

presentation = Presentation("presentation.pptx")
try:
    options = MarkdownSaveOptions()
    options.setFlavor(Flavor.CommonMark)

    presentation.save("presentation.md", SaveFormat.Md, options)
finally:
    presentation.dispose()

ส่งออกภาพโดยใช้พฤติกรรมการบันทึกในเครื่องโดยค่าเริ่มต้น

คลาส MarkdownSaveOptions มีเมธอดสองตัวสำหรับกำหนดการบันทึกรูปภาพในเครื่อง:

setBasePath ระบุไดเรกทอรีฐานสำหรับเอกสาร Markdown และทรัพยากรของมัน
setImagesSaveFolderName ระบุไดเรกทอรีย่อยของภาพ ค่าเริ่มต้นคือ Images

ตัวอย่างต่อไปนี้เรนเดอร์เนื้อหาภาพ, เขียนภาพไปที่ output/assets, และสร้างลิงก์ภาพแบบ relative ในเอกสาร Markdown:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from pathlib import Path
from asposeslides.api import MarkdownExportType, MarkdownSaveOptions, Presentation, SaveFormat

output_directory = Path("output")
output_directory.mkdir(parents=True, exist_ok=True)

presentation = Presentation("presentation.pptx")
try:
    options = MarkdownSaveOptions()
    options.setExportType(MarkdownExportType.Visual)
    options.setBasePath(str(output_directory))
    options.setImagesSaveFolderName("assets")

    markdown_path = output_directory / "presentation.md"
    presentation.save(str(markdown_path), SaveFormat.Md, options)
finally:
    presentation.dispose()

พฤติกรรมนี้ยังทำหน้าที่เป็น fallback เมื่อตัวจัดการการบันทึกภาพแบบกำหนดเองคืนค่า False

ปรับแต่งการบันทึกภาพและลิงก์ Markdown

ใช้เมธอด MarkdownSaveOptions.setImageSaving เพื่อลงทะเบียนคอลแบ็กสำหรับทรัพยากร bitmap และ metafile ที่ไม่ใช่ SVG ที่ส่งออกในขั้นตอน Markdown คอลแบ็ก MarkdownImageSavingHandler จะรับออบเจ็กต์ภาพ, ค่าของ ImageFormat, และลิงก์ Markdown ที่สร้างขึ้นในพารามิเตอร์อาร์เรย์ String[] ขนาดหนึ่ง บันทึกหรืออัปโหลดภาพด้วยฟอร์แมตที่ให้มาแล้วแทนที่ link[0] ด้วยอ้างอิงที่ต้องปรากฏในผลลัพธ์ Markdown

ทรัพยากรที่ส่งออกเป็น SVG จะถูกจัดการแยกต่างหาก ลงทะเบียนคอลแบ็กด้วยเมธอด MarkdownSaveOptions.setSvgImageSaving คอลแบ็ก MarkdownSvgImageSavingHandler จะรับออบเจ็กต์ SvgImage และพารามิเตอร์อาร์เรย์ String[] link ขนาดหนึ่ง SVG ไม่มีอาร์กิวเมนต์ ImageFormat; ให้เขียนหรืออัปโหลดข้อมูล XML ของมันจากเมธอด SvgImage.getSvgData ตามต้องการ ขึ้นอยู่กับโหมดการส่งออกและการจัดกลุ่มภาพ SVG ในงานนำเสนออาจถูกแปลงเป็น raster หรือรวมกับเนื้อหาอื่น; ทรัพยากรที่ไม่ใช่ SVG ที่ได้จะแพร่ผ่านไปยังคอลแบ็กการบันทึกภาพ ลงทะเบียนคอลแบ็กทั้งสองเมื่อต้องการประมวลผลทรัพยากรภาพที่ส่งออกทั้งหมดด้วยกระบวนการกำหนดเอง

ค่าที่คอลแบ็กคืนจะกำหนดว่าใครเป็นผู้ประมวลผลภาพ:

คืนค่า True หลังจากคอลแบ็กบันทึก, อัปโหลด, แปลงรูป หรือประมวลผลภาพใด ๆ แล้วกำหนดค่าที่ถูกต้องให้กับ link[0] Aspose.Slides จะเขียนค่านั้นลงในเอกสาร Markdown และไม่ทำการบันทึกในเครื่องตามค่าเริ่มต้น
คืนค่า False เพื่อให้ Aspose.Slides บันทึกภาพในเครื่องและสร้างลิงก์ตามค่าที่ตั้งด้วย MarkdownSaveOptions.setBasePath และ MarkdownSaveOptions.setImagesSaveFolderName

Important

ตัวจัดการที่คืนค่า True จะรับผิดชอบต่อภาพ หากคืนค่า True โดยไม่ได้กำหนดลิงก์ที่ถูกต้องและไม่ว่างเปล่า การส่งออกจะล้มเหลวด้วย InvalidOperationException

ใน Python ให้ลงทะเบียนคอลแบ็กเหล่านี้ด้วย jpype.JProxy โดยทำการนำเข้าตัวยืนยัน Java ผ่านเมธอด invoke อาร์กิวเมนต์ link เป็นอาร์เรย์ Java string ที่เปลี่ยนแปลงได้: แปลง link[0] เป็นสตริง Python ก่อนทำการประมวลผล แล้วกำหนด URL ที่แทนที่กลับไปยัง link[0]

บันทึกภาพไปยังไดเรกทอรีต้นทาง CDN และใช้ URL ภายนอก

ตัวอย่างต่อไปนี้ถือว่า cdn-origin/presentations/quarterly-report เป็นไดเรกทอรีต้นทาง CDN ที่ถูกเมานท์หรือซิงโครไนซ์ ตัวจัดการแต่ละตัวจะดึงชื่อไฟล์ที่สร้างขึ้น, บันทึกภาพไปยังไดเรกทอรีที่กำหนดเองนั้น, และแทนที่ลิงก์ภาพในเครื่องที่สร้างขึ้นด้วย URL สาธารณะของ CDN ตัวอย่างไม่มีการอัปโหลดผ่านเครือข่าย: URL จะเป็นไปได้ก็ต่อเมื่อติดตั้งไดเรกทอรีเป็นต้นทาง CDN หรือไฟล์ถูกเผยแพร่ไปยัง CDN สำหรับการจัดเก็บแบบวัตถุ ให้แทนที่การเขียนไฟล์ระบบด้วยการอัปโหลดผ่าน SDK ของ storage และกำหนด link[0] หลังจากอัปโหลดสำเร็จ

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from pathlib import Path
from urllib.parse import quote
from asposeslides.api import MarkdownExportType, MarkdownSaveOptions, Presentation, SaveFormat

output_directory = Path("output")
public_base_url = "https://cdn.example.com/presentations/quarterly-report"
storage_directory = Path("cdn-origin", "presentations", "quarterly-report")
output_directory.mkdir(parents=True, exist_ok=True)
storage_directory.mkdir(parents=True, exist_ok=True)

def get_file_name(generated_link):
    normalized_link = str(generated_link).replace("\\", "/")
    return normalized_link.rsplit("/", 1)[-1]

def save_image(image, image_format, link):
    if image.getWidth() < 128 or image.getHeight() < 128:
        return False

    file_name = get_file_name(link[0])
    storage_path = storage_directory / file_name
    image.save(str(storage_path), image_format)
    encoded_file_name = quote(file_name, safe="")
    link[0] = public_base_url + "/" + encoded_file_name
    return True

def save_svg(svg_image, link):
    file_name = get_file_name(link[0])
    storage_path = storage_directory / file_name
    svg_data = svg_image.getSvgData()
    try:
        storage_path.write_bytes(bytes(svg_data))
    except OSError as error:
        print(f"Could not save the SVG image: {error}")
        return False

    encoded_file_name = quote(file_name, safe="")
    link[0] = public_base_url + "/" + encoded_file_name
    return True

image_handler = jpype.JProxy("com.aspose.slides.MarkdownSaveOptions$MarkdownImageSavingHandler", dict(invoke=save_image))
svg_handler = jpype.JProxy("com.aspose.slides.MarkdownSaveOptions$MarkdownSvgImageSavingHandler", dict(invoke=save_svg))

presentation = Presentation("presentation.pptx")
try:
    options = MarkdownSaveOptions()
    options.setExportType(MarkdownExportType.Visual)
    options.setBasePath(str(output_directory))
    options.setImagesSaveFolderName("fallback-images")
    options.setImageSaving(image_handler)
    options.setSvgImageSaving(svg_handler)

    markdown_path = output_directory / "presentation.md"
    presentation.save(str(markdown_path), SaveFormat.Md, options)
finally:
    presentation.dispose()

คอลแบ็ก bitmap ตั้งใจคืนค่า False สำหรับภาพที่มีขนาดเล็กกว่า 128 × 128 พิกเซล ดังนั้น Aspose.Slides จะบันทึกภาพเหล่านั้นไปที่ output/fallback-images ตามพฤติกรรมค่าเริ่มต้น bitmap และ metafile ที่ใหญ่กว่า รวมถึงทรัพยากร SVG จะถูกจัดการโดยโค้ดกำหนดเอง ตัวอย่างเช่น ลิงก์ภาพภายในที่สร้างเช่น fallback-images/image1.png จะกลายเป็น https://cdn.example.com/presentations/quarterly-report/image1.png ตัวจัดการจะใช้เส้นทางของระบบปฏิบัติการเท่านั้นเมื่อเขียนไฟล์; ลิงก์ที่เขียนใน Markdown จะใช้เครื่องหมายทับหน้า (/) และชื่อไฟล์ที่เข้ารหัสแบบ URL ปฏิบัติตามกฎเดียวกันเมื่อต้องสร้างลิงก์แบบ relative: ใช้ / ไม่ใช่ตัวคั่นไดเรกทอรีเฉพาะแพลตฟอร์ม

คำถามที่พบบ่อย

Can one handler process both raster images and SVG images?
ตัวจัดการหนึ่งสามารถประมวลผลทั้งภาพเรสเตอร์และ SVG ได้หรือไม่?
No. Use MarkdownSaveOptions.setImageSaving for bitmap and metafile resources and MarkdownSaveOptions.setSvgImageSaving for SVG resources. The former provides an image object and an ImageFormat value; the latter provides an SvgImage object whose SVG data can be read with SvgImage.getSvgData. A source SVG that is rasterized during export is processed by the image‑saving callback instead.

What happens when an image‑saving handler returns False?
อะไรจะเกิดขึ้นเมื่อคอลแบ็กการบันทึกภาพคืนค่า False?
Aspose.Slides จะใช้พฤติกรรมการบันทึกในเครื่องตามค่าเริ่มต้น โดยตำแหน่งภาพและลิงก์ที่สร้างจะถูกควบคุมโดยค่าที่ตั้งด้วย MarkdownSaveOptions.setBasePath และ MarkdownSaveOptions.setImagesSaveFolderName.

Can a handler provide a URL without saving the image locally?
คอลแบ็กสามารถให้ URL ได้โดยไม่บันทึกภาพในเครื่องหรือไม่?
Yes. The handler may upload the image to object storage or pass it to another service, assign the resulting URL to link[0], and return True. The handler must complete the processing itself; returning True prevents the default local save.

Why does Markdown export throw an InvalidOperationException from a handler?
ทำไมการส่งออก Markdown จึงโยน InvalidOperationException จากคอลแบ็ก?
This occurs when the handler returns True but does not supply a valid, non‑empty link. Assign the relative path or external URL that should appear in Markdown before returning True.

Which path separator should image links use?
ลิงก์ภาพควรใช้ตัวคั่นเส้นทางแบบใด?
Use forward slashes (/) in Markdown links and URLs. Use pathlib.Path only for file‑system paths, then construct or normalize the Markdown reference separately.

Are hyperlinks preserved during Markdown export?
ลิงก์ไฮเปอร์ลิงก์จะถูกรักษาไว้ในการส่งออกเป็น Markdown หรือไม่?
Yes. Text hyperlinks are preserved as standard Markdown links. Slide transitions and animations are not converted.

Can presentations be converted to Markdown in parallel?
สามารถแปลงงานนำเสนอเป็น Markdown แบบขนานได้หรือไม่?
You can process different presentation files in parallel, but do not share the same Presentation instance between threads. Follow the multithreading guidelines and use a separate instance for each file.

แปลงงานนำเสนอ PowerPoint เป็นวิดีโอใน Python แปลงงานนำเสนอ PowerPoint เป็น XML ใน Python ผ่าน Java