الفرق بين المراجعتين لصفحة: «Twig/markdown to html»

من موسوعة حسوب
طلا ملخص تعديل
طلا ملخص تعديل
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: المرشح markdown_to_html في Twig}}</noinclude>
<noinclude>{{DISPLAYTITLE: المرشح markdown_to_html في Twig}}</noinclude>
يحول المرشح <code>markdown_to_html</code> كتلة مكتوبة بترميز مارك داون لتكون مكتوبة بلغة HTML:<syntaxhighlight lang="twig">
يحول المرشح <code>markdown_to_html</code> كتلة مكتوبة بترميز مارك داون لتكون مكتوبة بلغة [[HTML]]:<syntaxhighlight lang="twig">
{% apply markdown_to_html %}
{% apply markdown_to_html %}
Title
Title
سطر 31: سطر 31:
$twig->addExtension(new MarkdownExtension());
$twig->addExtension(new MarkdownExtension());
</syntaxhighlight>
</syntaxhighlight>
إذا لم تكن تستخدم Symfony فيجب أن تسجل وقت تشغيل التوسعة (extension runtime):  
إذا لم تكن تستخدم Symfony فيجب أن تسجل وقت تشغيل التوسعة extension runtime:  
<syntaxhighlight lang="php">
<syntaxhighlight lang="php">
use Twig\Extra\Markdown\DefaultMarkdown;
use Twig\Extra\Markdown\DefaultMarkdown;

المراجعة الحالية بتاريخ 06:25، 11 مايو 2021

يحول المرشح markdown_to_html كتلة مكتوبة بترميز مارك داون لتكون مكتوبة بلغة HTML:

{% apply markdown_to_html %}
Title
======

Hello!
{% endapply %}

لا بأس في وضع إزاحات لمحتوى مارك داون إذ أن المسافات البادئة ستُحذف تلقائيًا قبل التحويل:

{% apply markdown_to_html %}
    Title
    ======

    Hello!
{% endapply %}

كما يمكن استخدام المرشح على ملف مُدرَج أو متغير:

{{ include('some_template.markdown.twig')|markdown_to_html }}

{{ changelog|markdown_to_html }}

لاحظ أن المرشح markdown_to_html جزء من MarkdownExtension وهذا لا يكون مثبتًا افتراضيًا، لذا ثبته أولًا:

$ composer require twig/markdown-extra

في حالة مشاريع Symfony، يمكن تفعيله تلقائيًا بتثبيت twig/extra-bundle :

$ composer require twig/extra-bundle

أو أضف التوسعة صراحة إلى بيئة Twig:

use Twig\Extra\Markdown\MarkdownExtension;

$twig = new \Twig\Environment(...);
$twig->addExtension(new MarkdownExtension());

إذا لم تكن تستخدم Symfony فيجب أن تسجل وقت تشغيل التوسعة extension runtime:

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());
        }
    }
});

ثم يجب تثبيت مكتبة مارك داون من إحدى المكتبات المتوفرة، والتي يمكن النظر فيها في قسم require-dev من حزمة twig/markdown-extra-dev.

انظر أيضًا

المصادر