Modificare il contenuto e il layout delle pagine nel portale per sviluppatori in Gestione API di AzureModify the content and layout of pages on the developer portal in Azure API Management

Per personalizzare il portale per sviluppatori in Gestione API di Azure ci sono tre modalità principali:There are three fundamental ways to customize the developer portal in Azure API Management:

Struttura delle pagine del portale per sviluppatori Structure of developer portal pages

Il portale per sviluppatori è basato su un sistema di gestione dei contenuti.The developer portal is based on a content management system. Il layout delle pagine viene creato in base al set di elementi di pagine di piccole dimensioni noto come widget:The layout of every page is built based on set of small page elements known as widgets:

Struttura della pagina del portale per sviluppatori

Tutti i widget sono modificabili.All widgets are editable.

  • I contenuti principali specifici per ogni singola pagina si trovano nel widget "Contenuto".The core contents specific to each individual page reside in the "Contents" widget. La modifica di una pagina comporta la modifica del contenuto di questo widget.Editing a page means editing the contents of this widget.
  • Tutti gli elementi di layout della pagina sono contenuti negli altri widget.All page layout elements are contained with the remaining widgets. Le modifiche apportate a questi widget verranno applicate a tutte le pagine.Changes made to these widgets will apply to all pages. Si farà riferimento a questi con il termine "widget di layout".They will be referred to as "layout widgets".

Nella modifica quotidiana di una pagina in genere viene modificato solo il widget Contenuto che avrà un contenuto diverso per ogni pagina.In day-to-day page editing one usually only modifies the Content widget which will have different content for each individual page.

Modifica dei contenuti di un widget di layout Modifying the contents of a layout widget

È possibile modificare il contenuto nel portale per sviluppatori tramite il portale di pubblicazione, accessibile tramite il Portale di Azure.Content within the developer portal is modified via the publisher portal which is accessible from the Azure Portal. Per accedervi, fare clic su Publisher portal (Portale di pubblicazione) nella barra degli strumenti del servizio dell'istanza di Gestione API.To reach it, click Publisher portal from the service toolbar of your API Management instance.

Portale di pubblicazione

Per modificare i contenuti del widget, fare clic su Widget dal menu Portale per sviluppatori a sinistra.To edit the contents of that widget, click Widgets from the Developer Portal menu on the left. In questo esempio verranno modificati i contenuti del widget Intestazione.For this example lets modify the contents of the Header widget. Selezionare il widget Intestazione dall'elenco.Select the Header widget from the list.

Widget Intestazione

I contenuti dell'intestazione sono modificabili dal campo Corpo .The contents of the header is editable from within the Body field. Modificare il testo come desiderato e quindi fare clic su Salva nella parte inferiore della pagina.Change the text as desired and then click Save at the bottom of the page.

A questo punto, la nuova intestazione dovrebbe essere visualizzata in ogni pagina del portale per sviluppatori.Now you should be able to see the new header on every page within the developer portal.

Per aprire il portale per sviluppatori dal portale di pubblicazione, fare clic sull'opzione corrispondente sulla barra superiore.To open the developer portal while in the publisher portal, click Developer portal in the top bar.

Modificare i contenuti di una pagina Edit the contents of a page

Per visualizzare l'elenco di tutte le pagine di contenuto esistenti, nel portale di pubblicazione scegliere Contenuto dal menu Portale per sviluppatori.To see the list of all existing content pages, click Content from the Developer portal menu in the publisher portal.

Gestione del contenuto

Fare clic nella pagina di benvenuto per modificare gli elementi visualizzati nella home page del portale per sviluppatori.Click the Welcome page to edit what is displayed on the home page of the developer portal. Apportare le modifiche desiderate, visualizzarle in anteprima, se necessario, e quindi fare clic su Pubblica per renderle visibili a tutti.Make the changes you want, preview them if necessary, and then click Publish Now to make them visible to everyone.

Per la home page viene usato un layout speciale che consente di visualizzare un banner nella parte superiore.The home page uses a special layout that allows it to display a banner at the top. Questo banner non è modificabile dalla sezione Contenuto .This banner is not editable from the Content section. Per modificare il banner, scegliere Widget dal menu Portale per sviluppatori, selezionare Home page dall'elenco a discesa Current Layer (Livello corrente) e quindi aprire l'elemento Banner nella sezione Featured section (In primo piano).To edit this banner, click Widgets from the Developer portal menu, select Home page from the Current Layer drop-down list, and then open the Banner item under the Featured section. I contenuti di questo banner sono modificabili come quelli di ogni altra pagina.The contents of this widget are editable just like any other page.

Passaggi successivi Next steps