Debian GNU/Linux Reference Guide
Prev	Home	Next

13.9.2 SGML

Preparazione:

     # apt-get install debiandoc-sgml debiandoc-sgml-doc

Riferimenti per debiandoc-sgml:

• /usr/share/doc/debiandoc-sgml-doc

• debiandoc-sgml(1)

• DocBook: The Definitive Guide, di Walsh and Muellner (O'Reilly) (pacchetto docbook-defguide)

SGML permette la gestione dei formati multipli dei documenti. Un sistema SGML semplice � Debiandoc, utilizzato qui. Richiede delle conversioni minori dai file di testo originali per i seguenti

• "<" --> &lt;

• ">" --> &gt;

• " " --> &nbsp; (spazio non divisibile)

• "&" --> &amp;

• "%" --> &percnt;

• "©" --> &copy;

• "–" --> &ndash;

• "—" --> &mdash;

Per marcare una sezione come commento non stampabile, date:

     <!-- Il commento va qui ... -->

Per marcare una sezione con un commento modificabile, date:

     <![ %FIXME [ Il commento va qui ... ]]>

In SGML, la prima definizione di un'entit� vince. Per esempio:

     <!entity % qref "INCLUDE"> 
     <![ %qref; [ <!entity param "Data 1"> ]]> 
     <!entity param "Data 2"> 
     &param;

Questa termina come "Data 1". Se la prima riga �, invece, "IGNORE", questa terminer� come "Data 2" (La seconda riga � un'affermazione condizionale). Anche le frasi ripetute possono essere definite a priori, separatamente dal contesto.

     <!entity dichi�questo "mio">
     Ciao amico &dichi�questo;.
     Questo � il &dichi�questo; libro.

Che d� ci� come risultato:

     Ciao amico mio.
     Questo � il mio libro.

Vedere il breve esempio in SGML sample.sgml in esempi.

Quando i documenti SGML diventano voluminosi, talvolta TeX pu� dare degli errori. Vedere TeX/LaTeX, Sezione 13.9.3.

---

Debian GNU/Linux Reference Guide
Prev	Home	Next