.info.yml फ़ाइल की मदद से थीम की परिभाषा

Drupal 8 में एक थीम बनाने के लिए, सबसे पहले आपको THEMENAME.info.yml फ़ाइल बनानी होगी, जो Drupal में आपकी थीम के बारे में मेटाडेटा प्रदान करती है। यह उसी तरह है जैसे मॉड्यूल और इंस्टॉलेशन प्रोफाइल परिभाषित किए जाते हैं, और इसलिए यह महत्वपूर्ण है कि file.info.yml फ़ाइल में type कुंजी को theme पर सेट किया जाए ताकि इसे अलग से पहचाना जा सके।

यह पेज THEMENAME.info.yml फ़ाइल का एक उदाहरण और उस जानकारी का अवलोकन प्रस्तुत करता है जो यह फ़ाइल रख सकती है।

.info.yml फ़ाइल बनाएँ

अपनी थीम की रूट फ़ोल्डर में .info.yml फ़ाइल बनाएँ। फ़ोल्डर का नाम .info.yml फ़ाइल के समान होना चाहिए। इसलिए यदि आपकी थीम का नाम "Fluffiness" है, तो फ़ोल्डर का नाम fluffiness/ होगा और .info.yml फ़ाइल का नाम fluffiness/fluffiness.info.yml होगा। यदि फ़ाइल न्यूनतम आवश्यक गुणों (name, type और core) के साथ मौजूद है, तो आपकी थीम आपकी वेबसाइट पर "Manage > Appearance" अनुभाग में दिखाई देगी (http://example.com/admin/appearance)। ध्यान रखें कि आप ऐसा थीम नाम चुनें जो किसी मॉड्यूल या अन्य थीम द्वारा पहले से उपयोग में न हो। Drupal की सेटिंग्स में थीम का नाम यूनिक होना चाहिए। अन्यथा, थीम के घटक सही ढंग से लोड नहीं होंगे।

थीम नाम में स्पेस की जगह अंडरस्कोर का उपयोग करें (फ़ोल्डर नाम और .info.yml फ़ाइल नाम दोनों में)।

यदि आप YAML फ़ाइल संरचना से परिचित नहीं हैं, तो YAML फ़ाइल फॉर्मेट का एक संक्षिप्त परिचय पढ़ें।

• Tabs की अनुमति नहीं है। केवल spaces का उपयोग करें।
• गुण और सूचियों में दो (2) spaces का इंडेंट होना चाहिए।

उदाहरण

name: Fluffiness
type: theme
description: 'A cuddly theme that offers extra fluffiness.'
core: 8.x
libraries:
  - fluffiness/global-styling
base theme: classy
regions:
  header: Header
  content: Content
  sidebar_first: 'Sidebar first'
  footer: Footer

अपने Drupal साइट पर आप .info.yml फ़ाइलों के और उदाहरण देख सकते हैं, जो कोर द्वारा दी गई थीम्स में होती हैं। उदाहरण के लिए, core/themes/stark फ़ोल्डर खोलें और stark.info.yml फ़ाइल ढूँढें।

Key/Value जोड़े

निम्न Key/Value जोड़े आपकी थीम के बारे में मेटाडेटा प्रदान करते हैं और कुछ बुनियादी कार्य निर्धारित करते हैं। (देखें \Drupal\Core\Extension\InfoParserInterface::parse())

• name (अनिवार्य)
• type (अनिवार्य)
• description (वैकल्पिक)
• package (वैकल्पिक)
• core (अनिवार्य)
• php (वैकल्पिक)
• version (वैकल्पिक)
• libraries (वैकल्पिक)
• libraries-override (वैकल्पिक)
• libraries-extend (वैकल्पिक)
• base theme (अनुशंसित)
• hidden (वैकल्पिक)
• engine (वैकल्पिक)
• logo (वैकल्पिक)
• screenshot (वैकल्पिक)
• regions (वैकल्पिक)
• regions_hidden (वैकल्पिक)
• features (वैकल्पिक)
• stylesheets-remove (अनुशंसित नहीं)
• ckeditor_stylesheets (वैकल्पिक)

अधिक जानकारी

• Drupal 8 थीम में स्टाइलशीट्स (CSS) और JavaScript (JS) जोड़ना
• सभी कुंजियों का पूरा विवरण जो * .info.yml फ़ाइल में उपलब्ध हैं, देखें: Drupal 8 को अपने मॉड्यूल के बारे में .info.yml फ़ाइल से बताएं।
• बदलाव प्रविष्टि: .info फ़ाइलें अब .info.yml फ़ाइलें हैं