عرض مصدر Twig/markdown to html

<noinclude>{{DISPLAYTITLE: المرشح markdown_to_html في Twig}}</noinclude>
يحول المرشح <code>markdown_to_html</code> كتلة مكتوبة بترميز مارك داون لتكون مكتوبة بلغة [[HTML]]:<syntaxhighlight lang="twig">
{% apply markdown_to_html %}
Title
======

Hello!
{% endapply %}
</syntaxhighlight>لا بأس في وضع إزاحات لمحتوى مارك داون إذ أن المسافات البادئة ستُحذف تلقائيًا قبل التحويل:<syntaxhighlight lang="twig">
{% apply markdown_to_html %}
    Title
    ======

    Hello!
{% endapply %}
</syntaxhighlight>كما يمكن استخدام المرشح على ملف مُدرَج أو متغير:<syntaxhighlight lang="twig">
{{ include('some_template.markdown.twig')|markdown_to_html }}

{{ changelog|markdown_to_html }}
</syntaxhighlight>

لاحظ أن المرشح <code>markdown_to_html</code>  جزء من <code>MarkdownExtension</code> وهذا لا يكون مثبتًا افتراضيًا، لذا ثبته أولًا:<syntaxhighlight lang="twig">
$ composer require twig/markdown-extra
</syntaxhighlight>في حالة مشاريع Symfony، يمكن تفعيله تلقائيًا بتثبيت <code>twig/extra-bundle</code> :<syntaxhighlight lang="twig">
$ composer require twig/extra-bundle
</syntaxhighlight>أو أضف التوسعة صراحة إلى بيئة Twig:
<syntaxhighlight lang="php">
use Twig\Extra\Markdown\MarkdownExtension;

$twig = new \Twig\Environment(...);
$twig->addExtension(new MarkdownExtension());
</syntaxhighlight>
إذا لم تكن تستخدم Symfony فيجب أن تسجل وقت تشغيل التوسعة extension runtime: 
<syntaxhighlight lang="php">
use Twig\Extra\Markdown\DefaultMarkdown;
use Twig\Extra\Markdown\MarkdownRuntime;
use Twig\RuntimeLoader\RuntimeLoaderInterface;

$twig->addRuntimeLoader(new class implements RuntimeLoaderInterface {
    public function load($class) {
        if (MarkdownRuntime::class === $class) {
            return new MarkdownRuntime(new DefaultMarkdown());
        }
    }
});
</syntaxhighlight>
ثم يجب تثبيت مكتبة مارك داون من إحدى المكتبات المتوفرة، والتي يمكن النظر فيها في قسم <code>require-dev</code> من حزمة <code>twig/markdown-extra-dev</code>.

== انظر أيضًا ==
* [[Twig/intro|مقدمة عن محرك القوالب Twig]]
*[[Twig/advanced|توسيع Twig]]
*[[Twig/internals|المكونات الداخلية لـ Twig]]
*[[Twig/tags|الوسوم في Twig]]
*[[ Twig/filters|المرشحات في Twig]]
== المصادر ==
* [https://twig.symfony.com/doc/3.x/filters/markdown_to_html.html صفحة المرشح markdown_to_html في توثيق Twig الرسمي]

[[تصنيف:Twig]]
[[تصنيف:Twig Filters]]