המרת מסמך ל HTML, MHTML או EPUB
מסמכים ב HTML ו MHTML פורמטים של פריסת זרימה פופולריים מאוד וניתן להשתמש בהם בכל פלטפורמת אינטרנט. מסיבה זו, המרת מסמכים ל HTML ו MHTML היא תכונה חשובה של Aspose.Words.
EPUB (קיצור של “פרסום אלקטרוני”) הוא פורמט מבוסס HTML המשמש בדרך כלל להפצת ספרים אלקטרוניים. פורמט זה נתמך באופן מלא ב Aspose.Words לייצוא ספרים אלקטרוניים התואמים לרוב מכשירי הקריאה.
המרת מסמך
להמרה פשוטה ל HTML, MHTML, או EPUB, נעשה שימוש באחד מעומסי השיטה Save. באפשרותך לשמור את המסמך בקובץ או בזרם ולהגדיר במפורש את פורמט שמירת מסמך הפלט או להגדיר אותו מסיומת שם הקובץ.
הדוגמה הבאה מראה כיצד להמיר DOCX ל HTML עם ציון פורמט שמירה:
כדי להמיר מסמך ל MHTML או EPUB, השתמש SaveFormat.Mhtml או SaveFormat.Epub בהתאמה.
המרת מסמך עם מידע הלוך ושוב
הפורמט HTML אינו תומך בתכונות רבות Microsoft Word, ואם עלינו לשחזר מודל מסמך קרוב ככל האפשר למקור, עלינו לשמור מידע נוסף בתוך הקובץ HTML. מידע זה נקרא גם"מידע הלוך ושוב". למטרה זו, Aspose.Words מספק יכולת לייצא מידע הלוך ושוב בעת שמירה ל HTML, MHTML, או EPUB באמצעות המאפיין ExportRoundtripInformation. שמירת המידע הלוך ושוב מאפשרת שחזור מאפייני מסמך כגון כרטיסיות, הערות, כותרות עליונות ותחתונות במהלך טעינת המסמכים של הפורמטים המפורטים בחזרה לאובייקט Document.
ערך ברירת המחדל הוא true עבור HTML ו false עבור MHTML ו EPUB:
- כאשר true, המידע הלוך ושוב מיוצא כ - או - * CSS מאפיינים של האלמנטים המתאימים HTML
- כאשר false, אין מידע הלוך ושוב שיוצא לקבצים המיוצרים
דוגמת הקוד הבאה מראה כיצד לייצא מידע הלוך ושוב בעת המרת מסמך מ - DOCX ל - HTML:
ציין אפשרויות שמירה בעת המרה ל - HTML
Aspose.Words מאפשר המרת מסמך Word ל HTML באמצעות ברירת מחדל או אפשרויות שמירה מותאמות אישית. דוגמאות מעטות לאפשרויות שמירה מותאמות אישית מתוארות להלן.
ציין תיקיה לשמירת משאבים
באמצעות Aspose.Words אנו יכולים לציין תיקיה פיזית שבה כל המשאבים, כגון תמונות, גופנים ו CSS חיצוניים, נשמרים כאשר מסמך מומר ל HTML. כברירת מחדל, זוהי מחרוזת ריקה.
ציון המאפיין ResourceFolder הוא הדרך הפשוטה ביותר להגדיר את התיקיה שבה יש לכתוב את כל המשאבים. אנו יכולים להשתמש במאפיינים בודדים, כגון FontsFolder ששומר גופנים בתיקיה שצוינה ו ImagesFolder ששומר תמונות בתיקיה שצוינה. כאשר מצוין נתיב יחסי, FontsFolder ו ImagesFolder עיין בתיקיה בה נמצאת מכלול הקוד, ResourceFolder ו CssStyleSheetFileName עיין בתיקיית הפלט בה נמצא המסמך HTML.
בדוגמה זו, ResourceFolder מציין את הנתיב היחסי. נתיב זה מתייחס לתיקיית הפלט שבה נשמר המסמך HTML. הערך של המאפיין ResourceFolderAlias משמש ליצירת URLs עבור כל המשאבים.
דוגמת הקוד הבאה מראה כיצד לעבוד עם מאפיינים אלה:
באמצעות המאפיין ResourceFolderAlias, אנו יכולים גם לציין את שם התיקיה המשמשת לבניית URIs מכל המשאבים שנכתבו במסמך HTML. זוהי הדרך הפשוטה ביותר לציין כיצד יש ליצור URIs עבור כל קבצי המשאבים. ניתן לציין את אותו מידע עבור תמונות וגופנים בנפרד באמצעות ImagesFolderAlias ו FontsFolderAlias מאפיינים, בהתאמה.
עם זאת, אין תכונה אישית עבור CSS. ההתנהגות של FontsFolder, FontsFolderAlias, ImagesFolder, ImagesFolderAlias ו CssStyleSheetFileName מאפיינים אינם משתנים. שים לב שמאפיין CssStyleSheetFileName משמש הן לציון שם התיקיה והן לשם שם הקובץ.
- ResourceFolder יש עדיפות נמוכה יותר מאשר תיקיות שצוינו באמצעות FontsFolder, ImagesFolder, ו CssStyleSheetFileName. אם התיקיה שצוינה ב ResourceFolder אינו קיים, הוא ייווצר באופן אוטומטי.
- ResourceFolderAlias יש עדיפות נמוכה יותר מאשר FontsFolderAlias ו ImagesFolderAlias. אם ResourceFolderAlias ריק, הערך של המאפיין ResourceFolder ישמש ליצירת משאב URIs. אם ResourceFolderAlias מוגדר ל “.” (נקודה), משאב URIs יכיל רק שמות קבצים מבלי לציין נתיב.
ייצא משאבי גופני קידוד Base64
Aspose.Words מספק יכולת לציין אם יש להטמיע משאבי גופנים ב-HTML בקידוד Base64. כדי לבצע זאת, השתמש במאפיין ExportFontsAsBase64 - זהו הרחבה של המאפיין ExportFontResources. כברירת מחדל, הערך שלו הוא false, והגופנים נכתבים לקבצים נפרדים. אבל אם אפשרות זו מוגדרת ל-true, גופנים יוטמעו ב-CSS של המסמך בקידוד Base64. המאפיין ExportFontsAsBase64 משפיע רק על פורמט HTML ואינו משפיע על EPUB ו-MHTML.
דוגמא הקוד הבאה מראה כיצד לייצא גופנים מקודדים ב-Base64 אל HTML:
ציין אפשרויות שמירה בעת המרה ל - EPUB
Aspose.Words מאפשר המרת מסמך Word לפורמט EPUB באמצעות ברירת מחדל או אפשרויות שמירה מותאמות אישית. ניתן לציין מספר אפשרויות על ידי העברת מופע של HtmlSaveOptions לשיטה Save.
דוגמת הקוד הבאה מראה כיצד להמיר מסמך Word ל - EPUB עם ציון כמה אפשרויות שמירה מותאמות אישית: