Articles
Թեման ֆայլերի հավաքածու է, որոնք որոշում են ներկայացման մակարդակը։ Դուք նաև կարող եք ստեղծել մեկ կամ մի քանի «միջթեմաներ» կամ թեմայի տարբերակներ։ Պահանջվում է միայն .info.yml ֆայլը, սակայն մեծամասնությունը թեմաների և միջթեմաների կօգտագործեն նաև այլ ֆայլեր։ Այս էջում թվարկված են ֆայլերն ու թղթապանակները, որոնք գտնվում են սովորական թեմայում կամ միջթեմայում։
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.
Տեմայում շրջաններ ավելացնելու համար անհրաժեշտ է.
- Շրջանների մետատվյալներ ավելացնել THEMENAME.info.yml ֆայլում։
- Խմբագրել page.html.twig ֆայլը և տպել նոր շրջանները։
Նշում. Եթե ձեր թեմայում հայտարարեք որևէ շրջան, նույնիսկ միայն մեկ, բոլոր նախնական շրջանները այլևս կիրառելի չեն, և դուք պետք է պատասխանատվություն ստանձնեք այն բոլոր շրջանների հայտարարության համար, որոնք ցանկանում եք օգտագործել։
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.
Այս փաստաթուղթը նախատեսված է թեմաների համար։ Մոդուլների մասին տեղեկությունները կարող եք գտնել «Drupal 8-ում CSS և JavaScript-ի ավելացում մոդուլում» բաժնում։
Drupal 8-ում CSS և JavaScript ֆայլերը բեռնվում են նույն համակարգով՝ մոդուլների (կոդի) և թեմաների համար՝ օգտագործելով ռեսուրսների գրադարաններ։
Հստակեցման համար՝ այս հրահանգները նախատեսված են ԱՊԱՀԱՏԵԼԻ միայն թեմաների համար և չեն կիրառվում մոդուլներում։
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.
Twig-ը PHP-ի համար կաղապարների շարժիչ է, որը պատկանում է Symfony2 շրջանակին։
Drupal 8-ում Twig-ը փոխարինում է PHPTemplate-ին որպես նախնական կաղապարային համակարգ։ Այս փոփոխության արդյունքներից է, որ բոլոր theme_* ֆունկցիաները և *.tpl.php ֆայլերը, որոնք հիմնված էին PHPTemplate-ի վրա, փոխարինվել են *.html.twig կաղապարային ֆայլերով։
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.
Drupal-ը թույլ է տալիս վերակազմակերպել բոլոր կաղապարները, որոնք օգտագործվում են HTML-ի շերտավորման համար, որպեսզի դուք ամբողջովին վերահսկեք այն շերտավորումը, որը ցուցադրվում է ձեր օգտատերերի թեմայում։ Կաղապարներ կան էջի յուրաքանչյուր տարրի համար՝ սկսած բարձր մակարդակի HTML-ից մինչև փոքր դաշտեր։
Կաղապարների վերակազմակերպում
Դուք կարող եք վերակազմակերպել Drupal-ի հիմնական կաղապարները՝ ավելացնելով ձեր թեմայի թղթապանակում կաղապարներ, որոնք համապատասխանում են որոշակի անվանման կոնվենցիային։
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.
Drupal-ը բեռնաթափում է կաղապարները՝ հիմնվելով որոշակի անվանման կոնվենցիաների վրա։ Սա թույլ է տալիս ձեզ կարգավորել կաղապարները՝ դրանք ձեր թեմայի մեջ ավելացնելով և տալով կոնկրետ անուններ։
Կաղապարը ավելացնելուց հետո պետք է մաքրել քեշը, որպեսզի Drupal-ը հայտնաբերի նոր կաղապարը։
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.
Twig-ի մասին
Twig-ը կոմպիլացված կաղապարային լեզու է՝ հիմնված PHP-ի վրա։ Երբ ձեր վեբէջը ցուցադրվում է, Twig շարժիչը վերցնում է կաղապարը և փոխակերպում այն կոմպիլացված PHP կաղապարի, որը պահվում է sites/default/files/php/twig թղթապանակում։ Կոմպիլյացիան կատարվում է մեկ անգամ, կաղապարային ֆայլերը պահվում են քեշում՝ կրկնակի օգտագործման համար և նորից կոմպիլացվում են Twig քեշը մաքրելիս։
Drupal Twig նախաձեռնությունը ունի նույն մոտիվացիան, ինչ Symfony-ն՝ ներդնել արդի, հզոր, OOP-բազայով շարժիչ, որը թույլ կտա ծրագրավորողներին ճիշտ կենտրոնանալ Drupal-ի վրա։
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.
Երբ աշխատում եք Twig կաղապարի ֆայլի հետ, մեծ մասը փոփոխականներից նշված է կաղապարի ֆայլի մեկնաբանություններում։ Սակայն երբ դա այդպես չէ կամ երբ թեմաները կամ մոդուլները ներառում են նոր փոփոխականներ, անհրաժեշտ է գտնել բոլոր փոփոխականները, որոնք հասանելի են կաղապարում։ Twig-ը տրամադրում է dump() ֆունկցիա փոփոխականների հայտնաբերման և ստուգման համար կաղապարների ֆայլերում։
dump() ֆունկցիան չի արտածվի, եթե դեբագավորումը միացված չէ։ Իմանալ, թե ինչպես միացնել Twig-ի դեբագավորումը։
Twig կաղապարների շարժիչը առաջարկում է դեբագավորման գործիք։
Drupal 8-ի իրականացումը նաև ավելացնում է լրացուցիչ գործիք, որը թույլ է տալիս գտնել կաղապարը, որը ցուցադրում է նշված HTML-ը։
Զգուշացում․ Twig դեբագի միացումը կարող է փչացնել կայքի որոշ հատվածներ, հատկապես Views։ Տեսեք այս խնդիրը։
Դեբագի միացում
Դուք միացնում եք Twig դեբագը sites/default/services.yml ֆայլում։
debug փոփոխականին նշանակեք true և մաքրեք քեշը։
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.
Ինչպես սովորաբար աշխատում է Twig-ը
Նախադրյալով Twig թեմաների շարժիչը կոմպիլացնում է կաղապարները PHP կոդի և պահում է կոմպիլացված կոդը հիշողության մեջ։ Կոմպիլացված կոդը հարմար չէ զարգացումային գործընթացի համար, քանի որ Twig կաղապարների փոփոխությունները անմիջապես չեն թարմացվում ձեր Drupal կայքում։
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.