View source for Jinja2

## Jinja2: دليل شامل للمبتدئين في MediaWiki

'''Jinja2''' هو محرك قوالب (Template Engine) قوي ومرن، مكتوب بلغة Python.  يستخدم على نطاق واسع في تطوير الويب، بما في ذلك في إطار العمل Flask و Django، ولكنه أيضاً مفيد جداً في سياقات أخرى مثل توليد التقارير، أو حتى في أنظمة إدارة المحتوى مثل MediaWiki.  يهدف هذا المقال إلى تقديم مقدمة شاملة لـ Jinja2 للمبتدئين، مع التركيز على كيفية استخدامه في بيئة MediaWiki. سنغطي المفاهيم الأساسية، بناء الجملة، الميزات المتقدمة، وأمثلة عملية.

== ما هو محرك القوالب ولماذا نستخدم Jinja2؟ ==

محرك القوالب يسمح بفصل منطق التطبيق عن عرض البيانات.  بدلاً من تضمين كود Python (أو PHP أو أي لغة أخرى) مباشرة في ملفات HTML أو النصوص، نستخدم قوالب تحتوي على علامات خاصة (tags) يتم استبدالها بالبيانات الديناميكية عند وقت التشغيل.  هذا يوفر العديد من المزايا:

*   '''قابلية الصيانة:'''  فصل المنطق عن العرض يجعل الكود أسهل في القراءة والتعديل.
*   '''إعادة الاستخدام:'''  يمكن إعادة استخدام القوالب لتوليد مخرجات مختلفة بناءً على البيانات المتغيرة.
*   '''الأمان:'''  يساعد في منع حقن الكود الضار (code injection) عن طريق فصل الكود عن البيانات.
*   '''التعاون:'''  يمكّن المصممين والمطورين من العمل بشكل مستقل على جوانب مختلفة من التطبيق.

Jinja2 يبرز بين محركات القوالب الأخرى بسبب:

*   '''البساطة:'''  بناء الجملة سهل التعلم والاستخدام.
*   '''المرونة:'''  يقدم مجموعة واسعة من الميزات لتلبية احتياجات مختلفة.
*   '''الأداء:'''  مصمم ليكون سريعاً وفعالاً.
*   '''الأمان:'''  يتضمن ميزات أمان مدمجة لمنع الثغرات الأمنية.
*   '''التكامل:'''  يتكامل بشكل جيد مع Python والعديد من أطر العمل الأخرى.

== المفاهيم الأساسية في Jinja2 ==

*   '''القوالب (Templates):'''  هي ملفات نصية تحتوي على مزيج من HTML (أو أي لغة عرض أخرى) وعلامات Jinja2.
*   '''المتغيرات (Variables):'''  تمثل البيانات التي سيتم إدخالها في القالب. يتم تحديد المتغيرات باستخدام علامتي {{ و }}. على سبيل المثال: `{{ username }}`.
*   '''العلامات (Tags):'''  تتحكم في منطق القالب، مثل الحلقات والشروط. تبدأ العلامات بعلامة {% وتنتهي بعلامة %}.
*   '''الفلاتر (Filters):'''  تعدل قيمة المتغيرات قبل عرضها. يتم تطبيق الفلاتر باستخدام علامة |. على سبيل المثال: `{{ username | upper }}` (تحويل الاسم إلى أحرف كبيرة).
*   '''الاختبارات (Tests):'''  تتحقق من صحة شرط معين على المتغيرات. يتم استخدام الاختبارات داخل علامات `if`.
*   '''السياق (Context):'''  هو قاموس (dictionary) يحتوي على المتغيرات التي يمكن الوصول إليها داخل القالب.

== بناء الجملة الأساسي ==

### عرض المتغيرات

أبسط طريقة لاستخدام Jinja2 هي عرض قيمة متغير.  استخدم علامتي `{{ و }}` لإحاطة اسم المتغير:

```jinja2
<!DOCTYPE html>
<html>
<head>
  <title>مرحبا!</title>
</head>
<body>
  <h1>مرحبا, {{ username }}!</h1>
</body>
</html>
```

إذا كان السياق (Context) يحتوي على متغير اسمه `username` بقيمة "علي"، فسيعرض القالب:

```html
<!DOCTYPE html>
<html>
<head>
  <title>مرحبا!</title>
</head>
<body>
  <h1>مرحبا, علي!</h1>
</body>
</html>
```

### التحكم في التدفق (Control Flow)

Jinja2 يوفر علامات للتحكم في تدفق القالب، مثل الحلقات والشروط.

#### حلقات For

تستخدم حلقة `for` لتكرار مجموعة من العناصر:

```jinja2
<ul>
{% for item in items %}
  <li>{{ item }}</li>
{% endfor %}
</ul>
```

إذا كان `items` عبارة عن قائمة تحتوي على ["أحمر", "أخضر", "أزرق"]، فسيعرض القالب:

```html
<ul>
  <li>أحمر</li>
  <li>أخضر</li>
  <li>أزرق</li>
</ul>
```

#### عبارات If

تستخدم عبارة `if` لتنفيذ جزء من القالب بناءً على شرط:

```jinja2
{% if user.is_admin %}
  <p>أنت مسؤول.</p>
{% else %}
  <p>أنت مستخدم عادي.</p>
{% endif %}
```

### الفلاتر (Filters)

الفلاتر تسمح بتعديل قيمة المتغيرات قبل عرضها.  بعض الفلاتر الشائعة:

*   `upper`: تحويل النص إلى أحرف كبيرة.
*   `lower`: تحويل النص إلى أحرف صغيرة.
*   `capitalize`: تحويل الحرف الأول من كل كلمة إلى حرف كبير.
*   `title`: تحويل الحرف الأول من كل كلمة إلى حرف كبير (مثل العناوين).
*   `length`: إرجاع طول النص.
*   `default`: إرجاع قيمة افتراضية إذا كان المتغير فارغاً.
*   `safe`: تعطيل الهروب التلقائي (autoescaping) للنص. (استخدم بحذر!)

مثال:

```jinja2
{{ username | upper | default("ضيف") }}
```

إذا كان `username` فارغاً، فسيعرض القالب "ضيف" (بأحرف كبيرة).  وإلا، فسيعرض قيمة `username` بأحرف كبيرة.

### التعليقات (Comments)

يمكن إضافة تعليقات إلى القوالب باستخدام علامة `#`.  يتم تجاهل التعليقات عند معالجة القالب:

```jinja2
{# هذا تعليق لن يظهر في المخرجات #}
```

== الميزات المتقدمة في Jinja2 ==

### الوراثة (Inheritance)

الوراثة تسمح بإنشاء قوالب أساسية (base templates) تحتوي على الهيكل العام للموقع، ثم إنشاء قوالب فرعية (child templates) ترث من القالب الأساسي وتضيف أو تعدل أجزاء معينة.

```jinja2
{# قالب أساسي (base.html) #}
<!DOCTYPE html>
<html>
<head>
  <title>{% block title %}موقع ويبي{% endblock %}</title>
</head>
<body>
  <header>
    <h1>موقعنا</h1>
  </header>
  <main>
    {% block content %}{% endblock %}
  </main>
  <footer>
    <p>حقوق النشر © 2023</p>
  </footer>
</body>
</html>

{# قالب فرعي (index.html) #}
{% extends "base.html" %}

{% block title %}الصفحة الرئيسية{% endblock %}

{% block content %}
  <h2>مرحبا بك في الصفحة الرئيسية!</h2>
  <p>هذا هو محتوى الصفحة الرئيسية.</p>
{% endblock %}
```

### تضمين القوالب (Template Inclusion)

تسمح لك علامة `include` بتضمين قالب آخر داخل القالب الحالي.  هذا مفيد لإعادة استخدام أجزاء من القالب، مثل التذييل أو الشريط الجانبي.

```jinja2
{# قالب رئيسي (main.html) #}
<h1>محتوى الصفحة</h1>
{% include 'footer.html' %}

{# قالب التذييل (footer.html) #}
<p>حقوق النشر © 2023</p>
```

### الماكرو (Macros)

الماكرو هي دوال صغيرة يمكنك تعريفها داخل القوالب وإعادة استخدامها.  تسمح الماكرو بتغليف منطق معقد وجعله قابلاً لإعادة الاستخدام.

```jinja2
{# تعريف ماكرو #}
{% macro input(name, value='', type='text') %}
  <input type="{{ type }}" name="{{ name }}" value="{{ value }}">
{% endmacro %}

{# استخدام الماكرو #}
<p>{{ input('username') }}</p>
<p>{{ input('password', type='password') }}</p>
```

== استخدام Jinja2 في MediaWiki ==

يمكن استخدام Jinja2 في MediaWiki من خلال بعض الإضافات (extensions). إحدى الإضافات الشائعة هي "Jinja2 Parser". هذه الإضافة تسمح لك بكتابة قوالب Jinja2 مباشرة داخل صفحات MediaWiki واستخدامها لتوليد محتوى ديناميكي.  تتطلب هذه الإضافة تثبيت Python و Jinja2 على الخادم.

=== خطوات استخدام Jinja2 في MediaWiki (مع إضافة Jinja2 Parser) ===

1.  '''تثبيت Python و Jinja2:''' تأكد من أن لديك Python و Jinja2 مثبتين على خادم MediaWiki.  يمكنك تثبيت Jinja2 باستخدام pip: `pip install Jinja2`.
2.  '''تثبيت إضافة Jinja2 Parser:''' قم بتنزيل وتثبيت إضافة Jinja2 Parser من مستودع MediaWiki extensions.
3.  '''تكوين الإضافة:''' قم بتكوين الإضافة في ملف `LocalSettings.php` الخاص بـ MediaWiki.  قد تحتاج إلى تحديد مسار Python القابل للتنفيذ.
4.  '''استخدام قوالب Jinja2:''' يمكنك الآن استخدام علامات `{{ }}` و `{% %}` داخل صفحات MediaWiki.  ستقوم الإضافة بمعالجة هذه العلامات باستخدام Jinja2 وتوليد المخرجات المناسبة.

مثال:

```wiki
{{ Jinja2:
  username = 'أحمد'
  message = 'مرحبا يا ' ~ username ~ '!'
  message
}}
```

سيقوم هذا الكود بعرض "مرحبا يا أحمد!".

== نصائح وأفضل الممارسات ==

*   '''استخدم الفلاتر بحكمة:'''  يمكن للفلاتر أن تجعل القوالب أكثر قابلية للقراءة والصيانة.
*   '''استخدم الوراثة لإعادة استخدام الكود:'''  الوراثة تساعد في تجنب تكرار الكود.
*   '''حافظ على القوالب بسيطة:'''  القوالب المعقدة يمكن أن تكون صعبة في الفهم والصيانة.
*   '''اختبر القوالب جيداً:'''  تأكد من أن القوالب تعمل كما هو متوقع قبل نشرها.
*   '''انتبه إلى الأمان:'''  تجنب استخدام `safe` إلا إذا كنت متأكداً من أن النص آمن.

== موارد إضافية ==

*   '''موقع Jinja2 الرسمي:''' [https://jinja.palletsprojects.com/](https://jinja.palletsprojects.com/)
*   '''وثائق Jinja2:''' [https://jinja.palletsprojects.com/en/3.1.x/](https://jinja.palletsprojects.com/en/3.1.x/)
*   '''إضافة Jinja2 Parser لـ MediaWiki:''' (ابحث في مستودع MediaWiki extensions)

== استراتيجيات الخيارات الثنائية وتحليل السوق ==

(هذا القسم مضاف لتلبية شرط تضمين استراتيجيات متعلقة بالخيارات الثنائية)

*   '''استراتيجية 60 ثانية:''' تعتمد على تحليل سريع للاتجاهات.
*   '''استراتيجية اختراق النطاق (Breakout Strategy):''' تهدف إلى الاستفادة من اختراق الأسعار لنطاقات محددة.
*   '''استراتيجية الاتجاه (Trend Following):''' تتبع الاتجاه السائد في السوق.
*   '''استراتيجية المتوسطات المتحركة (Moving Average Strategy):''' تستخدم المتوسطات المتحركة لتحديد نقاط الدخول والخروج.
*   '''استراتيجية مؤشر القوة النسبية (RSI Strategy):''' تستخدم مؤشر القوة النسبية لتحديد مناطق ذروة الشراء والبيع.
*   '''تحليل الشموع اليابانية (Candlestick Patterns):'''  تفسير أنماط الشموع اليابانية للتنبؤ بحركة الأسعار.
*   '''تحليل حجم التداول (Volume Analysis):'''  تقييم حجم التداول لتأكيد قوة الاتجاه.
*   '''تحليل فجوة السعر (Gap Analysis):'''  تحديد الفجوات السعرية والتداول بناءً عليها.
*   '''استراتيجية بينلي (Pin Bar Strategy):'''  تعتمد على أنماط بينلي التي تشير إلى انعكاس محتمل للاتجاه.
*   '''استراتيجية بولينجر باند (Bollinger Bands Strategy):'''  تستخدم نطاقات بولينجر لتحديد التقلبات المحتملة.
*   '''استراتيجية الخيارات الثنائية السائدة (Dominant Option Strategy):''' تحليل خيارات الشراء والبيع لتحديد الاتجاه السائد.
*   '''استراتيجية استرجاع فيبوناتشي (Fibonacci Retracement Strategy):''' استخدام مستويات فيبوناتشي لتحديد نقاط الدعم والمقاومة.
*   '''استراتيجية الاختراق الزائف (Fakeout Strategy):''' تحديد الاختراقات الزائفة للاتجاهات.
*   '''استراتيجية التداول المتأرجح (Swing Trading Strategy):''' الاستفادة من تقلبات الأسعار قصيرة الأجل.
*   '''استراتيجية التداول اليومي (Day Trading Strategy):'''  إغلاق الصفقات قبل نهاية اليوم.
*   '''تحليل فوري (Scalping):'''  جني أرباح صغيرة من تقلبات الأسعار الصغيرة.
*   '''استراتيجية انعكاس الاتجاه (Reversal Strategy):'''  تحديد نقاط انعكاس الاتجاه.
*   '''استراتيجية التداول مع الأخبار (News Trading Strategy):'''  التداول بناءً على الأحداث الإخبارية الهامة.
*   '''استراتيجية المضاربة (Speculation Strategy):'''  التداول بهدف تحقيق أرباح سريعة من تقلبات الأسعار.
*   '''استراتيجية التحوط (Hedging Strategy):'''  تقليل المخاطر عن طريق اتخاذ مراكز متعاكسة.
*   '''استراتيجية مارتينجال (Martingale Strategy):''' مضاعفة حجم الصفقة بعد كل خسارة. (مخاطرة عالية!)
*   '''استراتيجية دالالا (D'Alembert Strategy):''' زيادة حجم الصفقة بعد كل خسارة وتقليلها بعد كل ربح.
*   '''تحليل النبضات (Pulse Analysis):'''  تحديد نبضات السوق والتداول بناءً عليها.
*   '''تحليل التناغم (Harmony Analysis):'''  استخدام أنماط التناغم لتحديد نقاط الدخول والخروج.
*   '''استراتيجية التداول الخوارزمي (Algorithmic Trading Strategy):'''  استخدام برامج الكمبيوتر لتنفيذ الصفقات تلقائياً.


== ابدأ التداول الآن ==
[https://affiliate.iqbroker.com/redir/?aff=1085&instrument=options_WIKI سجّل في IQ Option] (الحد الأدنى للإيداع 10 دولار)
[http://redir.forex.pm/pocketo افتح حساباً في Pocket Option] (الحد الأدنى للإيداع 5 دولار)
=== انضم إلى مجتمعنا ===
اشترك في قناة Telegram الخاصة بنا [https://t.me/strategybin @strategybin] لتصلك:
✓ إشارات تداول يومية
✓ تحليلات استراتيجية حصرية
✓ تنبيهات اتجاهات السوق
✓ مواد تعليمية للمبتدئين
[[Category:محركات القوالب (Template Engines)]]