Markup Describe Tagged Ascii


Il documento che segue descrive il formato dei files prodotti da Describe con la denominazione Describe tagged ascii. Questo formato prevede essenzialmente un metodo di markup del testo.

  1. Il carattere '<', che serve per iniziare un markup, quando appare nel testo appare come '<<'.
  2. Tutte le stringe di markup sono racchiuse tra il carattere '<' e il carattere '>'.

Purtroppo non è disponibile una documentazione di questo formato. Si è dunque dovuto ricostruirne il significato dal confronto tra il file DeScribe e i file ascii tagged prodotti. Le tabelle che seguono elencano i diversi markup che abbiamo rilevato.

Blocchi di testo Base

Markup

Descrizione

<DeScribe Tagged ASCII>

Prima riga del file.

<style,"...">

A style tag. Normally it regads one or more paragraphs.

<style,"\Corpo">

Inizio di un paragrafo normale.

<ep>

Fine paragrafo.

<eol>

End of Line (Break)

<style,"\Corpo\FootNoteRef">

Riferimento ad una nota a piè pagina. Si chiude con un \Corpo o un ep.

<style,"\Codice"> <..."\codice"> <..."\code">

A block of code.

Titoli

Markup

Descrizione

<style,"\Titoli">

Not used

<style,"\Titoli\Level 1">

Level 1 title, ends with ep.

<style,"\Titoli\Level 2">

Level 2 title, ends with ep.

<style,"\Titoli\Level 3">

Level 3 title, ends with ep.

<style,"\Titoli\Level 4">

Level 4 Title, ends with another markup.

Liste Indentate

Markup

Descrizione

<style,"\Corpo\Bullet 1">

Unordered list, level 1.

<style,"\Corpo\Bullet 1\Bullet 2">

Unordered list, level 2.

<style,"\Corpo\Bullet 1\Bullet 3">

Unordered list, level 3.

<style,"\Corpo\Bullet 1\Bullet 4">

Unordered list, level 4.

<style,"\Corpo\Bullet 2c 1">

Unordered list, level 1.

<style,"\Corpo\Bullet 2c 1\Bullet 2c 2">

Unordered list, level 1.

<style,"\Corpo\Rientrato 1">

Ordered list level 1. The lit lable is the first text followed by <tab>.

<style,"\Corpo\Rientrato 1\Rientrato 2">

Ordered list level 1.

<style,"\Corpo\Rientrato 1\Rientrato 3">

Ordered list level 2.

<style,"\Corpo\Rientrato 1\Rientrato 4">

Ordered list level 3.

<style,"\Corpo\Rientrato 2c 1">

Ordered list level 4.

<style,"\Corpo\Rientrato 2c 1\Rientrato 2c 2">

Ordered list level 2.

<tab>

Tab element.

Tabelle

Markup

Descrizione

<chart,2,2,...>

Starts a table

<cell,0,0,0,0,0>

Starts a cell

<echart>

Terminates the table

<style,"\Tabelle">

Style for table contents (TD).

<style,"\Tabelle\Titolo">

Style for table contents (TH).

<style,"\Tabelle\Spaziate">

Style for table contents (TD).

<center>

Applied to the cell contents.

<left>

Applied to the cell contents, ignored elsewhere.

<right>

Applied to the cell contents.

Cart Attributes

Markup

Descrizione

<chart,x,y,rh,bp,hc,vc,st,bt,?,

c1,...,cn,

ic1,...,icn,

hr>

Starts a table

x

Number of rows

y

Number of columns

rh

Minimum Row Height in 100pt

bp

Border thickness 100pt

hc

Horrizontal clearance 100pt

vc

Vertical clearance 100pt

st

Separator Type: 0 None, 1 Tab, 2 Paragraph

bt

Border Type: 0 None, 1 All, 2 Ouside, 3 Custom

?

Unknown

c1

Column 1 width 100pt

cn

Sum of column widths 100pt up to column n

ic1

Inter column spacing after column 1

icn

Inter column spacing after column n (final seems to be 0)

hr

Header Rows

Discardable Blocks

Markup

Descrizione

<frame,"ARM",...>

The name of a picture frame.

<style,"\Corpo\Anchor">

A dummy paragraph to "anchor" pictures.

<style,"\Corpo\Temp">

A dummy paragraph to space vertically between tables.

<style,"\Tabelle\PreTabella">

A dummy paragraph to space before a table.

Text Attributes

Markup

Descrizione

<+bold>

Adds bold. Valid until ep.

<-bold>

Removes bold.

<+italic>

Adds italic.

<-italic>

Removes italic.

<+underline>

Adds underline.

<-underline>

Removes underline.

<small>

Small caps. Closed by a matching <evar>.

<evar>

"End variation", closes <small> and <none>. If not matched it should be ignored.

<none>

Eliminates all text attributes. Usually closed by <evar>.

<eos>

Apparently an End of Style tag. The usage is not clear.

dsg.3pktzev • LastModified: 14-9-2007 • John Peter Arnold