إعادة استخدام المحتوى على صفحات متعددة

يتضمّن هذا الدليل معلومات حول كيفية مشاركة المحتوى بين المقالات في DevSite.

لإعادة استخدام المحتوى على صفحات متعددة، يمكنك استخدام المتغيرات وعمليات التضمين، وهي إصدار DevSite من استخدام المقتطفات في مقالات متعددة في Composer.

ملاحظة: لا يمكن نشر المحتوى المشترك بشكل متبادل مع مراكز المساعدة على support.google.com. يمكنك إنشاء روابط تؤدي إلى صفحات من أي نطاق في شريط التنقّل، ولكن لا يمكنك استخدام نطاقات غير تابعة لموقع DevSite كمصدر وحيد لمقالة أو قسم.

حالات استخدام عمليات التضمين والمتغيّرات

• استخدِم متغيرًا عندما تريد إعادة استخدام سلسلة نصية قصيرة ذات مصدر واحد. على سبيل المثال، أسماء المنتجات وأسماء الميزات.

• استخدِم include عندما تريد إعادة استخدام نص من مصدر واحد بتنسيق أو HTML. على سبيل المثال، جدول مقارنة الميزات أو ملاحظة مهمة.

إنشاء مُتغيّر

1. افتح google3/third_party/devsite/workspace/en/_globalvars.html.
   1. في أعلى اليسار، انقر على التعديل في Cider.

2. أضِف تعريفًا جديدًا للمتغيّر.

   • حاوِل إدراج المتغيّر الجديد ضمن أحد عناوين الفئات الحالية في الملف. ويمكننا إضافة المزيد إذا لزم الأمر.
   • يجب أن تكون كل فئة مرتبة أبجديًا حسب اسم المتغيّر.

   • تأكَّد من أنّ اسم المتغيّر الجديد لم يسبق استخدامه في أحد ملفات المتغيّرات التالية:

     • 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 بالنص الذي يجب عرضه للمستخدم.

3. احفظ التغييرات وأرسِل طلب تغيير إلى workspace-content-configs للمراجعة والموافقة.

4. بعد إرسال قائمة التغيير، يمكنك نشر المحتوى باستخدام اسم المتغيّر الجديد.

إضافة متغيّر إلى المحتوى

لإضافة متغيّر إلى صفحتك، استخدِم متغيّر 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>

إنشاء ملف تضمين

ملاحظة مهمة: يجب أن تكون الملفات المضمّنة دائمًا بتنسيق HTML. ويرجع ذلك إلى أنّ تنسيق HTML يمكن أن يعمل في سياقات كلّ من HTML وMarkdown، ولكنّ تضمينات Markdown تعمل في سياقات مجموعة رموز Markdown فقط.

مشاهدة فيديو تعليمي

لإنشاء ملف تضمين، اتّبِع الخطوات التالية:

1. افتح Cider.

2. استخدِم "بحث الرموز" أو "مستكشف الملفات" للعثور على المجلد third_party/devsite/workspace/en/_shared/includes/.

3. انقر بزر الماوس الأيمن على مجلد includes وانقر على ملف جديد (لقطة شاشة).

   • إذا كان ملف التضمين ذا صلة فقط بمجموعة المحتوى، يمكنك إنشاء مجلد فرعي لمجموعة المحتوى ضمن المجلد /includes وإضافة ملف التضمين إليه. على سبيل المثال: …/workspace/en/shared/includes/cloud-search/_my-niche-snippet.html

4. أدخِل اسمًا للملف وأضِف المحتوى. اتبع الإرشادات التالية:

   • ابدأ اسم الملف بشرطة سفلية. على سبيل المثال، _my-new-include.html. ويمنع ذلك أن يصبح ملف التضمين صفحة مستقلة خارجيًا.
   • استخدام اسم وصفي للملف: يسهّل ذلك على الجميع العثور على عملية التضمين واستخدامها.
   • يجب أن تكون جميع عمليات التضمين ملفات HTML. يجب أن يكون امتداد الملف .html ويجب ألا يتضمّن أي عناصر مكتوبة بلغة Markdown. يضمن ذلك عرض المحتوى بشكل صحيح سواء كان مضمّنًا في ملف Markdown أو ملف HTML أو عنصر HTML ضمن ملف Markdown.
   • توفير محتوى متنوّع: والهدف من عملية التضمين هو أن يكون المحتوى مناسبًا للاستخدام على صفحات متعددة، لذا يجب أن يكون المحتوى قابلاً لإعادة الاستخدام قدر الإمكان. * المحتوى المثالي الذي يجب تضمينه: الخطوات والملاحظات أو النصائح ذات الصلة التي تتضمّن أي تفاصيل حول التنفيذ، مثل الحدود أو التحذيرات أو طريقة عمل الأشياء. * تجنَّب: العناوين أو النظرات العامة (نريد تنسيقها وكتابتها بأنفسنا، وذلك لحالات الاستخدام التجاري).

مثال: في ما يلي مثال على ملف يتضمّن خطوات حول كيفية نسخ رقم مشروع 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" %}

ملفات المقتطفات التي تم نقلها

تم نقل المقتطفات من Composer إلى المجلد third_party/devsite/workspace/en/_shared/snippets. إذا كان المحتوى الخاص بك يستخدم مقتطفات في Composer قبل نقله إلى DevSite، ستظهر لك علامات التضمين في المحتوى الخاص بك على غرار المثال التالي:

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

لا تُضِف ملفات تضمين جديدة إلى المجلد _shared/snippets.

النشر المشترك

في DevSite، تنتمي كل صفحة إلى مجموعة محتوى واحدة. لا يتيح Devsite ميزة النشر المشترك المستخدَمة في Composer، حيث يمكن نشر صفحة واحدة في عدة مراكز مساعدة. بدلاً من ذلك، يمكنك إنشاء روابط تؤدي إلى صفحات في مجموعات محتوى أخرى من داخل جدول المحتويات.

إضافة صفحة من مجموعة محتوى مختلفة إلى شريط التنقّل

لإنشاء رابط يؤدي إلى صفحة من مجموعة محتوى مختلفة في شريط التنقّل، اتّبِع الخطوات التالية:

1. افتح ملف _book.yaml لمجموعة المحتوى. ملف _book.yaml هو المكان الذي يمكنك فيه إدارة التنقّل في موقعك الإلكتروني.
2. أضِف عنوان الصفحة والمسار الجذر إلى الصفحة التي تريد إنشاء رابط إليها.

في المثال التالي، يرتبط ملف _book.yaml الخاص بـ Cloud Search بمقالة من مجموعة محتوى "استمرارية النشاط التجاري".

    - 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، يتم توجيهه إلى الصفحة في مستندات "استمرارية النشاط التجاري".

لمزيد من المعلومات حول تعديل التنقّل في موقعك الإلكتروني، يمكنك الاطّلاع على تعديل التنقّل.