Portalinhalte mit dem Seiteneditor entwickeln

Sie lesen die Dokumentation zu Apigee X.
Apigee Edge-Dokumentation aufrufen

Mit dem Seiteneditor definieren Sie Ihren Portalinhalt mit Markdown oder HTML.

Der Seiteneditor

Öffnen Sie den Seiteneditor, indem Sie beim Ansehen der Seitenliste auf den Namen einer Seite klicken, wie unter Seiten in Ihrem Portal verwalten beschrieben.

Seiteneditor

Wie in der vorherigen Abbildung erwähnt, können Sie mithilfe des Seiteneditors Folgendes tun:

Inhalte im Seiteneditor bearbeiten

Markdown ist eine einfache Formatierungssprache, die Nur-Text-Markups verwendet, die einfach zu lesen und zu schreiben sind. Die Syntax wird mithilfe von Satzzeichen angegeben. Markdown wird in HTML konvertiert, bevor das Rendering im Browser erfolgt.

Über die Schnellbearbeitungs-Symbolleiste oben im Seiteneditor finden Sie Verknüpfungen zum Anwenden von Formaten (z. B. fett, kursiv usw.) oder Einfügen von Markdown-Tags (Listen, Bilder, Links usw.). Eine kurze Zusammenfassung der Markdown-Syntax erhalten Sie, wenn Sie in der Schnellbearbeitungs-Symbolleiste auf Symbol: Markdown klicken, um die Kurzreferenz zur Markdown-Syntax aufzurufen.

Wenn Sie die letzte Änderung rückgängig machen oder wiederholen möchten, drücken Sie Befehlstaste + Z bzw. Befehlstaste + Umschalttaste + Z.

Sie sollten Markdown verwenden, wenn Sie Ihre Formatierung vereinfachen möchten. Es ist jedoch nicht sinnvoll, HTML zu ersetzen. In HTML stehen Ihnen viele Formatierungen zur Verfügung, die im Markdown nicht möglich sind. Sie können beispielsweise eine CSS-Klasse für ein Element in HTML angeben. Dies ist nicht in Markdown möglich: 

   <p class="class1">

Sie können HTML an einer beliebigen Stelle im Inhaltstext einfügen, wenn Sie einfach die HTML-Tags eingeben.

Weitere Informationen zu HTML-Tags finden Sie in der HTML5-Spezifikation.

Angular-Material-Komponenten hinzufügen

Angular-Material bietet eine hochmoderne Bibliothek der UI-Komponente. Mit Angular-Material-Komponenten können Sie schnell und einheitlich konsistente, responsive und leicht zugängliche Benutzeroberflächen unter Verwendung moderner Designprinzipien erstellen.

Verfügbare Komponenten

Für das Portal wurde Angular Material verwendet und es kann eine begrenzte Anzahl von Angular Material-Komponenten auf Seiten angewendet werden. Diese werden in der folgenden Tabelle zusammengefasst.

Komponente Beispiel
Schaltflächen Mit dem folgenden Code wird eine rechteckige Schaltfläche mit Höhe erstellt.

<a mat-raised-button
   href="quickstart">
   Quick Start
</a>

Mit dem folgenden Code wird eine kreisförmige Schaltfläche mit einem transparenten Hintergrund erstellt, der das Warnsymbol enthält. Die Farbe der Schaltfläche wird mithilfe der Warnfarbe festgelegt.


<button mat-icon-button
   color="warn">
   <mat-icon aria-label="Example warning">warning</mat-icon>
</button>
Karte Mit dem folgenden Code wird eine Karte erstellt. Die Karte enthält Schaltflächen- und Symbolkomponenten sowie Überschriften und Text. Die Farbe der Schaltfläche wird durch die primäre Farbvorlage definiert.


<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>
Symbol Mit dem folgenden Code wird ein Häkchen erstellt. Eine vollständige Liste der unterstützten Symbole finden Sie unter Material Design – Symbole.

<mat-icon>
   check_circle
</mat-icon>
Google Toolbar Mit dem folgenden Code wird eine einfache Symbolleiste mit Text und einem Einkaufswagensymbol erstellt. 

<mat-toolbar color="primary">
   <span>My Store</span>
   <span class="space-buffer"></span>
   <mat-icon>add_shopping</mat-icon>
</mat-toolbar>

Verwalten der Sichtbarkeit für eine Seite in Ihrem Portal

Verwalten Sie die Sichtbarkeit einer Seite in Ihrem Portal, indem Sie folgenden Zugriff gewähren:

So verwalten Sie die Sichtbarkeit einer Seite in Ihrem Portal:

  1. Klicken Sie im rechten Bereich des Seiteneditors neben der gewünschten Zielgruppe auf Verwalten.
  2. Wählen Sie die Sichtbarkeitseinstellung aus. Wenn Sie sich für die Betaversion der Zielgruppenfunktion angemeldet haben, wählen Sie eine der folgenden Optionen aus:
    • Öffentlich (für alle sichtbar), damit alle Nutzer die Seite aufrufen können.
    • Authentifizierte Nutzer, um nur registrierten Nutzern die Anzeige der Seite zu ermöglichen.
    • Ausgewählte Zielgruppen, damit nur von Ihnen festgelegte Zielgruppen die Seite aufrufen können. Weitere Informationen erhalten Sie unter Zielgruppen für Ihr Portal verwalten.
      Klicken Sie auf Zielgruppen erstellen oder ändern, um Ihre Zielgruppen zu verwalten.

    Wählen Sie andernfalls eine der folgenden Optionen aus:
    • Anonyme Nutzer, um allen Nutzern die Anzeige der Seite zu ermöglichen.
    • Registrierte Nutzer, um nur registrierten Nutzer die Anzeige der Seite zu ermöglichen.
  3. Klicken Sie auf Anwenden.

Vorschau des Portalinhalts

Wenn Sie eine Vorschau des Portalinhalts sehen möchten, klicken Sie in der Symbolleiste des Seiteneditors auf Vorschau. Sehen Sie sich die anderen Seiten im Portal an, um den Inhalt wie gewünscht aufzurufen.

Veröffentlichen von Portalinhalten

Um den Portalinhalt zu veröffentlichen, klicken Sie im rechten Bereich auf Veröffentlichen. Um die Veröffentlichung des Portalinhalts aufzuheben, klicken Sie im rechten Bereich auf Veröffentlichung aufheben. Weitere Informationen finden Sie unter Portalinhalte veröffentlichen.

Seiten löschen

Wenn Sie eine Seite aus dem Portaleditor löschen möchten, klicken Sie im rechten Bereich des Seiten-Editors auf Löschen. Sie werden aufgefordert, den Vorgang zu bestätigen: