الفرق بين المراجعتين لصفحة: «Twig/html to markdown»
< Twig
أسامه-دمراني (نقاش | مساهمات) 1.0: إضافة عنوان الصفحة | 2.0 محتوى الصفحة |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (3 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 13: | سطر 13: | ||
لاحظ أن المرشح <code>html_to_markdown</code> جزء من <code>MarkdownExtension</code> وهذا لا يكون مثبتًا افتراضيًا، لذا ثبته أولًا:<syntaxhighlight lang="twig"> | لاحظ أن المرشح <code>html_to_markdown</code> جزء من <code>MarkdownExtension</code> وهذا لا يكون مثبتًا افتراضيًا، لذا ثبته أولًا:<syntaxhighlight lang="twig"> | ||
$ composer require twig/markdown-extra | $ 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 | $ composer require twig/extra-bundle | ||
</syntaxhighlight>أو أضف التوسيع صراحة إلى بيئة Twig:<syntaxhighlight lang="twig"> | </syntaxhighlight>أو أضف التوسيع صراحة إلى بيئة Twig:<syntaxhighlight lang="twig"> | ||
| سطر 20: | سطر 20: | ||
$twig = new \Twig\Environment(...); | $twig = new \Twig\Environment(...); | ||
$twig->addExtension(new MarkdownExtension()); | $twig->addExtension(new MarkdownExtension()); | ||
</syntaxhighlight>إذا لم تكن تستخدم Symfony فيجب أن تسجل وقت تشغيل التوسيع | </syntaxhighlight>إذا لم تكن تستخدم Symfony فيجب أن تسجل وقت تشغيل التوسيع extension runtime: <syntaxhighlight lang="twig"> | ||
use Twig\Extra\Markdown\DefaultMarkdown; | use Twig\Extra\Markdown\DefaultMarkdown; | ||
use Twig\Extra\Markdown\MarkdownRuntime; | use Twig\Extra\Markdown\MarkdownRuntime; | ||
| سطر 47: | سطر 47: | ||
{% endapply %} | {% endapply %} | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | |||
* [[Twig/intro|مقدمة عن محرك القوالب Twig]] | |||
* [[Twig/advanced|توسيع Twig]] | |||
* [[Twig/internals|المكونات الداخلية لـ Twig]] | |||
* [[Twig/tags|الوسوم في Twig]] | |||
* [[ Twig/filters|المرشحات في Twig]] | |||
== المصادر == | |||
* [https://twig.symfony.com/doc/3.x/filters/html_to_markdown.html صفحة توثيق المرشح html_to_markdown في توثيق Twig الرسمي]. | |||
[[تصنيف:Twig]] | |||
[[تصنيف:Twig Filters]] | |||
المراجعة الحالية بتاريخ 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 %}