Formato XML del file del contenuto pagina di aiuto composto

org.eclipse.ui.cheatsheets.composite_schema

3.2

La definizione di schema per il file di contenuto di una pagina di aiuto mista. Una pagina di aiuto mista consiste in una serie di attività organizzate in gruppi. Ciascuna attività può essere una pagina di aiuto semplice o un tipo di attività aggiunta dall'utente.

<!ELEMENT compositeCheatsheet (taskGroup | task)>

<!ATTLIST compositeCheatsheet

name  CDATA #REQUIRED>

L'elemento principale della pagina di aiuto mista



<!ELEMENT taskGroup ((task | taskGroup) , intro? , onCompletion? , dependency*)>

<!ATTLIST taskGroup

kind CDATA "set"

name CDATA #REQUIRED

id   CDATA #IMPLIED

skip (true | false) "false">

Il gruppo di attività rappresenta una raccolta di attività correlate. Se il tipo è "choice", sarà necessario completare solo una delle attività secondarie. Se il tipo è "set" o "sequence", dovranno essere completate tutte le attività secondarie.



<!ELEMENT task (intro? , onCompletion? , param* , dependency*)>

<!ATTLIST task

kind CDATA #REQUIRED

name CDATA #REQUIRED

id   CDATA #IMPLIED

skip (true | false) "false">

Un'attività secondaria in una pagina di aiuto mista. L'attività non ha elementi secondari, ma ha un editor di attività che viene mostrato nel riquadro in basso a destra della pagina di aiuto. Il tipo di attività determina quale editor verrà aperto, "cheatsheet" rappresenta una pagina di aiuto semplice. È possibile aggiungere altri tipi di attività.



<!ELEMENT param EMPTY>

<!ATTLIST param

name  CDATA #REQUIRED

value CDATA #REQUIRED>

Il parametro di un'attività in una pagina di aiuto mista. Ciascun parametro ha un nome ed un valore, entrambi stringhe. Un'attività può avere qualsiasi numero di parametri, due parametri di una singola attività non possono avere lo stesso nome.



<!ELEMENT intro (#PCDATA)>

Contiene il testo che verrà visualizzato prima dell'avvio dell'attività. Potrebbe contenere markup di testo.



<!ELEMENT onCompletion (#PCDATA)>

Contiene il testo che verrà visualizzato al completamento del pannello di questa attività. Potrebbe contenere markup di testo.



<!ELEMENT dependency EMPTY>

<!ATTLIST dependency

task CDATA #REQUIRED>

Crea una dipendenza tra due attività o attività secondarie.