titlepage
The titlepage
element is used to enclose all
informations that go on the first pages of the document. The order of
elements is important. It follows a summary table and then the detailed
description.
Element | Attribute | Content | Description or Texinfo equivalence
|
title | in-line | @title
| |
subtitle | in-line | @subtitle
| |
abstract | block | abstract of the document
| |
author | in-line | @author
| |
frontcovertext | block | text shown on the printed front cover
| |
tpextra | block | extra text shown inside title pages
| |
legal | copyright, publishnote, license, coverart | legal information
| |
legal | block | simplified legal information
| |
copyright | One copyright owner
| ||
publishnote | block | publishing note that should appear before the license
| |
license | block | license or reference to the license, or other conditions related to the document
| |
coverart | block | coverart note that should appear after the license
| |
dedications | block | dedications for a book
|
title | Element |
This element contains the document title; the title for the
"printed" document. It is equivalent to @title
for Texinfo. Use this element like this:
<title>Sgmltexi</title> |
subtitle | Element |
This element can be used to define one or more subtitles. It is
equivalent to @subtitle for Texinfo. Use this
element like this, after the title:
<subtitle>An alternative way to write Texinfo documentation</subtitle> This element is used only as needed, without limitations. |
abstract | Element |
This element can be used to define a brief description for the
document. The content must be block text, like the element
p . This text is used for Info typesetting, inside the
Top node. Use this element like this:
<abstract> <p>Sgmltexi is an SGML system (DTD and tools) to make Texinfo documentation using SGML. The Sgmltexi DTD is designed to...</p> <p>...</p> </abstract> This element can be used at most one time. |
author | Element |
This element can be used to define one of the document authors.
This element is equivalent to the Texinfo command
@author . Use this element like this:
<author>Tizio Tizi <tizio@dinkel.brot.dg></author> <author>Caio Cai <caio@dinkel.brot.dg></author> This element must be used at least one time. |
frontcovertext | Element |
This element can be used to include one or more block
of text, that should appear on the front cover, for
the printed edition. Use this element like this:
<frontcovertext> <p>Version 1.2.3</p> <p><image name="good-thing" height="5cm"></p> </frontcovertext> |
tpextra | Element |
This element can be used to include one or more block of text,
that should appear on different places: before the legal
informations; after legal information; after the dedications. The
name tpextra stand for "title page extra" text. Use
this element like this:
<tpextra> <p><strong>Pinco Pallino</strong> is a very old man...</p> <p><strong>Tizio Tizi</strong> studied telecommunication technology...</p> </tpextra> <legal> ... ... </legal> <tpextra> <p>The front cover picture is made by Sempronio.</p> </tpextra> <dedications> ... ... </dedications> <tpextra> <p>The software is very important; true free software is much more important.</p> </tpextra> The use of this element is optional, but notice that the last one can be used only if there is the dedications element before. |
legal | Element |
This element is used to enclose other elements describing
informations about copyright, license and publication.
Use this element like this: <legal> <copyright>Copyright © 2003 Free Software Foundation, Inc.</copyright> <publishnote> <p>Published by...</p> </publishnote> <license> <p>Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".</p> </license> <coverart> <p>Cover art by ...</p> </coverart> </legal> This element must be used at least one time. Actually, this element can have non special internal structure, enclosing simply other block elements. This way, if the standard structure described above is not good for the author intention, it may be used also like this: <legal> <p>Copyright © 2003 Free Software Foundation, Inc.</p> <p>Published by...</p> <p>Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".</p> <p>Cover art by ...</p> </legal> |
dedications | Element |
This optional element, contains block of text that show one or more dedications. |