Grav - टहनी फ़िल्टर और कार्य

इस अध्याय में, आइए अध्ययन करते हैं Twig Filters and Functions। फ़िल्टर्स का उपयोग डेटा को उस तरह से स्वरूपित करने के लिए किया जाता है जैसा आप आवश्यक आउटपुट के साथ चाहते हैं। सामग्री उत्पन्न करने के लिए फ़ंक्शंस का उपयोग किया जाता है।

Twig टेम्प्लेट पाठ फाइलें हैं जिनमें भाव और चर को मान द्वारा प्रतिस्थापित किया जाता है। टहनी तीन प्रकार के टैग का उपयोग करती है।

Output tags - मूल्यांकन किए गए भाव परिणाम को प्रदर्शित करने के लिए निम्न सिंटैक्स का उपयोग किया जाता है।

{{  Place Your Output Here  }}

Action Tags - निम्नलिखित कथनों का उपयोग यहाँ कथनों को निष्पादित करने के लिए किया जाता है।

{%  executable statements are placed here  %}

Comment tags - निम्न सिंटैक्स का उपयोग ट्विग टेंप्लेट फ़ाइल में टिप्पणी लिखने के लिए किया जाता है।

{#  write your comment here  #}

टहनी फ़िल्टर

टहनी फ़िल्टर का उपयोग करता है |फिल्टर नाम के बाद ट्विन चर के लिए फिल्टर लागू करने के लिए चरित्र। तर्क जुड़वा कार्यों की तरह ही कोष्ठक में पारित किया जा सकता है।

निम्न तालिका Grav में प्रयुक्त Twig फिल्टर दिखाती है -


'<img src="/some/path/img.jpg"/>' |absolute_url
'contact_us'| camelize
'This is some string' | contains('some')
set header_image_width = 
page.header.header_image_width|defined(900)
'this is an example for ends-with filter' | ends_with('filter')
'field.name'|fieldName
'some_text_to_read'|humanize
{% set ritems = {'orange':1, 'apple':2, 'peach':3}|ksort %}
{% for key, value in ritems %}{{ key }}:{{ value }}, {% endfor %}
'/strip/leading/slash/'|ltrim('/')
'## some text with markdown'|markdown
'something'|md5
'61'|monthize
page.date|nicetime(false)
'78'| ordinalize
'child'|pluralize
{% set ritems = ['one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'ten']|randomize(3) %}
{% for ritem in ritems %}{{ ritem }}, {% endfor %}
'/strip/leading/slash/'|rtrim('/')
'vehicles'|singularize
"[email protected]"|safe_email
{% set people = [{'email':'[email protected]', 'id':3}, {'email':'[email protected]', 'id':1}, {'email':'[email protected]', 'id':7}]|sort_by_key('id') %}
{% for person in people %}{{ person.email }}:{{ person.id }}, {% endfor %}
'this is an example for starts-with filter' |starts_with('this')
MY_LANGUAGE_KEY_STRING

'welcome page'|titleize
'ContactUs'|underscorize
'one sentence. two sentences'|truncate(5)

अनु क्रमांक।	फ़िल्टर और विवरण	उदाहरण
1	Absolute URL यह सापेक्ष पथ लेता है और इसे एक पूर्ण URL में परिवर्तित करता है।	`'<img src="/some/path/img.jpg"/>' \|absolute_url` में कनवर्ट करता है - `<img src="http://learn.getGrav.org/some/path/img.jpg" />`
2	Camelize यह एक स्ट्रिंग को CamelCase प्रारूप में परिवर्तित करता है।	`'contact_us'\| camelize` में कनवर्ट करता है - `ContactUs`
3	Contains अगर यह स्ट्रिंग पाता है।	`'This is some string' \| contains('some')` आउटपुट है - `1`
4	Defined आप जाँच सकते हैं कि कुछ चर परिभाषित किया गया है या नहीं। यदि चर परिभाषित नहीं है, तो आप एक डिफ़ॉल्ट मान प्रदान कर सकते हैं।	`set header_image_width = page.header.header_image_width\|defined(900)` यह सेट करता है header_image_width यदि यह परिभाषित नहीं है तो मान 900 के साथ।
5	Ends-With आप यह निर्धारित कर सकते हैं कि एंड्स-विथ फ़िल्टर का उपयोग करके किसी स्ट्रिंग को दिए गए स्ट्रिंग के साथ समाप्त होता है या नहीं।	`'this is an example for ends-with filter' \| ends_with('filter')` इसे इस प्रकार प्रदर्शित किया जाता है - `True`
6	FieldName यह फ़ील्ड नाम को सरणी संकेतन में डॉट बदलकर फ़िल्टर करता है।	`'field.name'\|fieldName` इसे इस प्रकार प्रदर्शित किया जाता है - `field[name]`
7	Humanize इसका उपयोग स्ट्रिंग को मानव पठनीय प्रारूप में बदलने के लिए किया जाता है।	`'some_text_to_read'\|humanize` इसे इस प्रकार प्रदर्शित किया जाता है - `Some text to read`
8	Ksort यह कुंजी का उपयोग करके एक सरणी मानचित्र को सॉर्ट करता है।	`{% set ritems = {'orange':1, 'apple':2, 'peach':3}\|ksort %} {% for key, value in ritems %}{{ key }}:{{ value }}, {% endfor %}` इसे इस प्रकार प्रदर्शित किया जाता है - `apple:2, orange:1, peach:3,`
9	Left Trim यह एक स्ट्रिंग की शुरुआत में सफेद रिक्त स्थान को निकालने के लिए उपयोग किया जाता है और स्ट्रिंग के बाईं ओर से दिए गए मिलान चरित्र को निकालता है।	`'/strip/leading/slash/'\|ltrim('/')` इसे इस प्रकार प्रदर्शित किया जाता है - `strip/leading/slash/`
10	Markdown इसका उपयोग Grav के मार्कडाउन पार्सर का उपयोग करके स्ट्रिंग युक्त मार्कडाउन को HTML में बदलने के लिए किया जाता है।	`'## some text with markdown'\|markdown` इसे इस प्रकार प्रदर्शित किया जाता है - `some text with markdown`
1 1	MD5 स्ट्रिंग के लिए md5 हैश इस फ़िल्टर का उपयोग करके बनाया जा सकता है।	`'something'\|md5` इसे इस प्रकार प्रदर्शित किया जाता है - `437b930db84b8079c2dd804a71936b5f`
12	Monthize Monthize फ़िल्टर का उपयोग करके, हम एक पूर्णांक संख्या को दिनों की संख्या में बदल सकते हैं।	`'61'\|monthize` इसे इस प्रकार प्रदर्शित किया जाता है - `2`
13	Nice Time नाइस टाइम फिल्टर का उपयोग करके, हम आउटपुट के रूप में अच्छे मानव पठनीय समय प्रारूप में तारीख प्राप्त कर सकते हैं।	`page.date\|nicetime(false)` इसे इस प्रकार प्रदर्शित किया जाता है - `3 hrs ago`
14	Ordinalize ऑर्डिनल (जैसे 1 ^सेंट , 2 ^{एन डी} , 3 ^आरडी ) को पूर्णांकों को ऑर्डिनलाइज फिल्टर का उपयोग करके दिया जा सकता है।	`'78'\| ordinalize` इसे इस प्रकार प्रदर्शित किया जाता है - `78th`
15	Pluralize एक स्ट्रिंग को बहुवचन फिल्टर का उपयोग करके अपने बहुवचन अंग्रेजी रूप में परिवर्तित किया जा सकता है।	`'child'\|pluralize` इसे इस प्रकार प्रदर्शित किया जाता है - `children`
16	Randomize यह फ़िल्टर प्रदान की गई सूची को यादृच्छिक बनाने में मदद करता है। यदि पैरामीटर में कोई मान हैं तो उन मानों को यादृच्छिक करने से छोड़ दिया जाता है।	`{% set ritems = ['one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'ten']\|randomize(3) %} {% for ritem in ritems %}{{ ritem }}, {% endfor %}` इसे इस प्रकार प्रदर्शित किया जाता है - `one, two, three, eight, six, five, nine, seven, ten, four,`
17	Right Trim यह बाएं ट्रिम के समान है सिवाय इसके कि यह व्हाट्सएप और मिलान वाले चरित्र को स्ट्रिंग के दाईं ओर से हटाता है।	`'/strip/leading/slash/'\|rtrim('/')` इसे इस प्रकार प्रदर्शित किया जाता है - `/strip/leading/slash`
18	Singularize एक स्ट्रिंग को एकवचन फिल्टर का उपयोग करके अंग्रेजी एकवचन संस्करण में परिवर्तित किया जा सकता है।	`'vehicles'\|singularize` इसे इस प्रकार प्रदर्शित किया जाता है - `vehicle`
19	Safe Email सुरक्षित ईमेल फ़िल्टर का उपयोग ईमेल पते को ASCII वर्णों में परिवर्तित करने के लिए किया जाता है ताकि यह ईमेल को स्पैम किए जाने के लिए कठिन बना दे।	`"[email protected]"\|safe_email` आउटपुट है - `[email protected]`
20	SortByKey यह कुंजियों का उपयोग करके सरणी मानचित्र को सॉर्ट करने के लिए उपयोग किया जाता है।	`{% set people = [{'email':'[email protected]', 'id':3}, {'email':'[email protected]', 'id':1}, {'email':'[email protected]', 'id':7}]\|sort_by_key('id') %} {% for person in people %}{{ person.email }}:{{ person.id }}, {% endfor %}` यह प्रदर्शित करता है - `[email protected]:1, [email protected]:3, [email protected]:7,`
21	Starts-With आप यह निर्धारित कर सकते हैं कि स्टार्ट-विथ फ़िल्टर का उपयोग करके किसी स्ट्रिंग को दिए गए स्ट्रिंग से शुरू होता है या नहीं।	`'this is an example for starts-with filter' \|starts_with('this')` आउटपुट है - `true`
22	Translate अधिक विस्तृत जानकारी के लिए।	`MY_LANGUAGE_KEY_STRING` यह प्रदर्शित करता है - `'Some text in English'`
23	Translate Admin यह वर्तमान भाषा में एक स्ट्रिंग का अनुवाद करता है जिसे इसमें सेट किया गया है user.yaml फ़ाइल।
24	Titleize शीर्षक का उपयोग करके एक स्ट्रिंग को शीर्षक केस प्रारूप में परिवर्तित किया जाता है।	`'welcome page'\|titleize` इसे इस प्रकार प्रदर्शित किया जाता है - `Welcome Page`
25	UnderScoreize अंडरस्कोराइज़ फिल्टर का उपयोग करके प्रारूप।	`'ContactUs'\|underscorize` यह करने के लिए परिवर्तित है - `contact_us`
26	Truncate a string आप किसी स्ट्रिंग को छोटा करने या स्ट्रिंग को छोटा करने के लिए Truncate का उपयोग कर सकते हैं, आपको वर्णों की संख्या निर्दिष्ट करनी होगी।	`'one sentence. two sentences'\|truncate(5)` यह करने के लिए छोटा है - `one s...` आप उपयोग कर सकते हैं true पैरामीटर के रूप में यदि आप वर्णों की दी गई संख्या के बाद स्ट्रिंग को निकटतम वाक्य-अंत तक छोटा नहीं करना चाहते हैं। `'one sentence. two sentences'\|truncate(5, true)` यह करने के लिए छोटा है - `one sentence` आप HTML पाठ को भी हटा सकते हैं, लेकिन आपको इसका उपयोग करना चाहिए striptags पहले छान लें truncate फिल्टर। `'<p>one <strong>sentence<strong>. two sentences</p>'\|striptags\|truncate(5)` इसे इस प्रकार प्रदर्शित किया जाता है - `one s`

टहनी के कार्य

पैरामीटर को पारित करके ट्विग फ़ंक्शंस को सीधे कहा जाता है। निम्नलिखित तालिका के कार्यों को सूचीबद्ध करता है -

अनु क्रमांक।	समारोह विवरण	उदाहरण
1	Array इस फ़ंक्शन ने सरणी के लिए एक मान डाला।	`array(value)`
2	Authorize यह फ़ंक्शन एक प्रमाणित उपयोगकर्ता बनाता है जो किसी संसाधन को देखने के लिए अधिकृत है और अनुमति स्ट्रिंग या अनुमति स्ट्रिंग की सरणी को स्वीकार करता है।	`authorize(['admin.statistics', 'admin.super'])`
3	Dump यह एक मान्य टहनी चर को स्वीकार करता है और इसे ग्रेव डिबगर पैनल में डाल देता है। हालाँकि, डिबगर को संदेश टैब मान देखने में सक्षम होना चाहिए।	`dump(page.header)`
4	Debug यह डंप () फ़ंक्शन के समान काम करता है।
5	Gist यह फ़ंक्शन Github Gist ID के आधार पर Gist एम्बेड कोड बनाता है।
6	Random String Generation यह फ़ंक्शन निर्दिष्ट वर्णों के साथ एक यादृच्छिक स्ट्रिंग बनाएगा। इन स्ट्रिंग्स को यूनिक आईडी या की के रूप में इस्तेमाल किया जा सकता है।	`generate_random_string(10)`
7	Repeat यह फ़ंक्शन दिए गए समय के लिए स्ट्रिंग को दोहराएगा।	`repeat('Grav ', 10) will repeat Grav 10 times.`
8	String निर्दिष्ट वर्ण लंबाई की एक यादृच्छिक स्ट्रिंग उत्पन्न करता है।	`ta (23)`
9	Translate Array यह एक फंक्शन है जिसके साथ जुड़ा हुआ है \|ta फिल्टर।
10	Url यह फ़िल्टर एक URL बनाएगा और यह PHP URL स्ट्रीम को मान्य HTML संसाधनों में भी परिवर्तित करेगा। यदि URL को हल नहीं किया जा सकता है तो एक डिफ़ॉल्ट मान पारित किया जा सकता है।	`url('theme://images/logo.png') \| default('http://www.placehold.it/150x100/f4f4f4')`
1 1	Translate अनुवाद फ़िल्टर का उपयोग करते हुए, एक स्ट्रिंग का अनुवाद किया जाता है \|t फिल्टर।	`t('SITE_NAME')` इसका अनुवाद है - `Site Name`