المرشح html_to_markdown في Twig
< Twig
اذهب إلى التنقل
اذهب إلى البحث
مراجعة 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 %}