अलग-अलग पेजों पर कॉन्टेंट का फिर से इस्तेमाल करना

इस गाइड में, DevSite के अलग-अलग लेखों में कॉन्टेंट शेयर करने का तरीका बताया गया है.

कई पेजों पर कॉन्टेंट का दोबारा इस्तेमाल करने के लिए, वैरिएबल और शामिल किए गए कॉन्टेंट का इस्तेमाल किया जा सकता है. यह Composer में कई लेखों में स्निपेट इस्तेमाल करने का DevSite वर्शन है.

ध्यान दें: support.google.com पर मौजूद सहायता केंद्रों के साथ शेयर किए गए कॉन्टेंट को क्रॉस-पब्लिश नहीं किया जा सकता. नेविगेशन में, किसी भी डोमेन के पेजों को लिंक किया जा सकता है. हालांकि, किसी लेख या सेक्शन के लिए, DevSite से बाहर के डोमेन को सिंगल सोर्स के तौर पर इस्तेमाल नहीं किया जा सकता.

इन्क्लूड और वैरिएबल का इस्तेमाल कब करना चाहिए

जब आपको टेक्स्ट की छोटी और एक ही सोर्स से मिली स्ट्रिंग का दोबारा इस्तेमाल करना हो, तब वैरिएबल का इस्तेमाल करें. उदाहरण के लिए, प्रॉडक्ट के नाम और सुविधाओं के नाम.
अगर आपको फ़ॉर्मैट किए गए टेक्स्ट या एचटीएमएल को फिर से इस्तेमाल करना है, तो शामिल करें का इस्तेमाल करें. उदाहरण के लिए, सुविधाओं की तुलना करने वाली टेबल या ज़रूरी नोट.

वेरिएबल बनाएं

google3/third_party/devsite/workspace/en/_globalvars.html खोलें.
1. सबसे ऊपर दाईं ओर, Cider में बदलाव करें पर क्लिक करें.
वैरिएबल की नई परिभाषा जोड़ें.
- अपनी फ़ाइल में, नए वैरिएबल को किसी मौजूदा कैटगरी हेडिंग के नीचे रखें. अगर ज़रूरी हो, तो हम नए फ़ील्ड जोड़ सकते हैं.
- हर कैटगरी को वैरिएबल के नाम के हिसाब से वर्णमाला के क्रम में रखें.
- पक्का करें कि आपके नए वैरिएबल के नाम का इस्तेमाल, यहां दी गई किसी भी वैरिएबल फ़ाइल में पहले से न किया गया हो:
  - google3/googledata/devsite/_common/en/_shared/_product_names.html
- google3/googledata/devsite/_common/en/_shared/workspace/_product_names.html
- google3/googledata/devsite/_common/en/_shared/cloud/_product_names.html
```
{% setvar YOUR_VARIABLE_NAME %}TEXT_TO_DISPLAY{% endsetvar %}
```
- YOUR_VARIABLE_NAME को उस वैरिएबल से बदलें जिसका आपको इस्तेमाल करना है.
- TEXT_TO_DISPLAY को उस टेक्स्ट से बदलें जो उपयोगकर्ता को दिखना चाहिए.
अपने बदलावों को सेव करें और समीक्षा और मंज़ूरी के लिए, workspace-content-configs को सीएल भेजें.
सीएल सबमिट करने के बाद, अपने नए वैरिएबल के नाम का इस्तेमाल करके कॉन्टेंट पब्लिश किया जा सकता है!

अपने कॉन्टेंट में कोई वैरिएबल जोड़ना

अपने पेज में कोई वैरिएबल जोड़ने के लिए, Jinja वैरिएबल का इस्तेमाल करें. इस आसान {{ ... }} कंस्ट्रक्शन से, आपकी साइट के पेज पर टैग की जगह पर, तय किए गए वैरिएबल का कॉन्टेंट डाला जाता है.

उदाहरण


**Note:** You can buy {{ workspace_name }} from a reseller.

<table>
  <tr>
    <th>Edition</th>
    <th>Cost</th>
  </tr>
  <tr>
    <td>{{ business_plus_sku_name }}</td>
    <td>$50 / month</td>
  </tr>
  <tr>
    <td>{{ business_standard_sku_name }}</td>
    <td>$20 / month</td>
  </tr>
  <tr>
    <td>{{ business_starter_sku_name }}</td>
    <td>No additional cost</td>
  </tr>
</table>

रेंडर किया गया

ध्यान दें: Google Workspace को किसी रीसेलर से खरीदा जा सकता है.

वर्शन	लागत
Business Plus	50 डॉलर / महीना
Business Standard	20 डॉलर / महीना
Business Starter	कोई अतिरिक्त शुल्क नहीं

कोई शामिल की जाने वाली फ़ाइल बनाना

अहम जानकारी: शामिल की गई फ़ाइलें हमेशा एचटीएमएल फ़ॉर्मैट में होनी चाहिए. ऐसा इसलिए है, क्योंकि एचटीएमएल फ़ॉर्मैट, एचटीएमएल और मार्कडाउन, दोनों तरह के कोड ब्लॉक के कॉन्टेक्स्ट में काम कर सकता है. हालांकि, मार्कडाउन में शामिल किए गए कॉन्टेंट सिर्फ़ मार्कडाउन कोड ब्लॉक के कॉन्टेक्स्ट में काम करते हैं.

वीडियो ट्यूटोरियल देखें

शामिल की जाने वाली फ़ाइल बनाने के लिए, यह तरीका अपनाएं:

Cider खोलें.
third_party/devsite/workspace/en/_shared/includes/ फ़ोल्डर ढूंढने के लिए, Code Search या Files Explorer का इस्तेमाल करें.
includes फ़ोल्डर पर राइट क्लिक करें. इसके बाद, नई फ़ाइल पर क्लिक करें (स्क्रीनशॉट).
- अगर आपका शामिल किया गया कॉन्टेंट सिर्फ़ आपके कॉन्टेंट सेट से जुड़ा है, तो /includes फ़ोल्डर में अपने कॉन्टेंट सेट के लिए एक सबफ़ोल्डर बनाएं. इसके बाद, शामिल की गई फ़ाइल को वहां जोड़ें. उदाहरण के लिए, …/workspace/en/shared/includes/cloud-search/_my-niche-snippet.html
फ़ाइल को कोई नाम दें और उसमें अपना कॉन्टेंट जोड़ें. इन दिशानिर्देशों का पालन करें:
- फ़ाइल का नाम अंडरस्कोर से शुरू करें. उदाहरण के लिए, _my-new-include.html. इससे, शामिल की गई फ़ाइल को बाहरी तौर पर अपना पेज बनने से रोका जा सकता है.
- फ़ाइल के नाम में ज़्यादा जानकारी दें. इससे सभी लोगों के लिए, शामिल किए गए कॉन्टेंट को ढूंढना और इस्तेमाल करना आसान हो जाता है.
- सभी शामिल की गई फ़ाइलें एचटीएमएल फ़ाइलें होनी चाहिए. फ़ाइल का एक्सटेंशन .html होना चाहिए. साथ ही, फ़ाइल में मार्कडाउन में लिखे गए कोई भी एलिमेंट शामिल नहीं होने चाहिए. इससे यह पक्का होता है कि कॉन्टेंट सही तरीके से रेंडर होगा. भले ही, उसे किसी मार्कडाउन फ़ाइल, एचटीएमएल फ़ाइल या मार्कडाउन फ़ाइल में मौजूद एचटीएमएल एलिमेंट में शामिल किया गया हो.
- कॉन्टेंट को अलग-अलग प्लैटफ़ॉर्म के हिसाब से बनाएं. किसी कॉन्टेंट को शामिल करने का मकसद यह होता है कि वह कई पेजों पर इस्तेमाल किया जा सके. इसलिए, कॉन्टेंट को ज़्यादा से ज़्यादा बार इस्तेमाल किया जा सकने वाला होना चाहिए. * शामिल करने के लिए सबसे सही कॉन्टेंट: लागू करने से जुड़ी किसी भी जानकारी वाले चरण और उनसे जुड़े नोट या सलाह. जैसे, सीमाएं, चेतावनियां या काम करने का तरीका. * शामिल न करें: हेडिंग या खास जानकारी (हम इन्हें कारोबार के इस्तेमाल के उदाहरणों के लिए, खुद फ़ॉर्मैट और लिखना चाहते हैं).

उदाहरण: Google Cloud प्रोजेक्ट का प्रोजेक्ट नंबर कॉपी करने का तरीका बताने वाले चरणों के लिए, यहां एक उदाहरण दिया गया है:

third_party/devsite/workspace/en/_shared/includes/_copy-cloud-project-number-steps.html

ज़्यादा जानकारी के लिए, फ़ाइलें शामिल करें के लिए DevSite Publishing का दस्तावेज़ देखें.

अपने कॉन्टेंट में कोई शामिल किया गया कॉन्टेंट जोड़ना

अपने पेज में कोई फ़ाइल शामिल करने के लिए, include टैग का इस्तेमाल करें. include टैग, आपकी फ़ाइल के कॉन्टेंट को आपके पेज पर टैग की जगह पर डालता है.

यहां पिछले सेक्शन की उदाहरण फ़ाइल के लिए, शामिल किए गए टैग का एक उदाहरण दिया गया है:

उदाहरण


{% include "_shared/includes/_copy-cloud-project-number-steps.html" %}

रेंडर किया गया

Google Cloud console में, मेन्यू आईएएम और एडमिन सेटिंग पर जाएं.
आईएएम और एडमिन सेटिंग पर जाएं
प्रोजेक्ट नंबर फ़ील्ड में, वैल्यू कॉपी करें.

माइग्रेट की गई स्निपेट फ़ाइलें

Composer के स्निपेट को third_party/devsite/workspace/en/_shared/snippets फ़ोल्डर में माइग्रेट कर दिया गया है. अगर आपके कॉन्टेंट में Composer से DevSite पर माइग्रेट करने से पहले स्निपेट का इस्तेमाल किया गया था, तो आपको अपने कॉन्टेंट में शामिल किए गए टैग दिखेंगे. ये टैग, यहां दिए गए उदाहरण की तरह होंगे:

{% include "_shared/snippets/_snippet-9393389.html" %}

_shared/snippets फ़ोल्डर में नई शामिल की गई फ़ाइलें न जोड़ें.

क्रॉस पब्लिशिंग

DevSite में, हर पेज एक कॉन्टेंट सेट से जुड़ा होता है. Devsite, Composer में इस्तेमाल होने वाली क्रॉस-पब्लिशिंग की सुविधा के साथ काम नहीं करता. इस सुविधा की मदद से, किसी एक पेज को कई सहायता केंद्रों में पब्लिश किया जा सकता है. इसके बजाय, विषय-सूची (टीओसी) से अन्य कॉन्टेंट सेट के पेजों को लिंक किया जा सकता है.

अपने नेविगेशन में किसी दूसरे कॉन्टेंट सेट से कोई पेज जोड़ना

अपने नेविगेशन में मौजूद किसी दूसरे कॉन्टेंट सेट से किसी पेज को लिंक करने के लिए, यह तरीका अपनाएं:

अपने कॉन्टेंट सेट के लिए _book.yaml फ़ाइल खोलें. _book.yaml फ़ाइल में, अपनी साइट के नेविगेशन को मैनेज किया जाता है.
उस पेज का टाइटल और रूट पाथ जोड़ें जिसे आपको लिंक करना है.

यहां दिए गए उदाहरण में, Cloud Search के लिए _book.yaml फ़ाइल, Business Continuity कॉन्टेंट सेट के किसी लेख से लिंक होती है.

    - name: "Guides"
      contents:
      - heading: "Getting started"
      - title: "What is Google Cloud Search?"
        path: /cloud-search/what-is-google-cloud-search 
      - title: "Deploy 2-Step Verification"
        path: /business-continuity/security-and-monitoring/deploy-2-step-verification

जब कोई उपयोगकर्ता Cloud Search के नेविगेशन में मौजूद, 'दो चरणों में पुष्टि की सुविधा चालू करें' लिंक पर क्लिक करता है, तो उसे Business Continuity के दस्तावेज़ में मौजूद पेज पर ले जाया जाता है.

अपनी साइट के नेविगेशन को अपडेट करने के बारे में ज़्यादा जानने के लिए, नेविगेशन अपडेट करना लेख पढ़ें.