Reference
Il tipo di argomento DITA Reference descrive le funzioni normali di un argomento o prodotto, quali i comandi di un linguaggio di programmazione o di un'API (Application Programming Interface). Gli argomenti DITA Reference possono fornire informazioni su qualsiasi tema che presenti contenuti regolari, quali ricette, cataloghi, bibliografie e informazioni descrittive strutturate in modo simile.
Un argomento Reference contiene i seguenti tag principali:
• reference - Contiene tutti gli altri tag
• title - Oggetto dell'argomento
• shortdesc - Breve descrizione o panoramica dell'argomento
• prolog - Diversi tipi di metadati relativi all'argomento, ad esempio autore, copyright, termini di indice e così via
• refbody - Contiene il contenuto effettivo dell'argomento
Un argomento Reference è in genere suddiviso in una o più sezioni, tabelle ed elenchi che è possibile disporre nell'ordine desiderato. Di seguito sono riportati i tag principali contenuti nel corpo di un argomento Reference:
◦ section - Contenitore per il contenuto che si desidera raggruppare in un riferimento
◦ refsyn - Sintassi o informazioni simili
◦ properties - Elenco di proprietà associate all'oggetto del riferimento, in genere presentato sotto forma di tabella
◦ example - Esempi che illustrano o supportano le informazioni sul riferimento
Il tag refbody può anche contenere le tabelle DITA standard.
• related-links - Contiene link con riferimenti incrociati a informazioni correlate
La maggior parte dei tag sono opzionali, pertanto vengono utilizzati solo quelli necessari per creare l'argomento.