<sect1 id="page-format">
<title>Formatting the Page</title>

<para>Before delving into the specifics of formatting a page in &kword;, remember that
&kword; has two separate types of documents:  Text Oriented and Page Layout.  
Please review <link
linkend="wp-vs-dtp">The difference between Text Oriented and Page Layout Documents</link>, 
if the differences are still unclear.</para>

<para>This section of the manual is divided into two sub-parts, one for
<link linkend="wp-page-format">Text Oriented</link>, the other for <link linkend="dtp-page-format">Page Layout</link>.</para>

<sect2 id="wp-page-format">
<title> Formatting the Page (Text Oriented Document)</title>

<para>When you are working with a Text Oriented Document, you control
the size and shape of the main frame by setting the paper size and the margins. </para>

<para>Formatting the page is usually done by selecting: <menuchoice>
<guimenu>Format</guimenu><guimenuitem>Page...</guimenuitem></menuchoice>
from the menubar.</para>

<tip>
<para>You can also go straight to the <guimenuitem>Format
Page</guimenuitem> options by selecting the main frame of the document then double clicking on either of the
rulers.</para>
</tip>

<para>A dialog box will appear with three tabs, labeled <guilabel>Format and
Borders</guilabel>, <guilabel>Columns</guilabel> and <guilabel>Header
and Footer</guilabel>.</para>

<para>The <guilabel>Format and Borders</guilabel> tab is for altering
the paper size, and changing the margins.</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="wpfmtpg1.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para>First you will notice, that a preview box appears on the right
half of this dialog.  This will <emphasis>approximate</emphasis> the
final look of your document.  It is updated with each change, and should
be used as a guide for your changes. </para>

<para>On the left, the dialog displays the current unit of measurement.
This unit of measurement is the same unit of measurement
you use for your document rulers. (In this example, we are using
inches.)  To change the units, follow the instructions in the section entitled
<link linkend="rulers">Using Rulers</link>.</para>

<para>The dialog section labled <guilabel>Page Format</guilabel> is used to specify
the paper size for the document.  </para>
<para>&kword; includes many predefined paper sizes.  Select the appropriate paper size with the drop down
box labled <guilabel>Format</guilabel>.</para>

<para>In addition to standard paper sizes, there are two selections that
deserve special mention.</para>
<variablelist>
<varlistentry>
<term><guilabel>Screen</guilabel></term>
<listitem><para>This format is used to generate a document where
each page has an <link linkend="defaspectratio">aspect
ratio</link> (shape) which matches the aspect ratios of computer
monitors. This might be useful for documents which will never be printed, but will appear only on a computer screen.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Custom</guilabel></term>
<listitem><para>You can select this option to specify a unique  paper size.</para>
<para>Once selected,  two text
entry boxes (labeled <guilabel>Width:</guilabel> and
<guilabel>Height:</guilabel>) become active.  Enter the height and width of your desired paper size in these text boxes.</para></listitem>
</varlistentry>
</variablelist>

<para>Next to the paper format, in the drop-down box labeled
<guilabel>Orientation</guilabel> you can select either <link
linkend="defportrait">Portrait</link> or <link
linkend="deflandscape">Landscape</link> layout for
your document. </para>

<para>Below the page format options, is the Page Borders subsection, which
consists of 4 entry boxes labeled (<guilabel>Left:</guilabel>,
<guilabel>Right:</guilabel>, <guilabel>Top:</guilabel> and
<guilabel>Bottom:</guilabel>).</para>

<para>The <guilabel>Page Borders</guilabel> (also referred to as <emphasis>margins</emphasis>), define the
white-space surrounding the text in your main frame.  You can enter any
number from 0 to the maximum size of the page in these boxes.  The units
are the same for all four boxes, and is the same as the measurement
listed at the top of the dialog..</para>

<para>Clicking on the <guilabel>Columns</guilabel> tab allows you to
change the number of columns on each page.  Details on multi-column documents
can be found <link linkend="columns">here</link>.</para>

<para>Clicking on the <guilabel>Header and Footer</guilabel> tab allows the user to
specify header and footer information. </para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="wpfmtpg3.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para>This dialog can be broken into two major sections.</para>

<para>If you are not familiar with Headers and Footers yet, you should
first read the section entitled <link
linkend="headers-and-footers">Headers/Footers</link></para>

<para><emphasis>Headers</emphasis></para>

<para>This section lets you determine the placement of headers, and
which pages have which headers on them.</para>

<para>If you place a mark in front of <guilabel>Different header for the first page</guilabel>, you
will be able to specify a different format for the header on the first page.</para>

<para>If you place a mark in front of <guilabel>Different header for even and odd pages</guilabel>,
the even pages will use one header, the odd
pages use another header.  You can use this to ensure the page numbers
are always on the outside of the page, or to list the title of the
document on odd pages and the chapter number on the even pages.</para>

<para>In the text box labeled <guilabel>Spacing between header and
body</guilabel>, you can specify how much empty space should be placed
between the bottom of the header, and the top of the main frame.</para>

<para><emphasis>Footers</emphasis></para>

<para>This section lets you determine the placement of footers, and
which pages have which footers on them.</para>

<para>If you place a mark in front of <guilabel>Different footer for the first page</guilabel>, you
will be able to specify a different format for the footer on the first page.</para>

<para>If you place a mark in front of <guilabel>Different footer for even and odd pages</guilabel>,
the even pages will use one footer, the odd
pages use another footer.  </para>

<para>In the text box labeled <guilabel>Spacing between footer and
body</guilabel>, you can specify how much empty space should be placed
between the bottom of the footer, and the top of the main frame.</para>

<para>The bottom text box is labeled <guilabel>Spacing between footnote and body</guilabel>.  As the label
suggests, you can use this text
box to specify the distance between the bottom edge of the main frame, and the top edge of the footnotes.  For more information on
footnotes, see the section entitled <link linkend="endnotes-and-footnotes">footnotes</link>. </para>

<para>When you are satisfied with the changes you are ready to make,
click <guibutton>OK</guibutton>.</para>

<para>If you click <guibutton>Cancel</guibutton>, all your changes will
be ignored.</para>

</sect2>

<sect2 id="dtp-page-format">
<title> Formatting the Page (Page Layout Template)</title>

<para>When you are working with a Page Layout Template, you control the
size and shape of all the frames individually. </para>

<para>Formatting the page is usually done by selecting: <menuchoice>
<guimenu>Format</guimenu><guimenuitem>Page...</guimenuitem></menuchoice>
from the menu bar.</para>

<tip>
<para>You can also go straight to the <guimenuitem>Format
Page</guimenuitem> options by selecting the a frame of the document then double clicking on either of the
rulers.</para>
</tip>

<para>A dialog box will appear.</para>

<para>The <guilabel>Format and Borders</guilabel> tab is for altering
the paper size, and changing the margins.</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="dtpfmtpg1.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para>First you will notice, that a preview box appears on the right
half of this dialog.  This will <emphasis>approximate</emphasis> the
final look of your document.  It is updated with each change, and should
be used as a guide for your changes. </para>

<para>On the left, the dialog displays the current unit of measurement.
This unit of measurement is the same unit of measurement
you use for your document rulers. (In this example, we are using
inches.)  To change the units, follow the instructions in the section entitled
<link linkend="rulers">Using Rulers</link>.</para>

<para>The dialog section labled <guilabel>Page Format</guilabel> is used to specify
the paper size for the document.  </para>
<para>&kword; includes many predefined paper sizes.  Select the appropriate paper size with the drop down
box labled <guilabel>Format</guilabel>.</para>

<para>In addition to standard paper sizes, there are two selections that
deserve special mention.</para>
<variablelist>
<varlistentry>
<term><guilabel>Screen</guilabel></term>
<listitem><para>This format is used to generate a document where
each page has an <link linkend="defaspectratio">aspect
ratio</link> (shape) which matches the aspect ratios of computer
monitors. This might be useful for documents which will never be printed, but will appear only on a computer screen.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Custom</guilabel></term>
<listitem><para>You can select this option to specify a unique  paper size.</para>
<para>Once selected,  two text
entry boxes (labeled <guilabel>Width:</guilabel> and
<guilabel>Height:</guilabel>) become active.  Enter the height and width of your desired paper size in these text boxes.</para></listitem>
</varlistentry>
</variablelist>

<para>Next to the paper format, in the drop-down box labeled
<guilabel>Orientation</guilabel> you can select either <link
linkend="defportrait">Portrait</link> or <link
linkend="deflandscape">Landscape</link> layout for
your document. </para>

<para>Below the page format options, is the Page Borders subsection, which
consists of 4 entry boxes labeled (<guilabel>Left:</guilabel>,
<guilabel>Right:</guilabel>, <guilabel>Top:</guilabel> and
<guilabel>Bottom:</guilabel>).</para>

<para>The <guilabel>Page Borders</guilabel> (also referred to as <emphasis>margins</emphasis>), define the
white-space surrounding the text in your main frame.  You can enter any
number from 0 to the maximum size of the page in these boxes.  The units
are the same for all four boxes, and is the same as the measurement
listed at the top of the dialog..</para>

</sect2>
</sect1>
