Le pagine di benvenuto vengono utilizzate per consentire agli utenti di acquisire dimestichezza con un determinato aspetto del workbench.
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
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:
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.
pluginId (l'identificativo del plug-in che contiene l'azione)
class (il nome completo della classe action da utilizzare ed eseguire)
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>