תרגום Markdown to to Document Object Model ()DOM)
כדי לקרוא, לתמרן ולשנות את התוכן ואת הפורמט של מסמך, עליך לתרגם אותו ל Aspose.Words Document Object Model ()DOM).
בניגוד למסמכים של Word, Markdown לא תואם את DOM תואר ב Aspose.Words Document Object Model (DOM) מאמר. עם Aspose.Words מספק מנגנון משלו לתרגום Markdown מסמכים DOM ובחזרה, כך שנוכל לעבוד בהצלחה עם האלמנטים שלהם כגון פורמט טקסט, טבלאות, ראשים ואחרים.
מאמר זה מסביר כיצד השונים markdown ניתן לתרגם תכונות לתוך Aspose.Words DOM ובחזרה Markdown פורמט.
המורכבות של התרגום Markdown - - - DOM - - - Markdown
הקושי העיקרי של מנגנון זה אינו רק לתרגם Markdown to to DOM, אבל גם לעשות את הטרנספורמציה לאחור - כדי להציל את המסמך בחזרה Markdown פורמט עם אובדן מינימלי. ישנם אלמנטים, כגון ציטוטים רב-דרגיים, שעבורם השינוי הפוך אינו טריוויאלי.
מנוע התרגום שלנו מאפשר למשתמשים לא רק לעבוד עם אלמנטים מורכבים הקיימים Markdown מסמך, אך גם ליצירת מסמך משלו Markdown פורמט עם המבנה המקורי מאפס. כדי ליצור אלמנטים שונים, עליך להשתמש בסגנונות עם שמות ספציפיים על פי כללים מסוימים המתוארים מאוחר יותר במאמר זה. ניתן ליצור סגנונות כאלה באופן מתודולוגי.
תרגום כללי עקרונות
אנו משתמשים Font עיצוב בלוקים פנימיים כשאין התכתבות ישירה Markdown תכונה Aspose.Words DOM, אנו משתמשים בסגנון אופי עם שם שמתחיל מכמה מילים מיוחדות.
עבור בלוקי מכולה, אנו משתמשים בירושה בסגנון כדי לציין קינון Markdown תכונות. במקרה זה, גם כאשר אין תכונות מקוננות, אנו משתמשים גם בסגנונות סעיף עם שם שמתחיל מכמה מילים מיוחדות.
רשימות מוצפות וצווים הן בלוקים של מיכל Markdown גם. הקן שלהם מיוצג ב DOM אותו אופן כמו עבור כל בלוקים אחרים באמצעות ירושה בסגנון. בנוסף, רשימות DOM התאימו את מספר הפורמטים בכל סגנון רשימה או פיסקה.
Inline Blocks
אנו משתמשים Font עיצוב מתי לתרגם Bold, Italic המונחים: Strike Through - Inline markdown תכונות.
Markdown תכונה | Aspose.Words |
---|---|
Bold{1} |
Font.Bold = true |
Italic*italic text* |
Font.Italic = true |
Strikethrough~Strikethrough text~ |
Font.StrikeThrough = true |
אנו משתמשים בסגנון אופי עם שם שמתחיל מהמילה InlineCode
עקבו אחרי אופציונלי (.)
מספר חזרות (`)
עבור InlineCode
תכונה. אם כמות של backticks מפספסת, אז טיפול אחד ישמש כברירת מחדל.
Markdown תכונה | Aspose.Words |
---|---|
InlineCode{1} |
Font.StyleName = “InlineCode[.][N]” |
Autolink<scheme://domain.com> <email@domain.com> |
The The The FieldHyperlink מעמד |
Link{1} {2} {3} {4}) |
The The The FieldHyperlink מעמד |
Image{1} {2} {3} {4}) |
The The The Shape מעמד |
מכיל בלוקים
מסמך הוא רצף של בלוקים של מיכל כגון כותרות, פסקאות, רשימות, ציטוטים ואחרים. בלוקים המכילים ניתן לחלק לשתי כיתות: בלוקים ומכלילים מורכבים בלוקים עלים יכולים להכיל רק תכנים פנימיים. מיכלים מורכבים, בתורו, יכולים להכיל בלוקים אחרים של מיכל, כולל בלוקים עלים.
תגית: Blocks
השולחן למטה מציג דוגמאות לשימוש Markdown בלוקים ב Aspose.Words:
Markdown תכונה | Aspose.Words |
---|---|
HorizontalRule----- |
זהו פסקה פשוטה עם צורת HorizontalRule המקבילה:DocumentBuilder.InsertHorizontalRule() |
ATX Heading# H1, ## H2, ### H3… |
ParagraphFormat.StyleName = "Heading N" , שם (1=N <= 9).זה מתורגם לסגנון מובנה צריך להיות בדיוק של התבנית המפורטת (לא suffixes או prefixes מותר). אחרת, זה יהיה רק סעיף רגיל עם סגנון מתאים |
Setext Heading=== (אם רמת ראש 1)--- (אם רמת ראש 2) |
ParagraphFormat.StyleName = “SetextHeading[some suffix]” , מבוסס ‘Heading N’ סגנון.אם (==) ‘Heading 2’ ישמש, אחרת ‘Heading 1’. כל suffix מותר, אבל Aspose.Words יבוא משתמש במספרים “1” ו-“2” בהתאמה |
Indented Code | ParagraphFormat.StyleName = “IndentedCode[some suffix]” |
Fenced Code
|
ParagraphFormat.StyleName = “FencedCode[.][info string]” The The The [.] ו [info string] הם אופציונליים |
תגית: Containers
השולחן למטה מציג דוגמאות לשימוש Markdown קומפלקסים ב Aspose.Words:
Markdown תכונה | Aspose.Words |
---|---|
Quote> quote, >> nested quote |
ParagraphFormat.StyleName = “Quote[some suffix]” suffix בשם סגנון הוא אופציונלי, אבל Aspose.Words יבוא משתמש במספרים המוזמנים 1, 2, 3, במקרה של ציטוטים מזוינים. הקן מוגדר באמצעות סגנונות תורשתיים |
BulletedList- Item 1 - Item 2 - Item 2a - Item 2b |
רשימות מוכות מיוצגות באמצעות סעיף מספר:ListFormat.ApplyBulletDefault() יכול להיות שיש 3 סוגים של רשימות. הם רק מסתפקים בתבנית מספרית של הרמה הראשונה. אלה הם: ‘-’ , ‘+’ או ‘*’ בהתאמה |
OrderedList1. Item 1 2. Item 2 1) Item 2a 2) Item 2b |
רשימות מסודרות מיוצגות באמצעות סעיף מספר:ListFormat.ApplyNumberDefault() יכול להיות שני סמנים: “. סימן ברירת המחדל הוא " |
שולחנות
Aspose.Words מאפשר לתרגם טבלאות DOM, כפי שמוצג להלן:
Markdown תכונה | Aspose.Words |
---|---|
Table “a |
B<br /> - - |