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

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

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

{% apply html_to_markdown %}
    <html>
        <h1>Hello!</h1>
    </html>
{% endapply %}

من الممكن استخدام المرشح على كامل القالب الذي تدرجه باستخدام include:

{{ include('some_template.html.twig')|html_to_markdown }}

لاحظ أن المرشح html_to_markdown جزء من 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());
        }
    }
});

المرشح html_to_markdown مجرد واجهة أمامية للتحويل الحقيقي الذي يتم بإحدى المكتبات التالية:

تضاف بعض الخيارات وفقًا للمكتبة المستخدمة، وذلك بتمريرها كوسائط إلى المرشح. انظر المثال التالي لمكتبة league/html-to-markdown:

{% apply html_to_markdown({hard_break: false}) %}
    <html>
        <h1>Hello!</h1>
    </html>
{% endapply %}

انظر أيضًا

المصادر

صفحة توثيق المرشح html_to_markdown في توثيق Twig الرسمي.

@@ سطر 13: / سطر 13: @@
 لاحظ أن المرشح <code>html_to_markdown</code>  جزء من <code>MarkdownExtension</code> وهذا لا يكون مثبتًا افتراضيًا، لذا ثبته أولًا:<syntaxhighlight lang="twig">
 $ composer require twig/markdown-extra
-</syntaxhighlight>في حالة مشاريع Symfony، يمكن تفعيله تلقائيًا بتثبيت <code>twig/extra-bundle</code> :<syntaxhighlight lang="twig">
+</syntaxhighlight>في حالة مشاريع Symfony، يمكن تفعيله تلقائيًا بتثبيت <code>twig/extra-bundle</code>:<syntaxhighlight lang="twig">
 $ composer require twig/extra-bundle
 </syntaxhighlight>أو أضف التوسيع صراحة إلى بيئة Twig:<syntaxhighlight lang="twig">
@@ سطر 20: / سطر 20: @@
 $twig = new \Twig\Environment(...);
 $twig->addExtension(new MarkdownExtension());
-</syntaxhighlight>إذا لم تكن تستخدم Symfony فيجب أن تسجل وقت تشغيل التوسيع (extension runtime): <syntaxhighlight lang="twig">
+</syntaxhighlight>إذا لم تكن تستخدم Symfony فيجب أن تسجل وقت تشغيل التوسيع extension runtime: <syntaxhighlight lang="twig">
 use Twig\Extra\Markdown\DefaultMarkdown;
 use Twig\Extra\Markdown\MarkdownRuntime;