تطوير محتوى البوابة باستخدام محرِّر الصفحة

أنت تطّلع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

باستخدام محرِّر الصفحات، يمكنك تحديد محتوى البوابة باستخدام Markdown أو HTML.

استكشاف محرِّر الصفحة

يمكنك الوصول إلى محرِّر الصفحة من خلال النقر على اسم صفحة عند عرض قائمة الصفحات، كما هو موضّح في مقالة إدارة الصفحات في البوابة.

محرر الصفحات

كما هو موضّح في الشكل السابق، يتيح لك محرِّر الصفحة إجراء ما يلي:

تعديل المحتوى في محرر الصفحات

Markdown هي لغة تنسيق بسيطة تستخدم ترميز نص عادي سهل القراءة والكتابة. يتم تحديد بناء الجملة باستخدام أحرف علامات الترقيم. يتم تحويل تنسيق Markdown إلى HTML قبل عرضه في المتصفّح.

يوفّر شريط أدوات التعديل السريع في أعلى محرِّر الصفحة اختصارات لتطبيق التنسيقات (مثل التنسيق الغامق والمائل وما إلى ذلك) أو إدراج علامات Markdown (مثل القوائم والصور والروابط وما إلى ذلك). للحصول على ملخّص سريع لبنية Markdown، انقر على رمز Markdown في شريط أدوات التعديل السريع للاطّلاع على مرجع سريع لبنية Markdown.

للتراجع عن التعديل الأخير أو إعادته، انقر على Command-z أو Command-Shift-z، على التوالي.

يوصى باستخدام Markdown إذا كنت تريد إبقاء سير عمل التنسيق بسيطًا. ومع ذلك، لا يهدف إلى استبدال HTML. هناك مجموعة كبيرة من التنسيقات التي يمكنك إجراؤها في HTML ولا يمكنك تنفيذها باستخدام Markdown. على سبيل المثال، يمكنك تحديد فئة CSS لعنصر في HTML؛ لا يمكنك القيام بذلك باستخدام Markdown: 

   <p class="class1">

يمكنك إدراج علامات HTML في أيّ مكان ضمن نص المحتوى من خلال إدخال علامات HTML.

للحصول على معلومات عن علامات HTML، راجِع مواصفات HTML5.

إضافة مكونات Angular Material

توفّر Angular Material مكتبة حديثة لمكوّنات واجهة المستخدم. تتيح لك مكونات Angular Material إنشاء واجهات مستخدم متّسقة وسريعة الاستجابة وسهلة الاستخدام باستخدام مبادئ التصميم الحديثة.

المكوّنات المتوفّرة

تم إنشاء تجربة البوابة باستخدام Angular Material، ويمكن استخدام مجموعة محدودة من مكوّنات Angular Material في الصفحات، كما هو ملخّص في الجدول التالي.

المكوّن مثال
الأزرار تنشئ التعليمة البرمجية التالية زرًا مستطيلاً مع ارتفاع.
<a mat-raised-button 
   href="quickstart">
   Quick Start
</a>

تنشئ التعليمة البرمجية التالية زرًا دائريًا بخلفية شفافة يتضمّن رمز التحذير. يتم تحديد لون الزر باستخدام لوحة ألوان التحذير.

<button mat-icon-button
   color="warn">
   <mat-icon aria-label="Example warning">warning</mat-icon>
</button>
البطاقة ينشئ الرمز التالي بطاقة. تتضمن البطاقة مكونات الزر والأيقونة، بالإضافة إلى العنوان والنص الأساسي. يتم تحديد لون الزر باستخدام لوحة الألوان الأساسية.
<mat-card 
   href="apis">
   <mat-card-header 
      color="primary">
         <mat-icon>
            class
         </mat-icon>
         <h1>
            APIs
         </h1>
   </mat-card-header>
   <mat-card-content>
      <p class="home-page-card-content-text">
         Learn about and try our APIs.
      </p>
   </mat-card-content>
   <mat-card-actions>
      <button mat-button>
          View APIs
      </button>
   </mat-card-actions>
</mat-card>
الرمز تنشئ التعليمة البرمجية التالية رمز علامة اختيار. للحصول على قائمة كاملة بالرموز المتوافقة، يمكنك الاطّلاع على التصميم المتعدد الأبعاد - الرموز.
<mat-icon>
   check_circle
</mat-icon>
شريط الأدوات تُنشئ التعليمة البرمجية التالية شريط أدوات بسيطًا يحتوي على نص ورمز عربة التسوق. 
<mat-toolbar color="primary">
   <span>My Store</span>
   <span class="space-buffer"></span>
   <mat-icon>add_shopping</mat-icon>
</mat-toolbar>

إدارة إذن الوصول إلى صفحة في البوابة

يمكنك إدارة مستوى رؤية صفحة في البوابة من خلال السماح بالوصول إلى:

لإدارة مستوى ظهور صفحة في البوابة:

  1. انقر على إدارة بجانب شريحة الجمهور في اللوحة اليمنى من محرِّر الصفحة.
  2. اختَر إعداد مستوى العرض. إذا كنت قد سجّلت في الإصدار التجريبي لميزة الجماهير، حدِّد أحد الخيارات التالية:
    • علنية (مرئية لأي شخص) للسماح لجميع المستخدمين بعرض الصفحة.
    • المستخدمون الذين تمت مصادقتها للسماح للمستخدمين المسجَّلين فقط بالاطّلاع على الصفحة.
    • الجماهير المختارة لاختيار شرائح الجمهور المحدّدة التي تريد أن تتيح لها عرض الصفحة. راجِع مقالة إدارة شرائح الجمهور في البوابة.
      لإدارة شرائح جمهورك، انقر على إنشاء شرائح جمهور أو تعديلها.

    إذا لم يكن الأمر كذلك، حدِّد أحد الخيارات التالية:
    • المستخدمون المجهولون للسماح لجميع المستخدمين بعرض الصفحة.
    • المستخدمون المسجّلون للسماح للمستخدمين المسجَّلين فقط بالاطّلاع على الصفحة.
  3. انقر على تطبيق.

معاينة محتوى البوابة

لمعاينة محتوى البوابة، انقر على معاينة في شريط أدوات محرِّر الصفحة. يمكنك التنقّل في الصفحات الأخرى في البوابة لمعاينة المحتوى على النحو المطلوب.

نشر محتوى البوابة الإلكترونية

لنشر محتوى البوابة، انقر على نشر في الجزء الأيسر. لإلغاء نشر محتوى البوابة، انقر على إلغاء النشر في الجزء الأيسر. اطّلِع أيضًا على نشر محتوى البوابة.

حذف صفحة

لحذف صفحة من محرِّر البوابة، انقر على حذف في الجزء الأيسر من محرِّر الصفحات. سيُطلب منك تأكيد العملية.