شاید براتون پیش بیاد که بخواید مارک دان رو داخل پلتفرم ساخت خودتون استفاده کنید و وجه و کارایی پروژه تون رو افزایش بدید. اول باید بدونیم که اصلا مارک دان چی هست

مارک دان:

وبسایت گیت هاب (github) برای فرمت بندی و قالب بندی متن ها و کامنت ها سینتکسی را معرفی کرد به نام markdown که با استفاده از این سینتکس می توان متن ها را از حالت متن خالی خارج و به فرمتی شبیه به Html تبدیل نمود بعنوان مثال می توان متنی را Bold نمود و یا یک لینک داخل متن ایجاد کرد یا عکسی قرار داد و سایر موارد دیگر.

Markdown یا «متن مرتب» شیوه نمایش متن با علامت های ساده است، یک زبان نشانه گذاری سبک با ساختار تمام متن و کاربرد آسان برای نوشتن اسناد و محتوای وب که در نهایت به HTML ترجمه و با ساختار بندی نمایش داده میشه.

بر خلاف نرم افزارهای پردازش متن سنگین موجود، محتوا تولید شده در قالب مارک داون رو میشه به راحتی بین دستگاه های مختلفی از جمله کامپیوتر، موبایل و … به اشتراک گذاشت. به همین دلیل و مزیتش داره به یک استاندارد نوشتن برای دانشگاهیان، دانشمندان، نویسندگان و … تبدیل میشه. فایل های مارک داون با پسوند .markdown یا بطور مختصر .md ذخیره میشن و ساختار و قواعدی برای نمایش محتوا دارند.

خب حالا بریم سراغ استفاده از این تکنولوژی در پروژه لاراول

• برای اینکار باید از پکیج graham-campbell/markdown استفاده کنیم که پیش نیازش برای نصب پکیج league/commonmark.

بریم برای نصب:

اول از همه ترمینال رو باز کنید و به مسیر پروژتون برید و پکیج ها رو نصب کنید:

composer require league/commonmark

• اگر دستور بالا رو بزنید نسخه ی 2.0 رو برای شما نصب میکنه که به درد ما نمیخوره،چون graham-campbell/markdown از نسخه 1.5 استفاده میکنه.پس پکیج رو با دستور زیر نصب کنید.

  composer require league/commonmark ^1.5

بعد از اون نوبت نصب graham-campbell/markdown میرسه.با دستور زیر

composer require graham-campbell/markdown

بعد از اینکار پکیج شما نصب شده و حالا نوبت به معتبر سازی پکیج و استفاده میرسه

• معتبر سازی: برای اینکار به فولدر config رفته و فایل app.php رو باز کنید و در قسمت aliases کد زیر رو به آخر آرایه اضافه کنید.

  'Markdown' => GrahamCampbell\Markdown\Facades\Markdown::class

سپس دستور php artisan vendor:publish را در ترمینال اجرا کنید و بعد از اجرا CRTL+C رو بزنید. سپس باید تنظمات و کش پروژه رو باز نشانی کنیدبه شکل زیر

php artisan config:clear
php artisan cache:clear
php artisan config:cache

با این کار پکیج رو معتبر سازی کردید.

• استفاده:

1. استفاده خارج از فایل های blade : ابتدا پکیج رو به فایل و کلاستون وارد کنید و ازش استفاده کنید به شکل زیر

مثال ابتدایی:

use GrahamCampbell\Markdown\Facades\Markdown;

Markdown::convertToHtml('foo'); // <p>foo</p>

مثال کامل:

use Illuminate\Support\Facades\App;
use League\CommonMark\MarkdownConverterInterface;

class Foo
{
    protected $converter;

    public function __construct(MarkdownConverterInterface $converter)
    {
        $this->converter = $converter;
    }

    public function bar()
    {
        return $this->converter->convertToHtml('foo');
    }
}

App::make('Foo')->bar();

1. استفاده در فایل blade: استفاده به اشکال زیر هست:

@markdown('# Foo')

یا

@markdown
# Bar
@endmarkdown

• من خودم روش دوم رو پیشنهاد میکنم چون توی روش اول نمیشه enter زد و به سطر بعدی رفت(کار نمیکنه)
• توی روش دوم نباید پشت محتواتون فاصله باشه.

  @markdown
          # Bar   //کار نمیکنه
  @endmarkdown
  @markdown
  # Bar   //کار میکنه
  @endmarkdown

میتونید یک استایل از cdnjs.com دانلود کنید و به مارک دان استایل بدید یا میتونید خودتون اون جور که میخواید بنویسید.

دوستان آموزش به پایان رسید.لطفا کامنت بزارید و نظرتون رو بگید