ترجمة Markdown لتوثيق نموذج الكائن (DOM)

لقراءة محتوى المستند وتنسيقه ومعالجتها وتعديله برمجيا، تحتاج إلى ترجمته إلى نموذج كائن المستند Aspose.Words (DOM).

على عكس مستندات ورد، Markdown لا يتوافق مع DOM الموضح في Aspose.Words نموذج كائن المستند (DOM) المادة. ومع ذلك، توفر Aspose.Words آليتها الخاصة لترجمة Markdown المستندات إلى DOM والعودة، حتى نتمكن من العمل بنجاح مع عناصرها مثل تنسيق النص والجداول والرؤوس وغيرها.

تشرح هذه المقالة كيف يمكن ترجمة ميزات markdown المختلفة إلى Aspose.Words DOM والعودة إلى تنسيق Markdown.

تعقيد الترجمة Markdown – DOM – Markdown

الصعوبة الرئيسية لهذه الآلية ليست فقط ترجمة Markdown إلى DOM، ولكن أيضا لإجراء التحويل العكسي – لحفظ المستند مرة أخرى إلى تنسيق Markdown بأقل خسارة. هناك عناصر، مثل الاقتباسات متعددة المستويات، والتي لا يكون التحويل العكسي لها تافها.

يسمح محرك الترجمة الخاص بنا للمستخدمين ليس فقط بالعمل مع العناصر المعقدة في مستند Markdown موجود، ولكن أيضا لإنشاء مستند خاص بهم بتنسيق Markdown مع الهيكل الأصلي من البداية. لإنشاء عناصر مختلفة، تحتاج إلى استخدام أنماط بأسماء محددة وفقا لقواعد معينة موضحة لاحقا في هذه المقالة. يمكن إنشاء هذه الأنماط برمجيا.

مبادئ الترجمة المشتركة

نستخدم Font التنسيق للكتل المضمنة. عندما لا تكون هناك مراسلات مباشرة لميزة Markdown في Aspose.Words DOM، نستخدم نمط حرف باسم يبدأ من بعض الكلمات الخاصة.

بالنسبة إلى كتل الحاويات، نستخدم وراثة النمط للإشارة إلى ميزات Markdown المتداخلة. في هذه الحالة، حتى في حالة عدم وجود ميزات متداخلة، نستخدم أيضا أنماط الفقرات باسم يبدأ من بعض الكلمات الخاصة.

القوائم النقطية والمرتبة هي كتل الحاويات في Markdown كذلك. يتم تمثيل تعشيشها في DOM بنفس الطريقة بالنسبة لجميع كتل الحاويات الأخرى باستخدام وراثة النمط. ومع ذلك، بالإضافة إلى ذلك، فإن القوائم في DOM تتوافق مع تنسيق الأرقام إما في نمط القائمة أو تنسيق الفقرة.

كتل مضمنة

نستخدم Font التنسيق عند ترجمة Bold، Italic أو ~~Strikethrough~~ مضمنة markdown الميزات.

Markdown ميزة Aspose.Words

Bold
**bold text** get_Font()->set_Bold(true)

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	// Use a document builder to add content to the document.
	auto builder = System::MakeObject<DocumentBuilder>();

	// Make the text Bold.
	builder->get_Font()->set_Bold(true);
	builder->Writeln(u"This text will be Bold");

view raw Examples-DocsExamples-source-Programming with Documents-Working with Markdown-BoldText.h hosted with ❤ by GitHub

Italic
*italic text* get_Font()->set_Italic(true)

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	// Use a document builder to add content to the document.
	auto builder = System::MakeObject<DocumentBuilder>();

	// Make the text Italic.
	builder->get_Font()->set_Italic(true);
	builder->Writeln(u"This text will be Italic");

view raw Examples-DocsExamples-source-Programming with Documents-Working with Markdown-ItalicText.h hosted with ❤ by GitHub

Strikethrough
~Strikethrough text~ get_Font()->set_StrikeThrough(true)

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	// Use a document builder to add content to the document.
	auto builder = System::MakeObject<DocumentBuilder>();

	// Make the text Strikethrough.
	builder->get_Font()->set_StrikeThrough(true);
	builder->Writeln(u"This text will be Strikethrough");

view raw Examples-DocsExamples-source-Programming with Documents-Working with Markdown-Strikethrough.h hosted with ❤ by GitHub

نستخدم نمط حرف باسم يبدأ من الكلمة InlineCode، متبوعا بنقطة اختيارية (.) وعدد من العلامات الخلفية (`) لميزة InlineCode. إذا فات عدد من العلامات الخلفية، فسيتم استخدام علامة خلفية واحدة افتراضيا.

Markdown ميزة Aspose.Words

InlineCode
**inline code** get_Font()->set_StyleName(u"InlineCode[.][N]")

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	// Use a document builder to add content to the document.
	auto builder = System::MakeObject<DocumentBuilder>();

	// Number of backticks is missed, one backtick will be used by default.
	auto inlineCode1BackTicks = builder->get_Document()->get_Styles->Add(StyleType::Character, u"InlineCode");
	builder->get_Font()->set_Style(inlineCode1BackTicks);
	builder->Writeln(u"Text with InlineCode style with 1 backtick");

	// There will be 3 backticks.
	auto inlineCode3BackTicks = builder->get_Document()->get_Styles->Add(StyleType::Character, u"InlineCode.3");
	builder->get_Font()->set_Style(inlineCode3BackTicks);
	builder->Writeln(u"Text with InlineCode style with 3 backtick");

view raw Examples-DocsExamples-source-Programming with Documents-Working with Markdown-InlineCode.h hosted with ❤ by GitHub

Autolink
<scheme://domain.com>
<email@domain.com> فئة FieldHyperlink.

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	// Use a document builder to add content to the document.
	auto builder = System::MakeObject<DocumentBuilder>();

	// Insert hyperlink.
	builder->InsertHyperlink(u"https://www.aspose.com", u"https://www.aspose.com", false);
	builder->InsertHyperlink(u"email@aspose.com", u"mailto:email@aspose.com", false);

view raw Examples-DocsExamples-source-Programming with Documents-Working with Markdown-Autolink.h hosted with ❤ by GitHub

Link
[link text](url)
[link text](<url>"title")
[link text](url 'title')
[link text](url (title)) فئة FieldHyperlink.

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	// Use a document builder to add content to the document.
	auto builder = System::MakeObject<DocumentBuilder>();

	// Insert hyperlink.
	builder->InsertHyperlink(u"Aspose", u"https://www.aspose.com", false);

view raw Examples-DocsExamples-source-Programming with Documents-Working with Markdown-Link.h hosted with ❤ by GitHub

Image
![](url)
![alt text](<url>"title")
![alt text](url ‘title’)
![alt text](url (title)) فئة Shape.

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	// Use a document builder to add content to the document.
	auto doc = System::MakeObject<Document>();
	auto builder = System::MakeObject<DocumentBuilder>(doc);

	// Insert image.
	auto shape = System::MakeObject<Shape>(doc, ShapeType::Image);
	shape->set_WrapType(WrapType::Inline);
	shape->get_ImageData()->set_SourceFullName(u"/attachment/1456/pic001.png");
	shape->get_ImageData()->set_Title(u"title");
	builder->InsertNode(shape);

view raw Examples-DocsExamples-source-Programming with Documents-Working with Markdown-Image.h hosted with ❤ by GitHub

كتل الحاويات

المستند عبارة عن سلسلة من كتل الحاويات مثل العناوين والفقرات والقوائم وعلامات الاقتباس وغيرها. يمكن تقسيم كتل الحاويات إلى فئات 2: كتل الأوراق والحاويات المعقدة. يمكن أن تحتوي كتل الأوراق على محتوى مضمن فقط. يمكن أن تحتوي الحاويات المعقدة بدورها على كتل حاويات أخرى، بما في ذلك كتل الأوراق.

كتل الأوراق

يوضح الجدول أدناه أمثلة على استخدام Markdown كتل الأوراق في Aspose.Words:

Markdown ميزة Aspose.Words

HorizontalRule
----- هذه فقرة بسيطة ذات شكل HorizontalRule مطابق:
DocumentBuilder::InsertHorizontalRule()

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	// Use a document builder to add content to the document.
	auto builder = System::MakeObject<DocumentBuilder>();

	// Insert horizontal rule.
	builder->InsertHorizontalRule();

view raw Examples-DocsExamples-source-Programming with Documents-Working with Markdown-HorizontalRule.h hosted with ❤ by GitHub

ATX Heading
# H1, ## H2, ### H3… get_ParagraphFormat()->set_StyleName(u"Heading N")، حيث (1<= ن <= 9).
يتم ترجمة هذا إلى نمط مدمج ويجب أن يكون بالضبط من النمط المحدد (لا يسمح باللواحق أو البادئات).
خلاف ذلك، سيكون مجرد فقرة عادية مع نمط المقابلة.

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	// Use a document builder to add content to the document.
	auto builder = System::MakeObject<DocumentBuilder>();

	// By default Heading styles in Word may have Bold and Italic formatting.
	// If we do not want to be emphasized, set these properties explicitly to false.
	builder->get_Font()->set_Bold(false);
	builder->get_Font()->set_Italic(false);

	builder->get_ParagraphFormat()->set_StyleName(u"Heading 1");
	builder->Writeln(u"This is an H1 tag");

view raw Examples-DocsExamples-source-Programming with Documents-Working with Markdown-Heading.h hosted with ❤ by GitHub

Setext Heading
=== (if Heading level 1),
--- (if Heading level 2) get_ParagraphFormat->set_StyleName(u"SetextHeading[some suffix]")، على أساس "Heading N" نمط.
إذا (ن > = 2)، فسيتم استخدام "Heading 2"، وإلا "Heading 1".
يسمح بأي لاحقة، لكن المستورد Aspose.Words يستخدم الأرقام “1” و" 2 " على التوالي.

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	// Use a document builder to add content to the document.
	auto doc = System::MakeObject<Document>();
	auto builder = System::MakeObject<DocumentBuilder>(doc);

	builder->get_ParagraphFormat()->set_StyleName(u"Heading 1");
	builder->Writeln(u"This is an H1 tag");

	// Reset styles from the previous paragraph to not combine styles between paragraphs.
	builder->get_Font()->set_Bold(false);
	builder->get_Font()->set_Italic(false);

	auto setexHeading1 = builder->get_Document()->get_Styles->Add(StyleType::Paragraph, u"SetextHeading1");
	builder->get_ParagraphFormat()->set_Style(setexHeading1);
	doc->get_Styles()->idx_get(u"SetextHeading1")->set_BaseStyleName(u"Heading 1");
	builder->Writeln(u"Setext Heading level 1");

	builder->get_ParagraphFormat()->set_Style(doc->get_Styles()->idx_get(u"Heading 3"));
	builder->Writeln(u"This is an H3 tag");

	// Reset styles from the previous paragraph to not combine styles between paragraphs.
	builder->get_Font()->set_Bold(false);
	builder->get_Font()->set_Italic(false);

	auto setexHeading2 = builder->get_Document()->get_Styles->Add(StyleType::Paragraph, u"SetextHeading2");
	builder->get_ParagraphFormat()->set_Style(setexHeading2);
	doc->get_Styles()->idx_get(u"SetextHeading2")->set_BaseStyleName(u"Heading 3");

	// Setex heading level will be reset to 2 if the base paragraph has a Heading level greater than 2.
	builder->Writeln(u"Setext Heading level 2");

view raw Examples-DocsExamples-source-Programming with Documents-Working with Markdown-SetextHeading.h hosted with ❤ by GitHub

Indented Code get_ParagraphFormat->set_StyleName(u"IndentedCode[some suffix]")

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	// Use a document builder to add content to the document.
	auto doc = System::MakeObject<Document>();
	auto builder = System::MakeObject<DocumentBuilder>(doc);

	auto indentedCode = builder->get_Document()->get_Styles->Add(StyleType::Paragraph, u"IndentedCode");
	builder->get_ParagraphFormat()->set_StyleName(indentedCode);
	builder->Writeln(u"This is an indented code");

view raw Examples-DocsExamples-source-Programming with Documents-Working with Markdown-IndentedCode.h hosted with ❤ by GitHub

Fenced Code

``` c#
if ()
then
else
```

get_ParagraphFormat()->set_StyleName(u"FencedCode[.][info string]")
[.] و [info string] اختيارية.

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	// Use a document builder to add content to the document.
	auto doc = System::MakeObject<Document>();
	auto builder = System::MakeObject<DocumentBuilder>(doc);

	auto fencedCode = builder->get_Document()->get_Styles->Add(StyleType::Paragraph, u"FencedCode");
	builder->get_ParagraphFormat()->set_StyleName(fencedCode);
	builder->Writeln(u"This is an fenced code");

	auto fencedCodeWithInfo = builder->get_Document()->get_Styles->Add(StyleType::Paragraph, u"FencedCode.C#");
	builder->get_ParagraphFormat()->set_StyleName(fencedCodeWithInfo);
	builder->Writeln(u"This is a fenced code with info string");

view raw Examples-DocsExamples-source-Programming with Documents-Working with Markdown-FencedCode.h hosted with ❤ by GitHub

حاويات معقدة

يوضح الجدول أدناه أمثلة على استخدام Markdown حاويات معقدة في Aspose.Words:

Markdown ميزة Aspose.Words

Quote
> quote,
>> nested quote get_ParagraphFormat()->set_StyleName(u"Quote[some suffix]")
اللاحقة في اسم النمط اختيارية، ولكن Aspose.Words المستورد يستخدم الأرقام المطلوبة1, 2, 3, …. في حالة الاقتباسات المتداخلة.
يتم تعريف التعشيش عبر الأنماط الموروثة.

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	// Use a document builder to add content to the document.
	auto doc = System::MakeObject<Document>();
	auto builder = System::MakeObject<DocumentBuilder>(doc);

	// By default a document stores blockquote style for the first level.
	builder->get_ParagraphFormat()->set_StyleName(u"Quote");
	builder->Writeln(u"Blockquote");

	// Create styles for nested levels through style inheritance.
	auto quoteLevel2 = builder->get_Document()->get_Styles->Add(StyleType::Paragraph, u"Quote1");
	builder->get_ParagraphFormat()->set_StyleName(quoteLevel2);
	builder->get_Document()->get_Styles->idx_get(u"Quote1")->set_BaseStyleName(u"Quote");
	builder->Writeln(u"1. Nested blockquote");

view raw Examples-DocsExamples-source-Programming with Documents-Working with Markdown-Quote.h hosted with ❤ by GitHub

BulletedList
- Item 1
- Item 2
- Item 2a
- Item 2b يتم تمثيل القوائم النقطية باستخدام ترقيم الفقرات:
get_ListFormat()->ApplyBulletDefault()
يمكن أن يكون هناك 3 أنواع القوائم النقطية. هم فقط فرق في تنسيق ترقيم من المستوى الأول. هذه هي: ‘-’، ‘+’ أو ‘*’ على التوالي.

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	// Use a document builder to add content to the document.
	auto builder = System::MakeObject<DocumentBuilder>();

	builder->get_ListFormat()->ApplyBulletDefault();
	builder->get_ListFormat()->get_List()->get_ListLevels()->idx_get(0)->set_NumberFormat(u"-");

	builder->Writeln(u"Item 1");
	builder->Writeln(u"Item 2");

	builder->get_ListFormat()->ListIndent();

	builder->Writeln(u"Item 2a");
	builder->Writeln(u"Item 2b");

view raw Examples-DocsExamples-source-Programming with Documents-Working with Markdown-BulletedList.h hosted with ❤ by GitHub

OrderedList
1. Item 1
2. Item 2
1) Item 2a
2) Item 2b يتم تمثيل القوائم المرتبة باستخدام ترقيم الفقرات:
get_ListFormat()->ApplyNumberDefault()
يمكن أن يكون هناك 2 علامات تنسيق الأرقام: ‘.’ و ‘)’. العلامة الافتراضية هي ‘.’.

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	// Use a document builder to add content to the document.
	auto builder = System::MakeObject<DocumentBuilder>();

	builder->get_ListFormat()->ApplyBulletDefault();
	builder->get_ListFormat()->get_List()->get_ListLevels()->idx_get(0)->set_NumberFormat(System::String::Format(u"{0}.", (char16_t)0));
	builder->get_ListFormat()->get_List()->get_ListLevels()->idx_get(1)->set_NumberFormat(System::String::Format(u"{0}.", (char16_t)1));

	builder->Writeln(u"Item 1");
	builder->Writeln(u"Item 2");

	builder->get_ListFormat()->ListIndent();

	builder->Writeln(u"Item 2a");
	builder->Writeln(u"Item 2b");

view raw Examples-DocsExamples-source-Programming with Documents-Working with Markdown-OrderedList.h hosted with ❤ by GitHub

الجداول

Aspose.Words يسمح أيضا بترجمة الجداول إلى DOM، كما هو موضح أدناه:

Markdown ميزة Aspose.Words

Table
a|b
-|-
c|d Table، Row و Cell الطبقات.

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	// Use a document builder to add content to the document.
	auto builder = System::MakeObject<DocumentBuilder>();

	// Add the first row.
	builder->InsertCell();
	builder->Writeln(u"a");
	builder->InsertCell();
	builder->Writeln(u"b");

	// Add the second row.
	builder->InsertCell();
	builder->Writeln(u"c");
	builder->InsertCell();
	builder->Writeln(u"d");

view raw Examples-DocsExamples-source-Programming with Documents-Working with Markdown-Table.h hosted with ❤ by GitHub

أنظر أيضا

العمل مع Markdown الميزات

Aspose.Words نموذج كائن المستند (DOM) في C++ نظرة عامة على منشئ المستندات في C++