Sviluppo dei contenuti del portale utilizzando l'editor di pagine

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Con l'editor di pagine, puoi definire i contenuti del tuo portale utilizzando Markdown o HTML.

Esplorazione dell'editor di pagine

Accedi all'editor di pagine facendo clic sul nome di una pagina quando visualizzi l'elenco delle pagine, come descritto in Gestire le pagine nel tuo portale.

Si apre l'editor della pagina:

Interfaccia utente di Cloud Console

Fai clic per visualizzare l'immagine ingrandita

Interfaccia utente classica

Editor di pagine

L'editor di pagine ti consente di:

Modificare i contenuti nell'editor di pagine

Markdown è un semplice linguaggio di formattazione che utilizza il markup in testo normale, facile da leggere e scrivere. La sintassi viene specificata utilizzando i caratteri di punteggiatura. Il codice Markdown viene convertito in HTML prima del rendering nel browser.

La barra degli strumenti di modifica rapida nella parte superiore dell'editor di pagine fornisce scorciatoie per applicare formati (ad esempio grassetto, corsivo e così via) o inserire tag Markdown (ad esempio elenchi, immagini, link e così via).

Per un breve riepilogo della sintassi Markdown, nella barra degli strumenti di modifica rapida:

Interfaccia utente di Cloud Console

Fai clic sull'icona Informazioni.

Interfaccia utente classica

Fai clic sull'icona .

Viene visualizzato il riferimento rapido alla sintassi Markdown.

Per annullare o ripristinare l'ultima modifica, premi rispettivamente Comando+Z o Comando+Shift+Z.

Ti consigliamo di utilizzare Markdown se vuoi mantenere semplice il flusso di lavoro di formattazione. Tuttavia, non è pensato per sostituire l'HTML. In HTML puoi applicare una vasta gamma di formattazione che non è possibile utilizzare in Markdown. Ad esempio, puoi specificare una classe CSS per un elemento in HTML, ma non in Markdown:

   <p class="class1">

Puoi inserire HTML in qualsiasi punto del corpo dei contenuti semplicemente inserendo i tag HTML.

Per informazioni sui tag HTML, consulta la specifica HTML5.

Aggiunta di componenti Angular Material

Materiale Angular fornisce una libreria di componenti UI all'avanguardia. I componenti Angular Material ti consentono di creare interfacce utente coerenti, responsive e accessibili in modo semplice e rapido utilizzando principi di design moderni.

Componenti disponibili

L'esperienza del portale è realizzata utilizzando Angular Material e nelle pagine è possibile utilizzare un insieme limitato di componenti Angular Material, come indicato nella tabella seguente.

Componente Esempio
Pulsanti Il seguente codice crea un pulsante rettangolare con elevazione.
<a mat-raised-button
   href="quickstart">
   Quick Start
</a>

Il seguente codice crea un pulsante circolare con uno sfondo trasparente che include l'icona di avviso. Il colore del pulsante è definito utilizzando la tavolozza dei colori di avviso.

<button mat-icon-button
   color="warn">
   <mat-icon aria-label="Example warning">warning</mat-icon>
</button>

Carta Il seguente codice crea una scheda. La scheda include componenti di pulsanti e icone, nonché testo di intestazione e corpo. Il colore del pulsante è definito utilizzando la tavolozza dei colori principali.

<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>
Icona Il seguente codice crea un'icona a forma di spunta. Per un elenco completo delle icone supportate, consulta Material Design - Icons.
<mat-icon>
   check_circle
</mat-icon>
Barra degli strumenti Il seguente codice crea una semplice barra degli strumenti con testo e un'icona del carrello degli acquisti.
<mat-toolbar color="primary">
   <span>My Store</span>
   <span class="space-buffer"></span>
   <mat-icon>add_shopping</mat-icon>
</mat-toolbar>

Gestire la visibilità di una pagina nel portale

La gestione della visibilità di una pagina nel portale è descritta in Gestire la visibilità di una pagina nel portale.

Visualizzazione dell'anteprima dei contenuti del portale

Per visualizzare l'anteprima dei contenuti del portale:

  1. Accedi all'editor di pagine come descritto in Gestione delle pagine del portale.
  2. Visualizza l'anteprima della pagina.

    Interfaccia utente di Cloud Console

    1. Fai clic su Salva.
    2. Fai clic su Anteprima.

    Interfaccia utente classica

    1. Fai clic su Anteprima nella barra degli strumenti dell'editor di pagine.
    2. Esplora le altre pagine del tuo portale per visualizzare l'anteprima dei contenuti, se vuoi.

Pubblicazione dei contenuti del portale

La pubblicazione e la disattivazione dei contenuti del portale sono descritte in Pubblicazione dei contenuti del portale.

Eliminazione di una pagina

L'eliminazione delle pagine dal portale è descritta in Eliminare pagine dal portale.