Rich Text to Markdown

به عنوان یک توسعه‌دهنده C#، شما اغلب با نیاز به تبدیل متن غنی به فرمت‌های مختلف برای اهداف گوناگون روبرو هستید. در این پست وبلاگ، ما داستان کاربر استخراج متن غنی به عنوان سینتکس Markdown در C# را بررسی خواهیم کرد و از کتابخانه قوی Conholdate.Total برای .NET استفاده خواهیم کرد. در پایان، شما درک روشنی از فرآیند خواهید داشت و آماده خواهید بود تا این ویژگی را به راحتی به پروژه‌های خود ادغام کنید.

User Story:

به عنوان یک توسعه‌دهنده C# که در حال کار بر روی یک سیستم مدیریت محتوا هستم، می‌خواهم به کاربران این امکان را بدهم که متن غنی وارد کرده و آن را به نحو Markdown تبدیل کنند. این کار به آن‌ها انعطاف‌پذیری و سادگی فرمت‌بندی Markdown را ارائه خواهد داد. بیایید به مراحل مورد نیاز برای دستیابی به این هدف با استفاده از کتابخانه Conholdate.Total برای .NET نگاهی بیندازیم.

مرحله 1: نصب Conholdate.Total برای .NET

برای شروع، کتابخانه Conholdate.Total for .NET را به دست آورید. آن را از وب‌سایت رسمی Conholdate دانلود کنید یا با استفاده از یک مدیر بسته مانند NuGet نصب کنید.

Install-Package Conholdate.Total

مرحله ۲: راه اندازی کتابخانه

پس از نصب کتابخانه، آن را در پروژه C# خود初始化 کنید. تنظیمات و مراجع لازم را پیکربندی کنید تا به طور یکپارچه با کد موجود شما ادغام شود.

مرحله ۳: بارگذاری سند متن غنی

مدرک متن غنی که نیاز به تبدیل به ساختار مارک‌داown دارد را بازیابی کنید. این مدرک می‌تواند به عنوان یک فایل، یک ورودی پایگاه داده، یا به صورت پویا درون برنامه شما تولید شود. Conholdate.Total برای .NET از فرمت‌های فایل محبوب مانند DOCX، RTF، HTML و بیشتر، پشتیبانی می‌کند و قابلیت هماهنگی با منابع متن غنی متنوع را تسهیل می‌کند.

مرحله ۴: استخراج محتوای متن غنی

از Conholdate.Total برای .NET استفاده کنید تا محتویات از سند متن غنی بارگذاری شده استخراج شود. این کتابخانه روش‌های شهودی را برای دسترسی و دستکاری جنبه‌های مختلف سند، مانند پاراگراف‌ها، عناوین، سبک‌ها و غیره فراهم می‌کند.

برای استخراج متن غنی از اسناد، به سادگی متد GetFormattedText را فراخوانی کنید:

TextReader GetFormattedText(FormattedTextOptions options);

مرحله 5: تبدیل متن غنی به Markdown

با استفاده از قابلیت‌های Conholdate.Total، محتوای متنی غنی استخراج‌شده را به سینتکس Markdown تبدیل کنید. این کتابخانه کلاس FormattedTextOptions را ارائه می‌دهد. سازنده کلاس آن را با حالت مشخص‌شده از enum FormattedTextMode مقداردهی اولیه می‌کند. شما باید FormattedTextMode.Markdown را تنظیم کنید.

FormattedTextOptions(FormattedTextMode.Markdown)

بنابراین، در اینجا مراحل ساده‌ای که باید دنبال کنید آورده شده است:

  1. Firstly, instantiate a Parser object for the initial document.
  2. Next, instantiate a FormattedTextOptions object with Markdown text mode.
  3. سپس، روش GetFormattedText را فراخوانی کنید و یک شیء TextReader را به دست آورید.
  4. در نهایت، بررسی کنید که خواننده null نیست و متن را از خواننده بخوانید.

کد منبع به این صورت خواهد بود:

// Create an instance of Parser class
using (Parser parser = new Parser("sample.docx"))
{
    // Extract a formatted text into the reader
    using (TextReader reader = parser.GetFormattedText(new FormattedTextOptions(FormattedTextMode.Markdown)))
    {
        // Print a formatted text from the document
        // If formatted text extraction isn't supported, a reader is null
        Console.WriteLine(reader == null ? "Formatted text extraction isn't supported" : reader.ReadToEnd());
    }
}

مرحله ۶: ارائه Markdown تبدیل شده

زمانی که متن غنی با موفقیت به Markdown تبدیل شد، خروجی را به کاربر ارائه دهید. این می‌تواند شامل ارائه یک پیش‌نمایش، ذخیره محتوای تبدیل شده در یک فایل، یا ادغام آن در یک ویرایشگر Markdown باشد. سپس کاربران می‌توانند محتوای خود را با استفاده از ویژگی‌های آشنا Markdown بهبود و اصلاح کنند.

Output:

فرض کنید فایل ورودی محتوایی مانند شکل زیر دارد:

Rich Text to Markdown

Output:

خروجی به صورت خواهد بود:

**Rich Text**

Lorem ipsum **dolor sit amet**, consectetuer adipiscing elit. Maecenas porttitor congue massa. *Fusce posuere*, magna sed pulvinar ultricies, *purus lectus malesuada libero*, sit amet commodo magna eros quis urna.

1. Nunc viverra imperdiet enim. Fusce est. Vivamus a tellus.
2. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.
3.  Proin pharetra nonummy pede. Mauris et orci.

Aenean nec lorem

* In porttitor. Donec laoreet nonummy augue.
* Suspendisse dui purus, scelerisque at, vulputate vitae, pretium mattis, nunc.
* Mauris eget neque at sem venenatis eleifend. Ut nonummy.

خلاصه‌سازی

تبریک می‌گوییم! شما موفق به تکمیل داستان کاربری استخراج متن غنی به‌عنوان نحوی Markdown در C# با استفاده از کتابخانه قدرتمند Conholdate.Total for .NET شدید. با بهره‌گیری از قابلیت‌های این کتابخانه، شما می‌توانید به‌راحتی اسناد متن غنی را به فرمت Markdown تبدیل کنید و امکانات جدیدی برای دستکاری و فرمت‌بندی محتوا ایجاد کنید. برنامه‌نویسی خوش بگذرد!

Conholdate.Total برای .NET منابع:

لطفاً به منابع زیر مراجعه کنید تا بیشتر با کتابخانه آشنا شوید:

Get a Free License:

شما می‌توانید یک مجوز موقتی رایگان دانلود کنید تا کتابخانه را بدون محدودیت‌های ارزیابی تست کنید.

سؤال بپرسید:

شما می‌توانید سوالات یا نظرات خود را در مورد کتابخانه در این forum به اشتراک بگذارید.

See Also: