Le prime righe del documento iimpostano l'ambiente latex e richiamano la classe arbook e il package armanual. La lingua viene stabilita in base a quanto indicato sul documento dtd=man, altrimenti si utilizza il default indicato dalla variabile di environment darlang (v. Variabili di Environment Dati). Si crea il frontespizio con il titolo del manuale, la lista degli autori, le date e il copyright.
\documentclass[italian,twoside]{arbook}
\usepackage{armanual}
\begin{document}
\selectlanguage{italian}
\InitManualTitle{Sistema di Documentazione}{Franco~Radice, John~Peter~Arnold}
{John~Peter~ Arnold}{14-06-2000}{13-05-1999}{21-03-2001}{man.dar.sgml}
|
Se è prevista una premesse questa viene inserita in questo punto:
\InitManualPreface
% UnkTexEmitter(man.dar) from n:\ardoc\dar\db\man.dar.sgml
\label{man.dar}%
\ArP{Il sistema di documentazione \ArSc{dar} è stato sviluppato internamente ...}
|
In base ai parametri richiesti vengono generati indice, indice delle tabelle, e indice delle figure.
\InitManualContents
\InitManualLoT
\InitManualLoF
|
Infine viene aperto il corpo del manuale. La numerazione della pagine passa da numeri romani a numeri arabici.
Nell'esempio che segue vediamo:
- Un titolo di una parte.
- Un titolo di capitolo.
- Un commento di ManexEmitter che referenzia il documento originale.
- Un titolo di sezione.
- Una label derivata dal nome del documento. Queste label servono per traformare i riferimenti di un documento in numeri di pagina.
- Un paragrafo normale. All'interno di questo viene agganciata un'immagine tramite la macro ArImgFloat.
- Un secondo paragrafo normale.
- Una lista di due elementi.
\part[Disegno Tecnico]{Disegno Tecnico}
\chapter[Configurazione del Sistema]{Configurazione del Sistema}
% ManTexEmitter(DST.41E0S7I) from n:\ardoc\dar\db\DST.41E0S7I.sgml
\section[Configurazione del Sistema]{Configurazione del Sistema}
\label{dst.41e0s7i}%
\ArP{Il sistema Dar da due gruppi di componenti.
\ArImgFloat{76}{56}{../../../db/gif/dst.config.eps}{Configurazione del sistema}%
Il primo gruppo è costituito dai tools e dagli eseguibili del sistema. Il secondo gruppo
è costituito dai dati di ciascun data base \ArSc{dar}.}
\ArP{Gli eseguibili del sistema comprendono:}
\begin{ArUl}
\ArItem{Un \ArSc{db} template \ArSc{notes}.}
\ArItem{h1 \ArLnkP{}{dst}{41e0s7j}{Directory dei Tools}}
\end{ArUl}
|
I documenti tecnici, ad esempio i job utilizzano della macro latex Specializzate, come si vede nell'esempio che segue:
% JobTexEmitter(job.Notes2Printer) from n:\ardoc\dar\db\job.notes2printer.sgml
\ArTecHeader{Notes2Printer}{Stampa da Notes di un Set di Documenti}
\label{job.notes2printer}%
\ArJobInit%
\ArJobRow{Tipo App}{BPrint -- Stampa e Formattazione Output}%
\ArTecInitDscLunga{Descrizione}%
\ArPns{Questo job viene invocato da Notes. L'utente selezione ... }
\ArJobEnd%
|
Infine l'intero documento viene chiuso:
e-mail