Dry عبارة عن مجموعة شاملة من لغة القوالب السائلة، مع دعم من الدرجة الأولى لميزات الوراثة المتقدمة والمزيد.
يرجى مراعاة متابعة مؤلف هذا المشروع، جون شلينكرت، والتفكير في تمييز المشروع بنجمة لإظهار ❤️ ودعمك.
التثبيت باستخدام npm (يتطلب Node.js >=14):
$ npm install --save dry
إن أبسط طريقة للبدء هي استخدام طريقة render
، التي تأخذ سلسلة قالب وكائن بيانات ("السياق").
const { render } = require ( 'dry' ) ; // render is async
console . log ( await render ( 'Hello, {{ name }}!' , { name : 'Brian' } ) ) ; //=> Hello, Brian!
باستخدام الكود أعلاه، يمكنك فعل كل ما تحتاج إليه تقريبًا مع Dry.
العلامات والمرشحات والمتغيرات، وأكثر!
راجع المستندات الخاصة بـ Shopify's Liquid للتعرف على جميع الميزات الموجودة في لغة قوالب Liquid. إذا كنت تستطيع فعل ذلك باستخدام السائل، فيجب أن تكون قادرًا على القيام بذلك باستخدام الجاف. (وإذا لم تتمكن من القيام بذلك باستخدام Dry، فهذا خطأ، ونرجو منك إنشاء مشكلة، شكرًا!)
المستندات في الطريق. في هذه الأثناء، يمكنك استخدام مستندات Liquid هذه للتعرف على جميع ميزات اللغة، واستخدام مقتطف الكود أعلاه لعرض القوالب الخاصة بك!
؟ استغرق هذا الإصدار بعض الوقت. وهنا بعض النقاط البارزة!
أول الأشياء أولا
لقد عدت! أعلم أنني لم أتواجد كثيرًا مؤخرًا، لكن كل ذلك على وشك التغيير! شكرًا @doowb لجميع الرعاة والأصدقاء على GitHub الذين قدموا لي التشجيع والدعم الذي احتاجه لبدء هذه العودة.
من فضلك فكر في متابعتي وهذا المستودع لتلقي التحديثات، وفكر في المساهمة في Dry حتى نتمكن من جعل هذه أقوى مكتبة قوالب في Node.js!
لماذا جاف؟ أليست React وVue هي المستقبل؟
نعم، نعم هم كذلك. الجاف لا ينافسهم. نحن نستخدم Dry بنفس الطريقة التي يستخدم بها Shopify وJekyll Liquid، والعديد من المستخدمين النهائيين لا يعرفون كيفية كتابة JavaScript، ويفضل العديد من المطورين عدم كتابة JavaScript - أحب كتابة JavaScript، وأستمتع بـ Vue وReact، ولكن هناك شيء مُرضٍ بشأن نشر موقع في 5 دقائق باستخدام قوالب html للنص العادي. نستخدم أيضًا Dry لتصميم وعرض قوالب البريد الإلكتروني ورسائل النظام القائمة على التكوين وما إلى ذلك.
ما هو المختلف في الجفاف؟
Dry هي مجموعة شاملة من Shopify's Liquid مع دعم من الدرجة الأولى لوراثة القالب (مهم... لذلك لا يتعين عليك تكرار نفسك. لذا فهي "جافة". أعلم... هذا كل ما لدي في الوقت الحالي).
أبرز هذه العلاقات العامة
{% from 'fields' import input as input_field, textarea %}
الكثير أكثر!
تمت إضافة العلامات ذات البادئة +
إلى Dry:
(سنضيف المزيد من العلامات قريبًا! section
الإعجاب والعلامات الأخرى التي يستخدمها Shopify)
+ Apply
Assign
+ Block
Break
Capture
Case
Comment
+ Content
Continue
Cycle
Decrement
Echo
+ Embed
+ Extends
For
+ From
If
Ifchanged
+ Import
Include
Increment
+ Layout
Liquid
+ Macro
+ Paginate
Raw
Render
+ Set
+ Switch
TableRow
Unless
+ Verbatim
+ With
طلبات السحب والنجوم مرحب بها دائمًا. بالنسبة للأخطاء وطلبات الميزات، يرجى إنشاء مشكلة.
يرجى قراءة دليل المساهمة للحصول على المشورة بشأن المشكلات المفتوحة وطلبات السحب ومعايير الترميز.
يعد تشغيل اختبارات الوحدة ومراجعتها طريقة رائعة للتعرف على المكتبة وواجهة برمجة التطبيقات (API) الخاصة بها. يمكنك تثبيت التبعيات وإجراء الاختبارات باستخدام الأمر التالي:
$ npm install && npm test
(يتم إنشاء ملف readme.md الخاص بهذا المشروع عن طريق الفعل، يرجى عدم تحرير الملف التمهيدي مباشرةً. ويجب إجراء أي تغييرات على الملف التمهيدي في قالب الملف التمهيدي .verb.md.)
لإنشاء التمهيدي، قم بتشغيل الأمر التالي:
$ npm install -g verbose/verb#dev verb-generate-readme && verb
جون شلينكيرت
حقوق الطبع والنشر © 2021، جون شلينكرت. تم إصداره بموجب ترخيص MIT.
تم إنشاء هذا الملف بواسطة الملف التمهيدي لفعل الفعل، الإصدار 0.8.0، في 20 يوليو 2021.