Konversikan Dokumen menjadi HTML, MHTML, atau EPUB

Dokumen dalam format tata letak alur HTML dan MHTML juga sangat populer dan dapat digunakan di platform web apa pun. Oleh karena itu, mengonversi dokumen menjadi HTML dan MHTML merupakan fitur penting dari Aspose.Words.

EPUB (kependekan dari “Publikasi Elektronik” ) adalah format berbasis HTML yang biasa digunakan untuk distribusi buku elektronik. Format ini didukung penuh dalam Aspose.Words untuk mengekspor buku elektronik yang kompatibel dengan sebagian besar perangkat baca.

Konversikan Dokumen

Untuk konversi sederhana ke HTML, MHTML, atau EPUB, salah satu kelebihan metode Save digunakan. Anda dapat menyimpan dokumen ke file atau aliran dan secara eksplisit mengatur format penyimpanan dokumen keluaran atau mendefinisikannya dari ekstensi nama file.

Contoh berikut menunjukkan cara mengonversi DOCX menjadi HTML dengan menentukan format penyimpanan:

Untuk mengonversi dokumen menjadi MHTML atau EPUB, gunakan masing-masing SaveFormat.Mhtml atau SaveFormat.Epub.

Mengonversi Dokumen dengan Informasi Pulang-pergi

Format HTML tidak mendukung banyak fitur Microsoft Word, dan jika kita perlu mengembalikan model dokumen sedekat mungkin dengan aslinya, kita perlu menyimpan beberapa informasi tambahan di dalam file HTML. Informasi tersebut juga disebut “informasi pulang pergi”. Untuk tujuan ini, Aspose.Words menyediakan kemampuan untuk mengekspor informasi pulang pergi saat menyimpan ke HTML, MHTML, atau EPUB menggunakan properti ExportRoundtripInformation. Menyimpan informasi pulang pergi memungkinkan pemulihan properti dokumen seperti tab, komentar, header, dan footer selama memuat dokumen dari format yang terdaftar kembali ke objek Document.

Nilai defaultnya adalah true untuk HTML dan false untuk MHTML dan EPUB:

  • Saat true, informasi pulang pergi diekspor sebagai - aw - * CSS properti dari elemen HTML yang sesuai
  • Ketika false, tidak ada informasi bolak-balik yang akan dikeluarkan ke dalam file yang dihasilkan

Contoh kode berikut menunjukkan cara mengekspor informasi pulang pergi saat mengonversi dokumen dari DOCX menjadi HTML:

Tentukan Opsi Penyimpanan saat Konversi ke HTML

Aspose.Words memungkinkan pengubahan dokumen Word menjadi HTML menggunakan opsi penyimpanan default atau kustom. Beberapa contoh opsi penyimpanan khusus dijelaskan di bawah ini.

Tentukan Folder untuk Menyimpan Sumber Daya

Menggunakan Aspose.Words kita dapat menentukan folder fisik tempat semua sumber daya, seperti gambar, font, dan CSS eksternal, disimpan saat dokumen dikonversi ke HTML. Secara default, ini adalah string kosong.

Menentukan properti ResourceFolder adalah cara paling sederhana untuk mengatur folder tempat semua sumber daya harus ditulis. Kita dapat menggunakan properti individual, seperti FontsFolder yang menyimpan font ke folder tertentu dan ImagesFolder yang menyimpan gambar ke folder tertentu. Saat jalur relatif ditentukan, FontsFolder dan ImagesFolder merujuk ke folder tempat kumpulan kode berada, ResourceFolder dan CssStyleSheetFileName merujuk ke folder keluaran tempat dokumen HTML berada.

Dalam contoh ini, ResourceFolder menentukan jalur relatif. Jalur ini merujuk ke folder keluaran tempat dokumen HTML disimpan. Nilai properti ResourceFolderAlias digunakan untuk membuat URLs untuk semua sumber daya.

Contoh kode berikut menunjukkan cara bekerja dengan properti ini:

Dengan menggunakan properti ResourceFolderAlias, kita juga dapat menentukan nama folder yang digunakan untuk membuat URIs dari semua sumber daya yang ditulis ke dalam dokumen HTML. Ini adalah cara paling sederhana untuk menentukan bagaimana URIs harus dibuat untuk semua file sumber daya. Informasi yang sama dapat ditentukan untuk gambar dan font secara terpisah masing-masing melalui properti ImagesFolderAlias dan FontsFolderAlias.

Namun, tidak ada properti individual untuk CSS. Perilaku dari FontsFolder, FontsFolderAlias, ImagesFolder, ImagesFolderAlias dan properti CssStyleSheetFileName tidak berubah. Perhatikan bahwa properti CssStyleSheetFileName digunakan untuk menentukan nama folder dan nama file.

  • ResourceFolder memiliki prioritas lebih rendah daripada folder yang ditentukan melalui FontsFolder, ImagesFolder, dan CssStyleSheetFileName. Jika folder yang ditentukan dalam ResourceFolder tidak ada, folder tersebut akan dibuat secara otomatis.
  • ResourceFolderAlias memiliki prioritas lebih rendah dari FontsFolderAlias dan ImagesFolderAlias. Jika ResourceFolderAlias kosong, nilai properti ResourceFolder akan digunakan untuk membuat sumber daya URIs. Jika ResourceFolderAlias disetel ke “.” (titik), sumber daya URIs hanya akan berisi nama file tanpa menentukan jalur.

Ekspor Sumber Daya Font Pengkodean Base64

Aspose.Words menyediakan kemampuan untuk menentukan apakah sumber daya font harus disematkan ke dalam HTML dalam penyandian Base64. Untuk melakukan ini, gunakan properti ExportFontsAsBase64 – ini adalah perpanjangan dari properti ExportFontResources. Secara default, nilainya adalah false, dan font ditulis ke dalam file terpisah. Tetapi jika opsi ini disetel ke true, font akan disematkan ke dalam CSS dokumen dalam penyandian Base64. Properti ExportFontsAsBase64 hanya memengaruhi format HTML dan tidak memengaruhi EPUB dan MHTML.

Contoh kode berikut menunjukkan cara mengekspor font yang disandikan Base64 ke HTML:

Tentukan Opsi Penyimpanan saat Konversi ke EPUB

Aspose.Words memungkinkan pengubahan dokumen Word menjadi format EPUB menggunakan opsi penyimpanan default atau kustom. Anda dapat menentukan sejumlah opsi dengan meneruskan instance HtmlSaveOptions ke metode Save.

Contoh kode berikut menunjukkan cara mengonversi dokumen Word menjadi EPUB dengan menentukan beberapa opsi penyimpanan khusus: