Pagine di benvenuto

Le pagine di benvenuto vengono utilizzate per consentire agli utenti di acquisire dimestichezza con un determinato aspetto del workbench.

Pagina di benvenuto predefinita

Ogni funzione può fornire una pagina di benvenuto. Questa operazione viene eseguita includendo l'attributo  welcomePage nel file about.ini situato nella sottodirectory del plug-in di appartenenza della funzione.

welcomePage = $nl$/welcome.xml

Il valore dell'attributo welcomePage è un file di tipo XML che definisce la pagina di benvenuto.
Il file ha il seguente formato:

tag <welcomePage> con 

  1. un attributo title facoltativo
  2. un attributo format facoltativo
  3. un tag <intro> facoltativo
  4. 0 o più tag <item>

Il tag format può assumere il valore "wrap" o "nowrap". Se l'attributo format è "wrap", il testo dell'editor di benvenuto sarà riportato a capo per adattarsi alla dimensione della finestra. Si noti che le interruzioni di riga nel testo saranno mantenute quando si riporta a capo il testo, a meno che siano stati usati tag di paragrafo (<p>). Se non viene specificato l'attributo format, sarà utilizzato il valore predefinito "nowrap".

I tag intro e item possono contenere:

  1. Testo (rispettando l'interruzione di riga)
  2. Tag di paragrafo (<p>) per indicare quale parte del testo deve essere riportata a capo.

    Il testo tra i tag <p> sarà considerato come riga continua (ovvero, le interruzioni di riga all'interno del testo <p> saranno "soft"). Il tag <p> si applica solo se format = "wrap". Se format = "nowrap", i tag di paragrafo saranno ignorati.

  3. Tag per il grassetto (<b>)
  4. Tag di azione (<action>) che possono contenere i seguenti attributi:

    pluginId (l'identificativo del plug-in che contiene l'azione)

    class (il nome completo della classe action da utilizzare ed eseguire)

  5. Tag di argomento della guida (<topic>) che contiene i seguenti attributi:

    id (l'identificativo dell'infoset da mostrare nel visualizzatore della guida)

    href (facoltativo; un URL di argomento della guida valido contenuto nell'infoSet specificato con il seguente formato:  
    /pluginID/path_to_document
    )

Il testo compreso tra i tag di inizio e di fine relativi alle azioni e agli argomenti della guida verrà visualizzato come un collegamento evidenziato.

Di seguito è riportato un esempio di pagina di benvenuto. Il testo della seconda voce sarà riportato a capo.

<?xml version="1.0" encoding="UTF-8" ?>
<welcomePage 
    title="Piattaforma Eclipse"
    format = "wrap">

<intro>Questa pagina consente all'utente di acquisire dimestichezza con il workbench Eclipse.
Per iniziare, leggere le sezioni di seguito riportate e fare clic sui collegamenti correlati. </intro>

<item><b>Funzioni installate </b>
Per ulteriori informazioni sulle funzioni installate nel workbench, scegliere
<action pluginId="org.eclipse.ui"
   class="org.eclipse.ui.internal.QuickStartAction">Help > Welcome...</action>
e selezionare la funzione desiderata.</item>

<item><b>Prospettive, viste ed editor </b>
<p>Una finestra contiene una o più prospettive. Una prospettiva è formata da viste
(ad esempio Selezione)
ed editor che consentono di gestire le risorse.
La barra dei collegamenti situata nella parte superiore sinistra della finestra consente di aprire nuove prospettive e di spostarsi
tra le prospettive già aperte. La prospettiva corrente
è indicata nel titolo della finestra e nella barra dei collegamenti come
un'icona di tipo push.</p></item>

<item><b>Configurazione delle prospettive</b>
Viste ed editor possono essere spostati nel workbench trascinando le
rispettive barre dei titoli. È inoltre possibile
aggiungere più viste alla prospettiva corrente utilizzando Finestra > Mostra
vista.
Per reimpostare la prospettiva sul suo stato originale, selezionare
<action pluginId="org.eclipse.ui"
   class="org.eclipse.ui.internal.ResetPerspectiveAction">Window > Reset Perspective</action>.
Al termine della sua disposizione, è possibile salvare la prospettiva mediante Finestra > Salva prospettiva con nome....
È possibile personalizzare le viste, le prospettive e le operazioni del menu Nuovo visualizzate per
la prospettiva. A tale scopo, scegliere
<action pluginId="org.eclipse.ui"
   class="org.eclipse.ui.internal.EditActionSetsAction">Window > Customize Perspective...</action> .
È inoltre possibile convertire una vista in una vista ad
accesso rapido trascinandola nella barra dei collegamenti rapidi (all'estrema sinistra
della finestra). </item>

<item><b>Ulteriori informazioni </b>
Per ulteriori informazioni, è possibile sfogliare il
<topic id="/org.eclipse.platform.doc.user/toc.xml">Guida per l'utente del workbench</topic>.</item>

</welcomePage>

Copyright IBM Corp. e altri 2000, 2002.