Sviluppare i contenuti del portale utilizzando l'editor di pagine

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Utilizzando l'editor di pagine, definisci i contenuti del 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 di pagine, come descritto in Gestire le pagine nel portale.

Editor della pagina

Come evidenziato nella figura precedente, l'editor di pagine consente di:

Modifica dei contenuti nell'editor di pagine

Markdown è un linguaggio di formattazione semplice che utilizza un markup di testo normale facile da leggere e scrivere. La sua sintassi è specificata utilizzando caratteri di punteggiatura. 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 i formati (come grassetto, corsivo e così via) o inserire i tag Markdown (come elenchi, immagini, link e così via). Per un rapido riepilogo della sintassi Markdown, fai clic su Icona Markdown nella barra degli strumenti di modifica rapida per visualizzare il Riferimento rapido per la sintassi Markdown.

Per annullare o ripetere l'ultima modifica, premi rispettivamente Comando+z o Comando+Shift+z.

Markdown è consigliato se vuoi mantenere un flusso di lavoro di formattazione semplice. Tuttavia, non è destinata a sostituire il codice HTML. Nel codice HTML è disponibile un'ampia gamma di operazioni di formattazione che non puoi eseguire in Markdown. Ad esempio, puoi specificare una classe CSS per un elemento in HTML; non puoi farlo in Markdown: 

   <p class="class1">

Puoi inserire il codice 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

Angular Material fornisce una libreria di componenti UI all'avanguardia. I componenti di Angular Material consentono di creare in modo facile e veloce un'interfaccia utente coerente, adattabile e accessibile utilizzando principi di progettazione moderni.

Componenti disponibili

L'esperienza del portale viene creata utilizzando Angular Material e nelle pagine è possibile usare un insieme limitato di componenti Angular Material, di cui puoi trovare un riepilogo nella tabella seguente.

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

Il codice seguente crea un pulsante circolare con uno sfondo trasparente che include l'icona di avviso. Il colore del pulsante viene 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 carta. La scheda include componenti pulsante e icona, nonché intestazione e corpo del testo. Il colore del pulsante viene definito utilizzando la tavolozza dei colori principale.

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

Gestione della visibilità di una pagina nel portale

Gestisci la visibilità di una pagina nel tuo portale consentendo l'accesso a:

Per gestire la visibilità di una pagina nel tuo portale:

  1. Fai clic su Gestisci accanto al segmento di pubblico nel riquadro a destra dell'editor della pagina.
  2. Seleziona l'impostazione di visibilità. Se hai eseguito la registrazione alla release beta della funzionalità Segmenti di pubblico, seleziona una delle seguenti opzioni:
    • Pubblica (visibile a tutti) per consentire a tutti gli utenti di visualizzare la pagina.
    • Utenti autenticati per consentire solo agli utenti registrati di visualizzare la pagina.
    • Segmenti di pubblico selezionati per scegliere i segmenti di pubblico specifici che vuoi che possano visualizzare la pagina. Consulta Gestire i segmenti di pubblico per il portale.
      Per gestire i segmenti di pubblico, fai clic su Crea o modifica segmenti di pubblico.

    Altrimenti, seleziona una delle seguenti opzioni:
    • Utenti anonimi per consentire a tutti gli utenti di visualizzare la pagina.
    • Utenti registrati per consentire solo agli utenti registrati di visualizzare la pagina.
  3. Fai clic su Applica.

Anteprima dei contenuti del portale

Per visualizzare l'anteprima dei contenuti del portale, fai clic su Anteprima nella barra degli strumenti dell'editor di pagine. Spostati tra le altre pagine del portale per visualizzare l'anteprima dei contenuti, come preferisci.

Pubblicazione dei contenuti del portale

Per pubblicare contenuti del portale, fai clic su Pubblica nel riquadro a destra. Per annullare la pubblicazione dei contenuti del portale, fai clic su Annulla pubblicazione nel riquadro a destra. Vedi anche Pubblicazione di contenuti del portale.

Eliminazione di una pagina

Per eliminare una pagina dall'editor del portale, fai clic su Elimina nel riquadro a destra dell'editor della pagina. Viene richiesto di confermare l'operazione.