الفرق بين المراجعتين ل"Twig/markdown to html"
< Twig
اذهب إلى التنقل
اذهب إلى البحث
أسامه-دمراني (نقاش | مساهمات) (1.0: إضافة عنوان الصفحة | 2.0 محتوى الصفحة) |
جميل-بيلوني (نقاش | مساهمات) ط |
||
سطر 24: | سطر 24: | ||
</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>أو أضف | + | </syntaxhighlight>أو أضف التوسعة صراحة إلى بيئة Twig: |
− | <syntaxhighlight lang=" | + | <syntaxhighlight lang="php"> |
use Twig\Extra\Markdown\MarkdownExtension; | use Twig\Extra\Markdown\MarkdownExtension; | ||
سطر 31: | سطر 31: | ||
$twig->addExtension(new MarkdownExtension()); | $twig->addExtension(new MarkdownExtension()); | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | إذا لم تكن تستخدم Symfony فيجب أن تسجل وقت تشغيل | + | إذا لم تكن تستخدم Symfony فيجب أن تسجل وقت تشغيل التوسعة (extension runtime): |
− | <syntaxhighlight lang=" | + | <syntaxhighlight lang="php"> |
use Twig\Extra\Markdown\DefaultMarkdown; | use Twig\Extra\Markdown\DefaultMarkdown; | ||
use Twig\Extra\Markdown\MarkdownRuntime; | use Twig\Extra\Markdown\MarkdownRuntime; | ||
سطر 45: | سطر 45: | ||
}); | }); | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | ثم يجب تثبيت مكتبة مارك داون من إحدى المكتبات المتوفرة، والتي يمكن النظر فيها في قسم <code>require-dev</code> من حزمة <code>twig/markdown-extra-dev</code> | + | ثم يجب تثبيت مكتبة مارك داون من إحدى المكتبات المتوفرة، والتي يمكن النظر فيها في قسم <code>require-dev</code> من حزمة <code>twig/markdown-extra-dev</code>. |
== انظر أيضًا == | == انظر أيضًا == | ||
− | * [[Twig/intro|مقدمة عن محرك القوالب Twig | + | * [[Twig/intro|مقدمة عن محرك القوالب Twig]] |
− | * [[Twig/advanced|توسيع Twig | + | *[[Twig/advanced|توسيع Twig]] |
− | * [[Twig/internals|المكونات الداخلية لـ Twig | + | *[[Twig/internals|المكونات الداخلية لـ Twig]] |
− | * [[Twig/tags|الوسوم في Twig]] | + | *[[Twig/tags|الوسوم في Twig]] |
− | * [[ Twig/filters|المرشحات في Twig]] | + | *[[ Twig/filters|المرشحات في Twig]] |
== المصادر == | == المصادر == | ||
− | * [https://twig.symfony.com/doc/3.x/filters/markdown_to_html.html صفحة | + | * [https://twig.symfony.com/doc/3.x/filters/markdown_to_html.html صفحة المرشح markdown_to_html في توثيق Twig الرسمي] |
[[تصنيف:Twig]] | [[تصنيف:Twig]] | ||
[[تصنيف:Twig Filters]] | [[تصنيف:Twig Filters]] | ||
− |
مراجعة 07:45، 6 مايو 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
.