Node:sect 1.3, Next:, Previous:sect 1.2, Up:chap 1



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 &lt;tizio@dinkel.brot.dg&gt;</author>
          <author>Caio Cai &lt;caio@dinkel.brot.dg&gt;</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.

copyright Element
This element contains a line of text describing the copyright owner for the document.

publishnote Element
This optional element, contains block of text that show information about the printed publication.

license Element
This element contains block of text to show the license conditions for the document.

coverart Element
This optional element, contains block of text that show who is responsible for the cover design.

Use this element like this:

          <legal>
              <copyright>Copyright &copy; 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 &copy; 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.