פיתוח תוכן פורטל באמצעות עורך הדפים

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

באמצעות כלי העריכה של הדף, מגדירים את תוכן הפורטל באמצעות Markdown או HTML.

הסבר על עורך הדפים

כדי לגשת לכלי לעריכת דפים, לוחצים על שם הדף כשמציגים את רשימת הדפים, כמו שמתואר במאמר ניהול הדפים בפורטל.

כפי שמודגש באיור הקודם, עורך הדפים מאפשר לכם:

• עריכת תוכן הפורטל והוספת רכיבי Angular Material בחלונית הימנית
• שימוש בסרגל הכלים לעריכה מהירה כדי להחיל פורמטים או להוסיף תגי Markdown במהירות
• עריכה של פרטי הדף, כמו השם, הנתיב והתיאור, בחלונית הימנית
• ניהול הנראות של דף בחלונית הימנית
• תצוגה מקדימה של תוכן הפורטל
• פרסום או ביטול פרסום של דף (ראו פרסום התוכן של הפורטל)
• ניהול הדף בתפריטי הניווט (ראו הגדרת ניווט)
• הצגת משך הזמן שעבר מאז שהדף פורסם לאחרונה
• מחיקת דף

עריכת תוכן בעורך הדפים

‫Markdown היא שפת עיצוב פשוטה שמשתמשת בסימון טקסט פשוט שקל לקרוא ולכתוב. התחביר שלו מוגדר באמצעות תווי פיסוק. ה-Markdown מומר ל-HTML לפני שהוא מוצג בדפדפן.

סרגל הכלים לעריכה מהירה בחלק העליון של כלי העריכה של הדף מספק קיצורי דרך להחלת פורמטים (כמו הדגשה, הטיה וכו') או להוספת תגי 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. לוחצים על אישור.

תצוגה מקדימה של תוכן הפורטל

כדי לראות תצוגה מקדימה של תוכן הפורטל, לוחצים על תצוגה מקדימה בסרגל הכלים של עורך הדפים. עוברים בין דפים אחרים בפורטל כדי לראות תצוגה מקדימה של התוכן, לפי הצורך.

פרסום תוכן בפורטל

כדי לפרסם את התוכן בפורטל, לוחצים על פרסום בחלונית השמאלית. כדי לבטל את הפרסום של תוכן הפורטל, לוחצים על ביטול הפרסום בחלונית הימנית. אפשר לעיין גם במאמר בנושא פרסום התוכן בפורטל.

מחיקת דף

כדי למחוק דף בכלי לעריכת הפורטל, לוחצים על מחיקה בחלונית השמאלית של כלי עריכת הדף. תתבקשו לאשר את הפעולה.