<!element linuxdoc o o
(sect | chapt | article | report |
book | letter | telefax | slides | notes | manpage ) >
This is describing the overall class of the document, so naturally it has
(leave alone the doctype definition) to be the first tag enclosing your whole
document.
Some of the tags namely the sect and chapt (see section
Sectioning Tags) doesn't make any sense taken them
standalone despite being included as part of more complete classed document,
so we'll describe them later as a part of the other document classes.
Decide first which of the top mentioned document classes fits the type of the
document you want to write best.
To find a detailed description of the document classes see table Document classes.
| Chapter | Class tag |
| Article Tag | <atricle> |
| Report Tag | <report> |
| Book Tag | <book> |
| Letter Tag | <letter> |
| Telefax Tag | <telefax> |
| Slides Tag | <slides> |
| Notes Tag | <notes> |
| Manpage Tag | <manpage>
|
To me the article class is the most important one. Thatīs the reason why itīs described first and most detailed.
<!element article - -
(titlepag, header?,
toc?, lof?, lot?, p*, sect*,
(appendix, sect+)?, biblio?) +(footnote)>
<!attlist article
opts cdata "null">
The options attribute (opts) takes a comma separated list with thy
different style (LaTeX .sty) sheets to inlude within the document.
<!element titlepag o o (title, author, date?, abstract?)>
titlepag) is implicitly placed as soon a you
started your document class. You don't need to write it explicitly.
Anyway you have to note it's mandatory tags. It's purpouse is to describe the
layout and elements of the titlepages.
<!element title - o (%inline, subtitle?) +(newline)>
<title> tag.
You don't need to close thatone.
A title may contain a subtitle started by the <subtitle> tag.
If you look at the headerpage of this document you'll find it to be mapped from the tags:
<title>Linuxdoc Reference <subtitle>A introduction to the linuxdoc dtd
<!element author - o (name, thanks?, inst?,
(and, name, thanks?, inst?)*)>
<author> tag.
If you don't note the name tag itīs imlicitly placed.
The author has also optional items wich can be tagged within the
author tag.
If you want to say thanks to anyone (might be somebody providing usefull
information) you place it within the <thanks> tag.
Next, if your writing is done in your position of an institution
staff member, place it within the <inst> tag.
The <and> tag is starting the whole story again,
as if there would be a second author tag would have been started.
Clearly thisone is for coauthors.
If you want to mark your document with a date, you can do that with the
<date> tag.
It's not checked weather you really place a valid date here, but don't abuse it.
This tag is intended for an abstract description of your document.
Don't mix the <abstract> tag withh an indruduction wich is
likely to be placed inside the first section of your document
(see section
Sectioning).
<!element header - - (lhead, rhead) > <!element lhead - o (%inline)> <!element rhead - o (%inline)>
<header> tag specifies what should be printed at the top of each
page.
It consists of a left heading i.e. <lhead> and a right
heading i.e. <rhead>).
Both elements are required, if a heading is used at all, but either may be
left empty, so that the effect of having only a left or right heading can be
achieved easily enough.
As we will see, an initial header can be given after the title page. Afterwards, a new header can be given for each new chapter or section. The header printed on a page is the one which is in effect at the end of the current page. So that the header will be that of the last section starting on the page.
If you place the <toc> tag, a table of contense will be
generated, by looking the section heading, and adding references.
In a hyperref document, this might be hyperrefs, in a LaTeX document you will come to see the pagenumbers.Only the sections major to the
sect3 will be included.
If you place the <lof> tag, a list of figures will be
generated, by looking the captions of the figures, and adding references.
If you place the <lot> tag, a list of tables will be
generated, by looking the captions of the tables, and adding references.
Here you place various sections according section Sectioning. There is no body tag. The body starts with the first chapter, section or paragraph.
In the end of the article you can place the <appendix> tag
Really you shouldn't think about people (e.g. m.d.s knifing your belly here., wich starts a area of appended sections. The
appendix tag implies a different section numbering type to the
following section tags.
It's intended to gather all the <cites> and <ncites>
you used within your document. The <biblio> tag will be replaced
by a bibliography according the mapping type of the document,
maybe by hyperrefs maybe by section numbers or anything wich might be useful.
Until now I've not been able to create a .bbl file, so I
wasn't able to verify.
A footnote may be place in any spot of your document.
Exactly the spot in yout document where you are placing
the <footnote> tag should be the one where the reference to the
tagged text shuld be rendered.
It should be used for additional information, wich is not necessary for
understanding the primary purpouse of yor document
but might be usefull, interesting, or funny.
Whereas the last one is not always true, even if you try.anywhere within the article.
<!element report - -
(titlepag, header?, toc?, lof?, lot?, p*,
chapt*, (appendix, chapt+)?, biblio?) +(footnote)>
<report> tag the
toplevel is grouped by the <chapt> tag (see
Sectioning). The rest of the structure is identical to the
article class
Article Tag.
<!element book - -
(titlepag, header?, toc?, lof?, lot?, p*, chapt*,
(appendix, chapt+)?, biblio?) +(footnote) >
<book> tag.
<!entity % addr "(address?, email?, phone?, fax?)" >
<!element letter - -
(from, %addr, to, %addr, cc?, subject?, sref?, rref?,
rdate?, opening, p+, closing, encl?, ps?)>
Also the purpose of the letter document class should be quite self
explaining. Place a <letter> tag if you want to write one.
The letter's tags ar described in table Tags in a letter
| tag | mandatory | what's it |
| from | yes | from sender |
| address | no | sender's address |
| no | sender's email | |
| phone | no | sender's phone |
| fax | no | sender's fax |
| to | yes | receiver |
| address | no | receiver's address |
| no | receiver's email | |
| phone | no | receiver's phone |
| fax | no | receiver's fax |
| cc | no | carbon copy |
| subject | no | letters subject |
| sref | no | sender's reference |
| rref | no | receiver's reference |
| rdate | no | received date?? |
| opening | yes | opening |
| paragraphs | yes | see Paragraphs |
| closing | yes | closing |
| encl | no | enclosure |
| ps | no | post scriptum |
<!element telefax - -
(from, %addr, to, address, email?,
phone?, fax, cc?, subject?,
opening, p+, closing, ps?)>
<telefax> tag the receiver's <fax>
tag becomes mandatory.
Should be obvious why.
<!element slides - - (slide*) >
<slides> tag is a
very simple one.
It contains single slide(s) startes by a <slide> tag.
Nothing else.
If not explicitly written the first slide is started implicitly.
<!element slide - o (title?, p+) >
<slide> tag is only allowed within the slides document class.
A slide may contain:
A title (see section The Title Tag) and one or more paragraphs (see section Paragraphs). That's all.
<!element notes - - (title?, p+) >
<notes> tag only a
title (see section
The Title Tag)
and one or more paragraphs
(see section
Paragraphs) are allowed.
<!element manpage - - (sect1*)
-(sect2 | f | %mathpar | figure | tabular |
table | %xref | %thrm )>
man programm.
In a document classified by a <manpage> tag the topleve
section tag is the sect1 tag (see section
Sectioning), for easy pasting manual pages into an article
or book document class.
The exception here to the nortmal sectioning is, that there is only one
subsection level allowed (sect2).