اخیراً کارمندان دیجی‌کالا تصمیم گرفته‌اند که پست‌های وبلاگ‌شان را با فرمت مارک‌داون بنویسند. مارک‌داون یک زبان نشانه‌گذاری برای قالب‌بندی متن با امکان تبدیل به فرمت‌های مختلف از جمله HTML است. با استفاده از مارک‌داون به‌راحتی می‌توان تیتر، متن‌های bold ، italic ، نقل‌قول و... ایجاد کرد. از مارک‌داون در وب‌سایت‌هایی نظیر GitHub نیز استفاده می‌شود. برای کسب اطلاعات بیش‌تر درباره‌ی مارک‌داون به این‌جا مراجعه کنید.
از شما می‌خواهیم کلاسی برای تبدیل مارک‌داون به HTML با بهره‌گیری از عبارات باقاعده (Regex) پیاده‌سازی کنید.
ساختار پروژه
پروژه‌ی اولیه را می‌توانید از این‌جا دانلود کنید.
اینترفیس RuleInterface
برای مدیریت روش‌های تبدیل مارک‌داون به HTML ، اینترفیسی با نام RuleInterface ایجاد کرده‌ایم؛ زیرا ممکن است در آینده با روشی غیر از عبارات باقاعده فرایند تبدیل را انجام دهیم. این اینترفیس شامل یک متد با نام parse است که باید رشته‌ای شامل محتوای مارک‌داون را دریافت کرده و خروجی موردنظر را برگرداند.
اینترفیس RegexRuleInterface
این اینترفیس از اینترفیس RuleInterface پیروی کرده و وظیفه‌ی آن، مدیریت قواعد مختلف برای تبدیل مارک‌داون به HTML است. متدی با نام rule در این اینترفیس وجود دارد که باید رشته‌ای شامل یک عبارت باقاعده برای تشخیص یکی از عناصر مارک‌داون را برگرداند.
کلاس انتزاعی RegexRule
این کلاس، اینترفیس RegexRuleInterface را پیاده‌سازی می‌کند. متدی انتزاعی با نام replacement در این کلاس موجود است که باید رشته‌ای شامل عبارتی که قرار است جایگزین نتایج اجرای عبارت باقاعده روی محتوای مارک‌داون شود را برگرداند.
کلاس MarkdownParser
این کلاس با استفاده از نمونه‌هایی از کلاس‌های مختلف که از کلاس RegexRule ارث‌بری می‌کنند، محتوای مارک‌داون را به HTML تبدیل می‌کند. متدی با نام render در این کلاس وجود دارد که یک رشته‌ی مارک‌داون دریافت کرده و خروجی HTML آن را برمی‌گرداند.
پیاده‌سازی
در حال حاضر از هفت عنصر مختلف در مارک‌داون استفاده می‌کنیم که باید قوانین استخراج و جایگزینی آن‌ها را پیاده‌سازی کنید. همه‌ی این قوانین باید تحت قالب کلاس‌هایی مجزا که از کلاس RegexRule ارث‌بری می‌کنند باشند. هر کدام از این کلاس‌ها، دو متد rule و replacement را خواهند داشت و هر کلاس باید در فایلی هم‌نام با نام کلاس پیاده‌سازی شود.
- تیتر (کلاس
Header): این کلاس باید تیترهای موجود در متن را پردازش کند. تیترها در مارک‌داون از یک الی شش کاراکتر#به‌همراه فضای خالی در ادامه‌ی آن‌ها (به‌صورت اختیاری) و نام تیتر تشکیل شده‌اند:
# heading
##heading
### heading
#### heading
##### heading
######heading
تیترها را توسط کلاس Header به تگ h3 تبدیل کنید:
<h3>heading</h3>
<h3>heading</h3>
<h3>heading</h3>
<h3>heading</h3>
<h3>heading</h3>
<h3>heading</h3>
- متن bold (کلاس
Bold): این کلاس باید متن‌های bold را پردازش کند. متن‌های bold در مارک‌داون بین دو**یا دو__قرار می‌گیرند:
**bold 1**
__bold 2__
متن‌های bold را توسط کلاس Bold به تگ b تبدیل کنید:
<b>bold 1</b>
<b>bold 2</b>
- متن italic (کلاس
Italic): این کلاس باید متن‌های italic را پردازش کند. متن‌های italic در مارک‌داون بین دو*یا دو_قرار می‌گیرند:
*italic 1*
_italic 2_
متن‌های italic را توسط کلاس Italic به تگ i تبدیل کنید:
<i>italic 1</i>
<i>italic 2</i>
- لینک (کلاس
Link): این کلاس باید لینک‌ها را پردازش کند. لینک‌ها در مارک‌داون به‌صورت زیر هستند:
[Link to Google](https://google.com)
لینک‌ها را توسط کلاس Link به تگ a تبدیل کنید:
<a href="https://google.com">Link to Google</a>
- تصویر (کلاس
Image): این کلاس باید تصاویر را پردازش کند. تصاویر در مارک‌داون به‌صورت زیر هستند:
تصاویر را توسط کلاس Image به تگ img تبدیل کنید:
<img src="https://cdn.quera.ir/images/logo/logo-q.0-3aee17faf53e.svg" alt="Quera's Logo">
- کد (کلاس
Code): این کلاس باید کدها را پردازش کند. کدها در مارک‌داون بین دو ` قرار می‌گیرند:
`echo "Hello, World!";`
کدها را توسط کلاس Code به تگ code تبدیل کنید:
<code>echo "Hello, World!";</code>
- خط افقی (کلاس
HorizontalRule): این کلاس باید خطوط افقی را پردازش کنند. خطوط افقی در مارک‌داون از ۳ یا تعداد بیش‌تری-پشت سر هم تشکیل می‌شوند:
---
-----
----
خطوط افقی را توسط کلاس HorizontalRule به تگ hr تبدیل کنید:
<hr>
<hr>
<hr>
نکته: لزوماً نباید همه‌ی کلاس‌های بالا را پیاده‌سازی کنید. به ازای هر کلاس، امتیاز آن را به‌صورت جدا دریافت خواهید کرد.
آن‌چه باید آپلود کنید
پس از پیاده‌سازی کلاس‌های بالا، فایل‌های زیر را به‌صورت Zip ارسال کنید:
Header.php
Bold.php
Italic.php
Link.php
Image.php
Code.php
HorizontalRule.php
ارسال پاسخ برای این سؤال