Linuxdoc Reference

Un'introduzione al dtd di linuxdoc

Uwe Böhme, <uwe@hof.baynet.de>

v1.1, 30 Gennaio 2000

Questo testo è destinato ad essere una guida di riferimento per la definizione del tipo di documento (dtd) di SGML linuxdoc, fornito insieme al sistema di formattazione testi SGML versione 1.0. Dovrebbe essere valido anche per versioni successive, che possono essere trovate presso la mia homepage. Traduzione e adattamenti in italiano a cura di Hugh Hartmann hhartmann@libero.it e Vieri Giugni v.giugni@gmail.com, revisione a cura di Elisabetta Galli lab@kkk.it

1. Dietro le quinte

2. Introduzione

3. Un documento minimale

4. Classi di documento

5. Inline

6. Creare le sezioni

7. Paragrafi

8. I tag Inline

9. Formule matematiche

10. Etichette e riferimenti

11. Indici

11.1 Includere un indice analitico

12. Programmazione istruita

13. Bibliografia

Appendix

14. Simboli speciali

15. Figure matematiche

16. Il dtd di Linuxdoc per il sorgente

1. Dietro le quinte

1.1 Aspetti Legali

Copyright © 1997-2000 by Uwe Böhme. This document may be distributed under the terms set forth in the Linux Documentation Project License at LDP. Please contact the authors if you are unable to get the license. This is free documentation. It is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.

Questo documento non fa parte di ldp (anche se è stato usato il loro tipo di licenza). Ancora non ne faccio parte.

1.2 Genesi

Questo documento nasce dal tentativo di imparare di più sulla scrittura di testi su un sistema Linux. L'unico sistema che sembrava adatto alle mie necessità era sgml-tools l'organizzazione SGML-Tools e il linuxdoc dtd.

Nella [SGML-Tools Guida dell'Utente 1.0 ($Revision: 1.1 $)] (vedere la sezione Riferimenti) la struttura generale è descritta in modo facile e piacevole. Anche [Esempi rapidi di SGML, v1.0] (vedere la sezione Riferimenti) è stata utile, ma:

Molte caratteristiche non sono menzionate.

Cercando di imparare di più, ho incontrato la [Definizione del tipo di documento qwertz] (vedere la sezione Riferimenti). È dettagliata come speravo, ma non è pensata per il di linuxdoc (anche se linuxdoc è basato su qwertz).

Ho tentato un nuovo approccio: osservare il file stesso dtd

dtd = definizione del tipo di documento

, e tentare di comprenderlo.

Con il passare del tempo ho notato di essermi dimenticato alcune cose o, almeno, di non averle fatte notare abbastanza. Questo cambierà con la prossima revisione.

Ogni commento sarà il benvenuto (in particolare ogni aiuto con l'ortografia o la grammatica inglese) via e-mail, all'indirizzo Uwe Böhme.

2. Introduzione

Il principio di ogni documento sgml (linuxdoc, docbook, html) è più o meno lo stesso:

Non scrivere come dovrebbe apparire, ma scrivere cos'è.

Questo è un approccio diverso rispetto allo standard "wysiwyg"

Quello che si vede è quello che (forse) si ottiene (se si ha molta fortuna e il proprio computer vince la guerra contro il software bacato)

one

Si potrebbe chiamarlo per esempio wysiwym, cio\ "What you see is what you mean" (quello che si vede è quello che significa)

. Non si dice al programma che questa riga dovrebbe essere scritta in un carattere più grande, per apparire come un titolo. Ciò che si fa è dire che questa riga è un titolo. Non si tenta di far apparire il proprio documento come se fosse un report, ma lo si etichetta per essere un report. Così si etichetta il testo con il <tag> adatto.

I grandi vantaggi di questo approccio sono:

Non è necessario pasticciare con impostazione dei font, interlinee o altre cose connesse direttamente al layout
Si descrive il proprio documento in modo più astratto, così che sia maggiormente riutilizzabile e possa essere mappato in diversi tipi di supporti.
Se si è già tentato di riutilizzare un documento scritto in un layout wysiwy specalizzato in html allora si sa già di cosa si sta parlando.

In aggiunta, in tutti i documenti in stile sgml si potranno trovare i simboli speciali. Questo è un concetto di espansione del set di caratteri del documento per evitare inconsistenze nelle decisioni dell'analizzatore, nell'interpretazione o mappatura di alcuni caratteri speciali.

Come potrebbe l'analizzatore sapere se un carattere < indica l'inizio di un tag o se deve essere stampato direttamente? Questo problema viene risolto dal carattere nominato lt. Scrivendo < si otterrà < nel proprio testo. Per un elenco dei simboli speciali vedere Simboli speciali.

Suggerimento per il nuovo utente: Potrebbe essere una buona idea scaricare questo documento non solo come documento dvi o ps, ma scaricare anche il sorgente sgml. Questo darà la possibilità di osservare i sorgenti: si potrebbe trovare in questo articolo qualcosa di adatto alle proprie necessità.

3. Un documento minimale

In questa sezione si troverà ciò di cui si avrà bisogno per creare un documento minimale conforme al dtd di linuxdoc. Vuole essere un primo contatto. Si può saltare questa sezione, se si conoscono già i fondamenti.

3.1 Passo dopo passo

I passi da fare per creare un grazioso documento linuxdoc e mapparlo nella forma desiderata sono:

Scegliere un semplice editor di testo a piacimento.
Creare un file e dargli un nome (o salvarlo successivamente), per esempio iniziare.sgml.
Scrivere il documento
Salvare il file e chiudere l'editor.
Eseguire il correttore digitando sgmlcheck iniziare.sgml.
Se vengono restituiti degli errori, riaprire nuovamente il documento nell'editor e provare a correggerlo.
I messaggi di errore di sgmlcheck daranno un suggerimento sul tipo di errore, insieme alla riga e alla colonna in cui è avvenuto.
Eseguire nuovamente il correttore finché non si otterranno più errori.

Ora si deve decidere a cosa serve il documento. Prendere la corretta combinazione di mappatore e analizzatore e tradurre il documento. Per trovare i mappatori disponibili negli "SGML-Tools", vedere la tabella Mappatori di SGML-Tools per documenti sgml.

digitare	per ottenere

`sgml2html start.sgml`	Linguaggio di markup di ipertesti per browser web
`sgml2lyx start.sgml`	Formato di testo Lyx o KLyx WYSIWYG
`sgml2info start.sgml`	Pagina info per UN*X info
`sgml2latex start.sgml`	Output DVI
`sgml2latex --output=tex start.sgml`	Output in puro tex
`sgml2latex --output=ps start.sgml`	Output postscript
`sgml2rtf start.sgml`	Formato rich text
`sgml2txt start.sgml`	Puro testo

Mappatori di SGML-Tools per documenti sgml

3.2 Un documento per iniziare

Si inizierà con un semplice documento (i numeri e i due punti all'inizio della riga sono solo esplicativi, non vanno digitati):

1: <!doctype linuxdoc system>
2: <notes>
3: <title>Un piccolo esempio di Linuxdoc</title>
4: <p>Ciao <em>mondo</em>.</p>
5: <p><bf>Ci</bf> siamo.</p>
6: </notes>

Ora si darà un'occhiata alle singole righe:

Un documento linuxdoc deve iniziare, come tutti i documenti conformi allo SGML, con il preambolo. Volendo si può considerarlo come un necessario pezzo di magia, o si può provare a trovare maggiori informazioni riguardo SGML. Il preambolo indica all'analizzatore SGML quale dtd (definizione del tipo di documento) usare per verificare la sintassi del documento.
Si apra la classe di documento: si deve decidere quale tipo di documento si vuole scrivere. Vedere la sezione Classi di documento per una descrizione dettagliata riguardo le classi di documento. Le necessarie informazioni di intestazione, che dipendono dalla classe di documento, vengono spiegate in questa sezione. Nel nostro caso useremo un tag <notes>, che crea una nota indicante un semplice documento non strutturato.
Anche se non è indispensabile, è una buona idea fornire un titolo al documento. Per farlo si usa il tag <title> .
Un paragrafo marcato con il tag <p>, contenente la parola mondo che è testo inline enfatizzato dal tag <em>.
Un altro paragrafo totalmente marcato, con un'altra parola inline e resa in grassetto tramite il tag <bf>.
Qui viene chiuso il tag classe di documento aperto.

Lo stesso esempio può essere scritto più brevemente eliminando i tag automaticamente posizionati dall'analizzatore, e utilizzando tag abbreviati:

1: <!doctype linuxdoc system>
2: <notes>
3: <title>Un piccolo esempio Linuxdoc
4: <p>Ciao <em/mondo/.
5:
6: <Ci bf/siamo/.
7: </notes>

Ora rivediamo ogni singola riga:

Il preambolo.
La classe del documento (anch'essa invariata).
Il titolo. Non è chiuso, perchè il tag p nella riga successiva lo chiude implicitamente.
Il paragrafo chiude implicitamente il titolo. Il tag emphasize è indicato in forma abbreviata. La notazione breve si può utilizzare solo se il testo nel tag non contiene il carattere /. Il paragrafo non è chiuso esplicitamente in questa riga.
La riga vuota in questo punto è il motivo per cui non è necessario chiudere il precedente paragrafo e aprire il prossimo. Una riga vuota viene interpretata come la fine del paragrafo attuale, e l'inizio di uno nuovo.
Un altro paragrafo (non aperto direttamente), con un altro tag abbreviato inline.
Chiusura del tag classe di documento aperto, che a sua volta chiude implicitamente anche il paragrafo ancora aperto.

Ora lavorare con i tag dovrebbe essere un pò più chiaro.

4. Classi di documento

<!element linuxdoc o o 
        (sect | chapt | article | report | 
         book | letter | telefax | slides | notes | manpage ) >

Descrive complessivamente la classe del documento, e naturalmente (lasciando stare la definizione doctype) deve essere il primo tag e racchiudere l'intero documento. Alcuni dei tag, cioè sect e chapt (vedere la sezione Creare le sezioni) non hanno alcun senso presi singolarmente, nonostante siano inclusi come parti di classi di documento più, complete: dunque saranno descritti successivamente come parte di altre classi di documento. È meglio decidere prima quale delle classi di documento menzionate sopra è adatta al tipo di documento che si vuole scrivere.

Per una dettagliata descrizione delle classi di documento vedere la tabella Classi di documento.

Capitolo	Tag della classe

Tag per l'articolo	`<atricle>`
Tag per il report	`<report>`
Tag per il libro	`<book>`
Tag per la lettera	`<letter>`
Tag per il telefax	`<telefax>`
Tag per le slide	`<slides>`
Tag per le note	`<notes>`
Tag per le pagine di manuale	`<manpage>`

Classi di documento

Per me la classe article è la piùimportante, ecco perché è descritta per prima e molto dettagliatamente.

4.1 Il tag Article

<!element article - -
        (titlepag, header?,
         toc?, lof?, lot?, p*, sect*,
         (appendix, sect+)?, biblio?) +(footnote)>

<!attlist article
        opts cdata "null">

Come si può vedere, il tag article necessita l'inclusione di alcuni tag, che verranno di seguito spiegati.

L'attributo options (opts) accetta un elenco separato da virgole di differenti fogli di stile (LaTeX .sty) da includere nel documento.

Il tag Titlepage

<!element titlepag o o (title, author, date?, abstract?)>

Il tag Titlepage (titlepag) è implicitamente inserito all'inizio della propria classe di documento . Non è necessario scriverlo esplicitamente. Si noti comunque che il tag è obbligatorio. Il suo scopo è quello di descrivere l'impaginazione e gli elementi dei titoli delle pagine.

Il tag Title

<!element title - o (%inline, subtitle?) +(newline)>

Ogni classe di documento con un proprio titolo di pagina certamente necessiterà di un titolo, denotato da un tag <title>. Non è necessario chiuderlo. Un titolo può contenere un sottotitolo che inizia con il tag <subtitle>.

Se si osserva l'intestazione di questo documento si vedrà che è mappato dai tag:

<title>Linuxdoc Reference
<subtitle>Un'introduzione al dtd di linuxdoc

Il tag Author

<!element author - o (name, thanks?, inst?,
                        (and, name, thanks?, inst?)*)>

Solitamente qui si mette il (proprio) nome. La gente dovrebbe sapere chi ha scritto il documento, per questo si mette un tag <author>. Se non lo si annota, il tag name è inserito implicitamente. L'autore ha anche degli elementi opzionali che possono essere etichettati all'interno del tag author.

Se si desidera fare dei ringraziamenti a qualcuno (potrebbe essere qualcuno che ha fornito delle informazioni utili), inserirlo all'interno del tag <thanks>. Inoltre, se si sta scrivendo il proprio documento come membro dello staff di una istituzione, inserirlo all'interno del tag <inst>.

Il tag <and> ripete le stesse cose, come se si fosse inserito un secondo tag author. Chiaramente serve per i coautori.

Il tag Date

Volendo, si può marcare il proprio documento con una data usando il tag <date>.

Non è possibile verificare la validità della data inserita, quindi meglio non abusare di questo tag.

Il tag Abstract

Questo tag è destinato ad un riassunto della descrizione del proprio documento. Non si confonda il tag <abstract> con l'introduzione, che \ più probabile vada inserita nella prima sezione del proprio documento (vedere la sezione Creare le sezioni).

Il tag Header

<!element header - - (lhead, rhead) >
<!element lhead - o (%inline)>
<!element rhead - o (%inline)>

Un tag <header> specifica cosa dovrebbe essere stampato nella parte più alta di ogni pagina. Esso consiste di una intestazione sinistra cioè <lhead> e una intestazione destra cioè <rhead>). Entrambi gli elementi sono obbligatori se si usa un'intestazione, ma possono essere lasciati vuoti: in questo modo si puo' facilmente ottenere l'effetto di avere solo un'intestazione sinistra o solo un'intestazione destra.

Come si vedrà, l'intestazione iniziale può essere inserita dopo il titolo della pagina. In seguito può essere aggiunta una nuova intestazione per ogni nuovo capitolo o sezione. L'intestazione stampata su una pagina è quella che ha effetto alla fine della pagina attuale. In questo modo l'intestazione sarà quella dell'ultima sezione della pagina.

Il tag Table Of Contents

Usando il tag <toc>, verrà generato un indice, osservando l'intestazione della sezione e aggiungendo i riferimenti.

In un documento con collegamenti ipertestuali si vedranno i collegamenti, in un documento LaTeX si vedranno i numeri di pagina.

Verranno incluse solo le sezioni superiori alla sect3.

Il tag List Of Figures

Usando il tag <lof>, verrà generato un elenco di illustrazioni, osservando le didascalie delle illustrazioni e aggiungendo i riferimenti.

Il tag List Of Tables

Usando il tag <lot>, verrà generata una lista di tabelle, osservando le didascalie delle tabelle e aggiungendo i riferimenti.

Body

Qui si inseriscono varie sezioni stando a quanto dice la sezione Creare le sezioni. Non c'è un tag body. Il corpo del testo inizia dal primo capitolo, sezione o paragrafo.

Il tag Appendix

Alla fine dell'articolo si può inserire il tag <appendix>

Veramente non e' che la gente (per esempio m.d.s.) vi sbudellerà.

, che apre un'area di sezioni aggiuntive. Il tag appendix implica un tipo di numerazione delle sezioni diverso per i successivi tag di sezione.

Il tag Bibliography

È destinato a raccogliere tutte le <cites> e <ncites> usate all'interno del proprio documento. Il tag <biblio> sarà sostituito da una bibliografia a seconda del tipo di mappatura del documento, a volte tramite collegamenti ipertestuali, a volte tramite numeri di sezione o qualunque cosa possa essere utile.

Fino ad ora non sono stato in grado di creare un file .bbl , dunque non ho potuto verificare.

Il tag Footnote

Una nota a piè di pagina può essere messa in ogni punto del proprio documento. Per la precisione, si dovrebbe piazzare il tag <footnote> nel punto del proprio documento in cui dovrebbe essere visualizzato il testo etichettato. Questo tag dovrebbe essere usato per informazioni aggiuntive, che non sono necessarie per comprendere gli scopi principali del proprio documento ma potrebbero essere utili, interessanti o divertenti.

D'altra parte l'ultima non è sempre vera, anche se ci si prova.

dovunque all'interno dell'articolo.

4.2 Il tag Report

<!element report - -
        (titlepag, header?, toc?, lof?, lot?, p*,
         chapt*, (appendix, chapt+)?, biblio?) +(footnote)>

La classe di documento report ha un approccio orientato al capitolo. Quindi, in un documento classificato con un tag <report> il livello più alto è raggruppato dal tag <chapt> (vedere Creare le sezioni). Il resto della struttura è identico alla classe article Il tag Article.

4.3 Il tag Book

<!element book  - -
        (titlepag, header?, toc?, lof?, lot?, p*, chapt*,
         (appendix, chapt+)?, biblio?) +(footnote) >

Come si può notare, l'elemento book è identico all'elemento report Il tag Report. Quindi quanto detto in precedenza vale anche se si classifica il proprio documento con un tag <book>.

4.4 Il tag Letter

<!entity  % addr "(address?, email?, phone?, fax?)" >

<!element letter - -
        (from, %addr, to, %addr, cc?, subject?, sref?, rref?,
         rdate?, opening, p+, closing, encl?, ps?)>

Anche lo scopo della classe di documento letter dovrebbe essere abbastanza autoesplicativa. Inserire un tag <letter> se si vuole scrivere una lettera.

I tag della lettera sono descritti nella tabella Tag in una lettera

tag	obbligatorio	che cos'è

from	si	mittente
address	no	indirizzo del mittente
email	no	email del mittente
phone	no	telefono del mittente
fax	no	fax del mittente
to	si	destinatario
address	no	indirizzo del destinatario
email	no	email del destinatario
phone	no	telefono del destinatario
fax	no	fax del destinatario
cc	no	copia per conoscenza
subject	no	oggetto della lettera
sref	no	riferimenti del mittente
rref	no	riferimenti del destinatario
rdate	no	data di ricevimento??
opening	si	apertura
paragraphs	si	vedere Paragrafi
closing	si	chiusura
encl	no	allegato
ps	no	post scriptum

Tag in una lettera

4.5 Il tag Telefax

<!element telefax - -
        (from, %addr, to, address, email?,
         phone?, fax, cc?, subject?,
         opening, p+, closing, ps?)>

La struttura globale è la stessa della classe letter. La sola differenza è che con il tag <telefax> il tag del destinatario <fax> diventa obbligatorio.

Il perché dovrebbe essere ovvio.

4.6 Il tag Slides

<!element slides - - (slide*) >

La classe slides è destinata per slide e trasparenze di livello superiore. Quindi la struttura di un documento classificato con un tag <slides> è molto semplice: contiene singole slide che iniziano con un tag <slide>. Niente altro. Se non esplicitamente scritto, il primo tag slide inizia implicitamente.

Il tag Slide

<!element slide - o (title?, p+) >

Un tag <slide> è permesso solo all'interno della classe di documento slides. Una slide può contenere:

Un titolo (vedere la sezione Il tag Title) e uno o più paragrafi (vedere la sezione Paragrafi). Questo è tutto.

4.7 Il tag Note

<!element notes - - (title?, p+) >

È una classe destinata ad appunti personali, la sua struttura è perfino più semplice della classe di documento slides (vedere Il tag Slide). Dopo aver classificato un documento con il tag <notes>, sono permessi solo un titolo (vedere la sezione Il tag Title) e uno o più paragrafi (vedere la sezione Paragrafi).

4.8 Il tag Manual Page

<!element manpage - - (sect1*)
        -(sect2 | f | %mathpar | figure | tabular |
          table | %xref | %thrm )>

Questa classe di documento è destinata alla scrittura di pagine di manuale, ed è adatta alle necessità del programma man. In un documento classificato dal tag <manpage> il tag di sezione di livello più alto è il tag sect1 (vedere la sezione Creare le sezioni), per un facile inserimento di pagine di manuale all'interno di una classe di documento article o book. L'eccezione alla normale creazione di sezioni è che viene permesso un solo livello di sottosezione (sect2).

5. Inline

<!entity % inline
        " (#pcdata | f| x| %emph; |sq| %xref | %index | file )* " >

Inline può trovarsi ovunque dentro il testo, e non ha alcuna influenza sul flusso del testo o sulla struttura logica del documento.

#pcdata: Il parsed character data è semplicemente testo normale all'interno del flusso che può contenere altri inline.
f: Formule matematiche inline secondo il maths.dtd. Vedere Il tag Formula.
x: Il tag external aggira l'analizzatore. I dati nei tag finiscono direttamente nel file mappato. Vedere il capitolo Il tag External per informazioni dettagliate.
%emph;: Enfatizzazione del testo. Vedere il capitolo Enfatizzazione.
sq: Citazioni nel flusso di testo. Vedere il capitolo Il tag Short Quote.
%xref: XRiferimenti nel testo o riferimenti esterni. Vedere il capitolo Etichette e Riferimenti.
%index: Anche questo non lo so spiegare. Se ne sapete di più, scrivetemi.
file: Anche questo non lo so spiegare (posso solo supporre riguardi file di immagine eps). Se ne sapete di più, scrivetemi.

6. Creare le sezioni

<!element chapt - o (%sect, sect*) +(footnote)>
<!element sect  - o (%sect, sect1*) +(footnote)>
<!element sect1 - o (%sect, sect2*)>
<!element sect2 - o (%sect, sect3*)>
<!element sect3 - o (%sect, sect4*)>
<!element sect4 - o (%sect)>

La creazione di sezioni

Anche il tag chapt è un tag che crea sezioni.

si ottiene tramite elementi concordi che formano l'albero delle sezioni. Servono a unire i vari paragrafi del nostro documento, formando un grazioso albero. Il tag di livello più alto e la profondità ammessa varia a seconda della classe di documento (vedere la sezione La classe di documento).

La normale gerarchia prevede:

chapt
    sect
        sect1
            sect2
                sect3
                    sect4

Si prenda un libro e si guardi l'indice per vederlo.

Ciascuno dei tag tra le sezioni ha più o meno la stessa sintassi. Ognuno di essi ha un'intestazione. Il tag intestazione è implicito se non lo si annota. Inoltre ogni tag che crea sezioni può contenere un tag intestazione, che modifica l'intestazione attuale del documento (vedere la sezione Il tag Header).

In esso si possono posizionare sezioni subordinate e paragrafi (vedere Paragrafi).

Alcuni dei tag che creano sezioni possono apparire soltanto in speciali classi di documento ( Classi di documento).

Suggerimento:: È cosa saggia posizionare un tag etichetta dopo il testo del tag sezione, anche se non si vuole fare riferimento alla sezione Etichette e riferimenti. Più avanti, quando il proprio documento aumenterà di dimensioni, si potrebbe volerlo.

7. Paragrafi

<!entity % sectpar
        " %par; | figure | tabular | table | %mathpar; |
          %thrm; | %litprog; ">

<!entity % par       
        "  %list; | comment | lq | quote | tscreen " >

<!entity % litprog " code | verb " >

Ciascuno dei tag qui descritti forma un paragrafo.

Per ovvie ragioni, un paragrafo normalmente

Qui si spiega il comportamento delle eccezioni figure e tabular .

inizia e finisce con una riga vuota.

In quale altro modo si potrebbe sapere che è un paragrafo?

Ci sono alcuni tag che formano sempre un paragrafo, e un modo per formare implicitamente un paragrafo. Ci sono vari tipi di paragrafi, perchè non tutti i tipi di paragrafo possono apparire in ogni classe di documento, in ogni posto.

I diversi tipi di paragrafi sono spiegati nelle prossime sezioni. Per maggiori dettagli su %litprog; si veda Programmazione istruita.

7.1 Paragrafo normale

Un paragrafo normale può essere creato in due modi:

Tag di paragrafo

Il tag <p> inizia un nuovo paragrafo. Questo tag è obbligatorio se si vuole terminare un'intestazione di sezione senza chiudere esplicitamente il tag sect. In questo caso il tag <p> chiude automanticamente il tag <sect>.

Nuova riga vuota

Una riga vuota tra due paragrafi inizia implicitamente un nuovo paragrafo. Si faccia attenzione con gli elenchi descrittivi. In questo caso un tag <tag> vuoto non diventerà un paragrafo usando una riga vuota.

7.2 Paragrafi stile elenco

<!entity % list
        " list | itemize | enum | descrip " >

Questi quattro tag indicano l'inizio di un paragrafo in stile elenco. All'interno di ciascun elenco le singole voci sono separate da un tag item.

<!element item o o ((%inline; | %sectpar;)*, p*) >

Come si può vedere, una voce può contenere a sua volta paragrafi (e quindi anche altri elenchi, perfino di tipo differente).

Il tag List

<!element list - - (item+)>

Il tag list verrà mappato come un elenco spoglio senza punti, numeri o altre cose.

Per vederlo, ecco un piccolo esempio:

<list>
<item>Un punto
<item>Un altro
<item>L'ultimo
</list>

Si vedrà (a seconda della mappatura) qualcosa come:

Un punto

Un altro

L'ultimo

Il tag Itemize

<!element itemize - - (item+)>

Il tag itemize verrà mappato come un elenco puntato, che viene solitamente usato per elenchi nei quali l'ordine delle voci non è importante.

Un piccolo esempio:

<itemize>
<item>Un punto
<item>Un altro
<item>L'ultimo
</itemize>

Si vedrà (a seconda della mappatura) qualcosa come:

Un punto
Un altro
L'ultimo

Il tag Enum

<!element enum - - (item+)>

Il tag enum verrà mappato come una lista numerata.

Un piccolo esempio:

<enum>
<item>Un punto
<item>Un altro
<item>L'ultimo
</enum>

Si vedrà (a seconda della mappatura) qualcosa come:

Un punto
Un altro
L'ultimo

Il tag Descrip

<!element descrip - - (tag?, p+)+ >

Il tag descrip verrà mappato come un elenco descrittivo. Il concetto in questo caso è leggermente diverso rispetto agli altri tipi di elenchi citati prima.

Qui si posiziona un tag (questa volta il nome del tag è letteralmente tag), che è descritto più avanti.

Un piccolo esempio:

<descrip>
<tag/sgml/structured general markup language.
<tag/html - hypertext markup language/
Una implementazione di sgml.
Contiene alcuni concetti su come collegare informazioni in modo molto conveniente.
È questo che lo ha reso tanto importante, nonchè lo standard per i
documenti pubblicati tramite internet.
<tag/internet/Una internet connessa globalmente (internet intesa come termine
tecnico)
</descrip>

Si vedrà (a seconda della mappatura) qualcosa come:

sgml: structured general markup language.
html - hypertext markup language: Una implementazione di sgml. Contiene alcuni concetti su come collegare informazioni in un modo molto conveniente. È questo che lo ha reso tanto importante, nonchè lo standard per i documenti pubblicati tramite internet.
internet: Una internet connessa globalmente (internet intesa come termine tecnico)

7.3 Illustrazioni e Tabelle

I tag <figure> e <table> creano paragrafi molto speciali. Non sempre sono inseriti nel normale flusso di testo. Entrambi i tag possono contenere un attributo loc (location) che indica come manipolare il flusso di questo paragrafo particolare.

Il valore dell'attributo loc è una stringa di quattro lettere al massimo, in cui ogni lettera dichiara una posizione nella quale l'illustrazione o la tabella può apparire, come descritto nella tabella Posizioni della tabella.

h	here	Nella stessa posizione del file SGML
t	top	All'inizio di una pagina
b	bottom	Alla fine di una pagina
p	page	In una pagina separata con sole illustrazioni e tabelle

Posizioni della tabella

Il valore predefinito dell'attributo loc è top.

Il tag Table

<!element table   - - (tabular, caption?) >

Come si può vedere, una tabella consiste nello stesso tag <table>, che include un tag <tabular> e opzionalmente un tag <caption>.

Il tag <tabular> può anche essere posizionato senza un tag <table>, come descritto in dettaglio nella sua sezione (si veda Il tag Tabular).

Il tag caption si usa anche per posizionare la voce per l' elenco delle tabelle, se ne è stato dichiarato uno (si veda Il tag lista di tabelle).

Un breve esempio mostrerà come lavorano insieme.

<table loc="ht">
<tabular ca="lcr">
Guarda|questa|tabella@
Non|è|carina@
1.234|colonne|miste
</tabular>
<caption>Una tabella di esempio
</table>

Guarda	questa	tabella
Non	è	carina
1.234	colonne	miste

Una tabella di esempio

Il caption "Una tabella di esempio" sarebbe il nome nella lista delle tabelle.

Il tag Figure

<!element figure - - ((eps | ph ), img*, caption?)>

L'utilizzo del tag <figure> è equivalente a quello del tag <table>. Invece del tag <tabular> si può utilizzare o il tag <eps> o il tag <ph>.

Il tag Encapsulated Postscript(TM)

<!attlist eps
        file cdata #required
        height cdata "5cm"
        angle cdata "0">

Il tag <eps> serve a includere un file esterno in formato encapsulated postscript(TM) nel documento.

Gli attributi del tag <eps> sono:

file: L'attributo file richiede il nome di un file encapsulated postscript(TM) che termini con il suffisso .ps. Il suffisso obbligatorio .ps non deve essere scritto.
height: L'altezza dello spazio che il file andrà ad occupare. Se non lo si specifica, il valore predefinito sarà 5 cm. Si faccia attenzione a non inserire spazi tra il numero e l'unità di misura (i, cm).
angle: L'angolo viene indicato in gradi sessagesimali (0-360) e all'aumento del numero il file viene ruotato in senso orario.

Un esempio:

<figure loc="here">
<eps file="logo" height="4cm" angle="15">
<img src="logo.gif">
<caption>Inclusione di un encapsulated postscript(TM)
</figure>

Il tag img verrà ignorato dalla mappatura LaTeX e sarà utile per l'html, poichè molti browser non riconoscono l'eps.

Inclusione di un file encapsulated postscript(TM).

Il tag caption andrà nella lista delle illustrazioni come descritto nella sezione Il tag lista di immagini.

Il tag placeholder

<!attlist ph
        vspace cdata #required>

Questo tag non posiziona alcunchè, ma inserisce uno spazio vuoto adatto per incollare manualmente figure nel buon vecchio modo. L'attributo vspace assegna lo spazio lasciato libero. Caveat: L'argomento numerico dell'attributo vspace necessita di un'unità di misura direttamente dietro al numero. Non si lasci uno spazio (come detto per l'attributo height in Il tag Encapsulated Postscript(TM).

<figure loc="ht">
<ph vspace="5cm">
<caption>Uno spazio vuoto.
</figure>

Restituisce:

Uno spazio vuoto per incollare una fotografia

A questo punto potrebbe essere il caso di cercare forbici e colla.

7.4 Il tag Tabular

<!element tabular - - 
       (hline?, %tabrow, (rowsep, hline?, %tabrow)*, caption?) >

Il tag <tabular> viene interpretato come un paragrafo a se stante, se viene scritto da solo. Insieme al tag <table> diventa parte del paragrafo del tag <table> (vedere Il tag Table).

All'interno del tag tabular possono esserci righe e colonne che separano il testo. Devono esserci almeno una colonna e una riga.

Altrimenti non risulterebbe molto utile.

Il tag <tabular> ha un attributo ca obbligatorio per l'allineamento di colonna. L'allineamento di colonna contiene un solo carattere per ogni colonna nel loro ordine da sinistra a destra. I caratteri che si possono posizionare per colonna sono descritti nella tabella Allineamento di colonna

carattere	allineamento

l	left (sinistra)
c	centered (centrato)
r	right (destra)

Allineamento di colonna

In teoria si dovrebbe poter posizionare un | nell'attributo ca per disegnare una linea orizzontale di separazione per due colonne. Il problema: non funziona. L'analizzatore lo accetta bene, solo che l'output in LaTeX mapperà | come {$|$}, che naturalmente è l'impostazione di quattro colonne erroneamente allineate per tutte e quattro le colonne. Proverò a capire come risolverlo.

Le colonne all'interno del tag <tabular> sono separate da un separatore di colonna, il tag <colsep>. Il carattere | viene tradotto come <colsep>, così lo si può usare al suo posto.

Meno battitura, più divertimento.

Ciò che vale per le colonne vale anche per le righe. Si separano le righe con un separatore di riga, il tag <rowsep>. Il carattere @ viene tradotto con <rowsep>.

Opzionalmente si può posizionare una linea orizzontale con il tag <hline>. Si faccia attenzione a questo tag: gli strumenti SGML lo trasformeranno correttamente sia posizionandolo davanti alla riga che si vuole sotto la linea, che dietro la fine della riga che si vuole al di sopra. Ma l'unico modo per scriverlo senza provocare un "errore" dell'analizzatore è scriverlo direttamente e senza spazi o riga vuota dietro il separatore di riga.

<tabular ca="lcr">
Guarda|questa|tabella@<hline>
Non|è|gradevole@
1.234|colonne|miste@
</tabular>

I risultati sono visibili nella tabella Esempio di tabella per il tag Tabular

Guarda	questa	tabella

Non	è	gradevole
1.234	colonne	miste

Esempio di tabella per il tag Tabular

Attenzione:: nella mappatura per LaTeX tutto funziona bene se si posiziona un tag tabular senza un tag table; solo nelle altre mappature (per esempio html) verrà disordinato.

7.5 Paragrafi matematici

<!entity % mathpar " dm | eq " >

Un paragrafo matematico consiste o di una formula visualizzata tramite un tag <dm>,

No, scusate, non per il marco tedesco! ;-)

o di una equazione tramite il tag <eq>. Lavorano entrambi allo stesso modo.

Entrambi i tag contengono una formula matematica. Vedere Formule matematiche per i tag validi.

Nota:: Poichè nè Netscape nè Microsoft hanno ritenuto necessario aggiungere la mappatura matematica ai loro browser (come richiesto e definito da w3c), non c'è in html un modo piacevole di mappare, o almeno di mostrare a video, i simboli matematici. Quindi, guardando la versione online, ci si può liberamente meravigliare di questo controsenso. Forse si vorrà dare uno sguardo alla versione postscript.

Il tag Displayed Formula

Questo tag mostra una formula matematica come un paragrafo. La formula viene mappata al centro come linea singola.

Non ci sono garanzie per questo. Si sa, la mappatura è una questione di gusti.

<dm>(a+b)<sup/2/=a<sup/2/+2ab+b<sup/2/</dm>

Viene mappato come: (a+b)²=a²+2ab+b²

Il tag Equation

<dm>(a+b)<sup/2/=a<sup/2/+2ab+b<sup/2/</dm>

Viene mappato come: (a+b)²=a²+2ab+b²

7.6 Paragrafo Teorema

<!entity % thrm 
        " def | prop | lemma | coroll | proof | theorem " >

<!element def - - (thtag?, p+) >
<!element prop - - (thtag?, p+) >
<!element lemma - - (thtag?, p+) >
<!element coroll - - (thtag?, p+) >
<!element proof - - (p+) >
<!element theorem - - (thtag?, p+) >

Come si può vedere i diversi tipi di paragrafi theorema sono praticamente identici. L'unica eccezione leggermente diversa è proof, che non possiede un thtag. Per tutte le altre versioni il thtag fornisce il tag del paragrafo teorema.

Si provi a utilizzare solo questo, che è adatto al significato di ciò che si sta digitando.

<thrm>
<thtag>Alexander's thrm</thtag>
Sia <f>&lt;fi/G/</f> un insieme di obiettivi secondari ottenibili non banali,
e &mu; un ordinamento su <f>&lt;fi/G/</f>. &mu; \
astrattamente indicativo se e solo se è una linearizzazione di
<f><lim><op>&mu;</op><ll><fi/G/</ll><ul>&ast;</ul></lim></f>.
</theorema>

thrm viene rimpiazzato dal tag adeguato.

Forse qualcuno esperto di matematica rimarrà scioccato dal mio abuso dei tipi, ma sono pigro e ho semplicemente copiato gli esempi:

Definizione (def): Definizione di Alessandro