sempare delphi template engine
v1.8.0
محرك قالب SEMPAREحقوق الطبع والنشر (C) 2019-2024 Sempare Limited
الاتصال: [email protected]
الترخيص: Apache v2.0 أو Sempare Limited Ricense
مفتوح المصدر: https://github.com/sempare/sempare-delphi-template-engine
Questionaire : https://docs.google.com/forms/d/e/1faipqlscioiidxvswk01fmfqyr9aj6kggeiw4uau_esguztee7vywa/viewform
يتم استخدام محركات القالب في كثير من الأحيان في التكنولوجيا حيث يجب تخصيص النص عن طريق استبدال المتغيرات مع القيم من مصدر البيانات. أمثلة حيث قد يحدث هذا:
محرك قالب SEMPare هو محرك (برمجة) صغيرة (البرمجة النصية) لـ Delphi (كائن Pascal) يسمح بإنشاء قوالب بسهولة وكفاءة من خلال توفير واجهة برمجة التطبيقات البسيطة والسهلة الاستخدام.
مثال الاستخدام:
program Example;
uses
Sempare.Template;
type
TInformation = record
name: string;
favourite_sport : string;
count : integer;
end;
begin
var tpl := Template.Parse(
'My name is <% name %>.'#13#10 +
'My favourite sport is <% favourite_sport %>.'#13#10 +
'Counting... <% for i := 1 to count %><% i %><% betweenitems %>, <% end %>' +
'Counting... <% for i := 1 to count ; print(i) ; betweenitems ; print(', '); onbegin; print('[ '); onend; print('] '); end %>'
);
var info : TInformation;
info.name := 'conrad';
info.favourite_sport := 'ultimate';
info.count := 3;
writeln(Template.Eval(tpl, info));
end.
يسمح المشروع بإلغاء تحديد أي نوع تقريبًا في البرنامج النصي.
في المثال أعلاه ، يمكنك أن ترى أن "<٪" البدء و "٪>" تنهي عبارة البرمجة النصية على التوالي. ضمن عبارة البرمجة النصية ، يمكنك الرجوع إلى المتغيرات ، وتعيين المتغيرات ، واستخدام الشروط ، للحلقات ، وتضمين قوالب أخرى.
ملاحظة في أمثلة في هذا الوثائق ، قد أستخدم أحدث بناء جملة Delphi ، مثل الإعلانات المتغيرة المضمّنة. هذا غير متوافق مع الخلف حيث تم تقديمه في Delphi 10.2 ويتم استخدامه لتقصير الكود/الأمثلة التي يتم توضيحها في الوثائق. ستحاول قاعدة الشفرة أن تكون متوافقة مع الخلف قدر الإمكان.
يرجى "نجمة" المشروع على جيثب.
هناك بعض الطرق للبدء بسرعة.
جرب العرض التوضيحي إذا كنت ترغب في الغوص في سريع واللعب مع محرك القالب.
لا يُقصد بمحرك قالب SEMPare أن يكون لغة برمجة عامة مميزة بالكامل مثل PHP حيث يمكن أن يكون البرنامج النصي نفسه لغة برمجة تحتوي على ذاتي (ولكن لديها معظم الميزات).
يهدف محرك قالب Sempare إلى توفير وظائف كافية فقط للسماح لك بالعمل بسهولة مع جوانب "عرض" القالب. يجب توفير أي وظيفة معززة مطلوبة من بيئة البرمجة النصية بواسطة الوظائف المخصصة المكتوبة في كائن Pascal.
يعمل محرك القالب مع الإصدارات الحديثة من دلفي.
يتم تشغيل الاختبارات حاليًا باستخدام Dunitx TestFramework.
تم إجراء محاولة لعدم استخدام أحدث الميزات لتخفيف التوافق للخلف. تم اختبار الإصدارات التالية:
لا ينبغي أن يكون هناك قيود محددة منصة.
إلقاء نظرة على sempare.template.compiler.inc. يمكن تعريف ما يلي تحديدًا إذا كان ذلك مناسبًا:
يمكن تثبيت محرك قالب Sempare لـ Delphi عبر مدير Embarcadero Getit
سيؤدي ذلك إلى إضافة مجلد SRC إلى مسار البحث حتى تتمكن من البدء في العمل على الفور.
يمكن تثبيت محرك قالب Sempare لـ Delphi عبر مدير حزمة Boss.
ببساطة الجري:
boss install sempare/sempare-delphi-template-engine
يمكن تثبيت محرك قالب Sempare لـ Delphi عبر مدير حزمة Delphinus.
سيؤدي ذلك إلى إضافة مجلد SRC إلى مسار البحث حتى تتمكن من البدء في العمل على الفور.
ابدأ بإضافة مجلد SRC إلى مسار البحث Delphi. خلاف ذلك ، هناك بعض المشاريع التي يمكنك استخدامها:
افتح sempare.template.engine.group.groupproj الذي سيشمل:
sempare.template.pkg.dproj
مشروع القالب الأساسي. (وقت التشغيل)
sempare.template.tester.dproj
180+ اختبارات الوحدة
DEMO SEMPARETEMPLATEPLAYGROUNG SEMPARE.Templateengine.playground.dproj
العرض التوضيحي لملعب Sempare Template الذي يوفر تجربة غنية لاختبار ميزات لغة القالب المختلفة.
يمكنك إثارة المشكلات على Github وسيتم معالجتها على أساس الأولوية.
معظم الميزات لديها بعض الاختبارات الأساسية في مكانها. إذا تم اكتشاف خطأ ، فيرجى تضمين اختبار/سيناريو أساسي يكرر المشكلة إن أمكن لأن هذا سيخفف من عملية التحقيق.
مراجعة شروط وأحكام Cattight للمساهمة في المشروع.
يرجى متابعة الخطوات التالية عند إضافة ميزة أو إجراء تحديث:
تعتمد عملية النشر على فرع DEV. بمجرد أن نقرر الضغط على إصدار جديد ، سنقوم بدمج "Dev" في "Main".
محرك قالب SEMPARE مرخص له. يمكنك اختيار استخدامه تحت قيود Apache V2.0 دون أي تكلفة لك ، أو يمكنك ترخيصه للاستخدام بموجب ترخيص Sempare Limited التجاري
يتيح لك نظام الترخيص المزدوج استخدام المكتبة واختبارها بموجب الترخيص المناسب.
يمنحك الترخيص التجاري الحق في استخدام محرك قالب SEMPare في تطبيقاتك الخاصة ، خالية من الملوك ، وبدون أي شرط للكشف عن رمز المصدر الخاص بك أو أي تعديلات على محرك قالب SEMPARE أو إلى أي طرف آخر. يساعد الترخيص التجاري على ضمان الحفاظ على المشروع مع التكامل المستمر ، والبقع ، وما إلى ذلك.
يتم تقدير رسوم الدعم البالغة 70 دولارًا لكل مطور.
تتيح لك روابط الدفع التالية الاشتراك بسرعة. يرجى ملاحظة أن روابط الترخيص والدعم الأولي منفصلة.
تتوفر روابط الدفع التالية لتراخيص الموقع. يرجى ملاحظة أن روابط الترخيص والدعم الأولي منفصلة.
يرجى إرسال بريد إلكتروني إلى [email protected] لطلب فاتورة تحتوي على تفاصيل الدفع البديلة.
سيتم إعطاء الأولوية لطلبات الدعم والتحسين المقدمة من المستخدمين الذين يدفعون مقابل الدعم. قد تتحمل التطورات الجديدة تكاليف إضافية حسب الوقت المطلوب للتنفيذ.
