Թեմաների Drupal 8 թղթապանակների կառուցվածք

Թեման ֆայլերի հավաքածու է, որոնք որոշում են ներկայացման մակարդակը։ Դուք նաև կարող եք ստեղծել մեկ կամ մի քանի «միջթեմաներ» կամ թեմայի տարբերակներ։ Պահանջվում է միայն .info.yml ֆայլը, սակայն մեծամասնությունը թեմաների և միջթեմաների կօգտագործեն նաև այլ ֆայլեր։ Այս էջում թվարկված են ֆայլերն ու թղթապանակները, որոնք գտնվում են սովորական թեմայում կամ միջթեմայում։

Թեմաների տեղադրություն

Թեմաները պետք է տեղադրվեն ձեր Drupal տեղադրման "themes" թղթապանակում։ Նշեք, որ Drupal-ի հիմնական թեմաները, ինչպիսիք են Bartik և Seven, գտնվում են core/themes թղթապանակում ձեր տեղադրման մեջ։

Խորհուրդ է տրվում ավելացված թեմաները տեղադրել «contrib» ենթաթղթապանակում, իսկ ձեր սեփական թեմաները՝ «custom» թղթապանակում։

Յուրաքանչյուր առանձին թեմա պարունակվում է թեմայի անվանով կոչվող թղթապանակում։ Օրինակ՝ fluffiness։ Անունը պետք է լիներ փոքրատառ, սկսվի տառից և օգտագործի ստորակետ (_) բացատների փոխարեն։

(Մասնակի) ձեր Drupal տեղադրման կառուցվածքը կարող է լինել հետևյալը՝

  |-core
  |  |-modules
  |  |-themes
  |  |  |-bartik
  |  |  |-seven
  ..
  |-modules
  |-themes
  |  |-contrib
  |  |  |-zen
  |  |  |-basic
  |  |  |-bluemarine
  |  |-custom
  |  |  |-fluffiness

Թեմայի թղթապանակի կառուցվածք

Սա օրինակ է ֆայլերի և թղթապանակների, որոնք գտնվում են սովորական թեմայի թղթապանակի կառուցվածքում՝

  |-fluffiness.breakpoints.yml
  |-fluffiness.info.yml
  |-fluffiness.libraries.yml
  |-fluffiness.theme
  |-config
  |  |-install
  |  |  |-fluffiness.settings.yml
  |  |-schema
  |  |  |-fluffiness.schema.yml
  |-css
  |  |-style.css
  |-js
  |  |-fluffiness.js
  |-images
  |  |-buttons.png
  |-logo.svg
  |-screenshot.png
  |-templates
  |  |-maintenance-page.html.twig
  |  |-node.html.twig

Ներքևում ներկայացված է առավել տարածված ֆայլերի նկարագրությունը, որոնք կարող եք գտնել թեմայում։

*.info.yml
Թեման պետք է ունենա .info.yml ֆայլ թեման սահմանելու համար։ Դրանք սահմանում են մետատվյալները, գրադարանները և բլոկների տարածքները։ Սա թեմայի միակ պարտադիր ֆայլն է։

*.libraries.yml
.libraries.yml ֆայլը օգտագործվում է JavaScript և CSS գրադարանները սահմանելու համար, որոնք կարող են բեռնվել թեմայով։

*.breakpoints.yml
Breakpoints-ները սահմանում են, թե որտեղ պետք է փոխվի ադապտիվ դիզայնը՝ տարբեր սարքերի համար արձագանքելու համար։ Breakpoint-ները սահմանված են .breakpoints.yml ֆայլում։

*.theme
.theme ֆայլը PHP ֆայլ է, որը պարունակում է պայմանական լոգիկա և նախնական տվյալների մշակում։ Այն նաև կարող է ընդլայնել թեմայի հիմնական կարգավորումները։ Ընդլայնված թեմայի կարգավորումների ստեղծում։

CSS/
Խորհուրդ է տրվում CSS ֆայլերը պահել 'css' ենթաթղթապանակում։ Drupal 8-ի հիմնական թեմաները կազմակերպում են CSS ֆայլերը՝ SMACSS ոճի ուղեցույցի համաձայն։ Թեման պետք է բեռնավորի CSS ֆայլերը՝ որոնք սահմանված են .libraries.yml ֆայլում և կարող են վերաշարադրվել կամ ջնջվել .info.yml ֆայլում։

JS/
Թեմային հատուկ JavaScript ֆայլերը պահվում են 'js' թղթապանակում։ JS ֆայլերը պետք է սահմանված լինեն .libraries.yml ֆայլում՝ բեռնվելու համար։

images/
Խորհուրդ է տրվում պատկերները պահել «images» ենթաթղթապանակում։

screenshot.png
Եթե թեմայի թղթապանակում կա screenshot.png ֆայլ, այն կօգտագործվի «Ցուցադրման» էջում։ Կարող եք նաև սքրինշոթ սահմանել .info.yml ֆայլում։

logo.svg
Եթե թեմայի թղթապանակում կա վեկտոր SVG լոգոյի ֆայլ, այն կարելի է օգտագործել կայքի վերնամասում։ Լոգոները կարելի է նաև բեռնել «Ցուցադրման» բաժնի «Կարգավորումներ»։

templates/
Թեմաները ապահովում են HTML մակրո և որոշ ցուցադրական լոգիկա։ Դրա հակառակությամբ Drupal 7-ի, Drupal 8-ի թեմայի տեքստային ֆայլերը (*.html.twig) պետք է պահվեն 'templates' ենթաթղթապանակում։ Եթե հետևեք անվանման որոշ պայմաններին, Drupal-ը կհաղորդվի հիմնական թեմաների տեքստերը ձեր տրամադրածներին, ինչը թույլ կտա վերաշարադրել ստանդարտ ներկայացումը։ Կարող եք նաև կազմակերպել ձեր տեքստերը ենթաթղթապանակներում, օրինակ՝ բոլոր բլոկների տեքստերը templates/blocks, իսկ Views-ի տեքստերը templates/views։

Bartik հիմնական թեմա՝ թղթապանակների կառուցվածք

Օրինակ դիտեք Bartik թեմայի թղթապանակների կառուցվածքը, որը գտնվում է core/themes/bartik-ում՝

  |-bartik.breakpoints.yml
  |-bartik.info.yml
  |-bartik.libraries.yml
  |-bartik.theme
  |-color
  |  |-color.inc
  |  |-preview.css
  |  |-preview.html
  |  |-preview.js
  |-config
  |  |-schema
  |  |  |-bartik.schema.yml
  |-css
  |  |-colors.css
  |  |-layout.css
  |  |-maintenance-page.css
  |  |-print.css
  |-images
  |  |-add.png
  |  |-required.svg
  |  |-tabs-border.png
  |-logo.svg
  |-screenshot.png
  |-templates
  |  |-block--search-form-block.html.twig
  |  |-block--system-branding-block.html.twig
  |  |-block--system-menu-block.html.twig
  |  |-block.html.twig
  |  |-comment.html.twig
  |  |-field--taxonomy-term-reference.html.twig
  |  |-maintenance-page.html.twig
  |  |-node.html.twig
  |  |-page.html.twig
  |  |-status-messages.html.twig

Լրացուցիչ տեղեկություններ

Ծածկագրային ստանդարտներ՝ CSS ֆայլերի կազմակերպում