<sect1 id="format-para">
<sect1info>
<authorgroup>
<author>
<firstname>Mike</firstname>
<surname>McBride</surname>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
</sect1info>
<title>Formatting Paragraphs</title>
<indexterm><primary>paragraph</primary><secondary>formatting</secondary></indexterm>
<para>This section will detail all the options available to format paragraphs.</para>

<para>To format a paragraph, place the cursor in the paragraph.  To format more than
one paragraph at a time, simply <link linkend="select">select the paragraphs with the mouse or keyboard</link>.</para>

<para>You can format one or more paragraphs one of three ways:</para>

<itemizedlist>
<listitem>
<para>Select <menuchoice>
<guimenu>Format</guimenu><guimenuitem>Paragraph...</guimenuitem></menuchoice>
from the menubar</para>
</listitem>

<listitem><para>Type <keycombo action="simul">&Alt;&Ctrl;<keycap>P</keycap></keycombo></para></listitem>

<listitem>
<para>Place the mouse pointer in the paragraph and click once
with the &RMB;.  A small menu
will appear.  Select <guimenuitem>Paragraph...</guimenuitem>.</para>
</listitem>

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

<para>The <guilabel>Paragraph Settings</guilabel> dialog consists of five tabbed sections
labeled <link linkend="indents-and-spaces">Indent and Spacing</link>, <link
linkend="para-aligns">General Layout</link>, <link linkend="para-borders">Borders</link>,
<link linkend="para-bullets-and-numbers">Bullets/Numbering</link>, and
<link linkend="tab-stops">Tabulators</link>.</para>

<sect2 id="indents-and-spaces">
<title>Indents and Spaces</title>
<indexterm><primary>paragraph</primary><secondary>indent lines</secondary></indexterm>
<indexterm><primary>paragraph</primary><secondary>change line spacing</secondary></indexterm>
<indexterm><primary>paragraph</primary><secondary>keep lines and paragraphs together</secondary></indexterm>

<para>With this dialog box the
spacing between lines, and the spacing between paragraphs can be specified.</para>

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

<para>The first section of this dialog box is labeled
<guilabel>Indent</guilabel>, and consists of three spin boxes:</para>

<variablelist>
<varlistentry>
<term><guilabel>Left</guilabel></term>
<listitem>
<para>Enter a value in this box to indent the lines of the selected paragraphs away from the left margin.  
The first line is unaffected by this spin box.  To
alter the first line, specify that value in the spin box labeled <guilabel>First Line</guilabel>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Right</guilabel></term>
<listitem>
<para>Enter a value in this spin box to indent all lines of the selected paragraph
(including the first line) away from the right
margin.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>First Line</guilabel></term>
<listitem><para>Enter a number in this spin box to indent the first line of a paragraph away from the left
margin.</para>
<tip><para>Entering a negative value in this spin box will create a <link linkend="defhangingindent">hanging indention</link>.</para></tip></listitem>
</varlistentry>
</variablelist>


<para>The next section is labeled <guilabel>Line Spacing</guilabel>.  It
consists of a combo box and a spin box.</para>

<para>The combo box determines the method of calculating the spacing between lines.  It has several choices:</para>

<variablelist>
<varlistentry>
<term>Single, 1.5 Lines and Double</term>
<listitem>
<para>If any of these options are selected, the paragraph will have single, 1 and 1/2 or double spacing respectively.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Proportional</term>
<listitem>
<para>If this option is selected, the spin box is enabled.  When you enter a number in the spin box, &kword; uses that number as a multiplier for line spacing.  To look at it another way, if you enter 1.00 in this box, &kword; will use single spacing.  If you enter 2.00 in this box, &kword; will use double spacing.  If you enter 3.00 in this box, &kword; will use triple spacing, etc.  You are not limited to whole numbers.  You could enter 1.87 in this box and &kword; would use 1.87 line spacing.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Line Distance</term>
<listitem>
<para>If this option is selected, the spin box is enabled.  When you enter a number in the spin box, &kword; places a measured amount of space between each line.  As an example, if you enter 0.75 and the units used by &kword; are inches, then &kword; will place 0.75 inches between each line.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>At least</term>
<listitem>
<para>This sets the minimum line spacing value.  This can be useful if you have paragraphs with widely differing font sizes.  Typically, &kword; calculates the distance between lines by looking at the tallest character in the line.  You can use this feature to overide close linespacing in small font paragraphs to make them even with large font paragraphs.  &kword; will not cause any fonts to overlap using this spacing technique.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Fixed</term>
<listitem>
<para>This sets the distance between the tops of each line to a specific unit of measure.  If this option is set too small, &kword; will overlap characters, which will obscure the bottom parts of the characters.  </para>
<para>This should not be confused with <guilabel>Line Distance</guilabel> which inserts a specific unit of space between lines.  <guilabel>Fixed</guilabel> specifies the distance between the top of one line and the top of the next line.</para>
</listitem>
</varlistentry>


</variablelist>

<para>The last section is labeled <guilabel>Paragraph Space</guilabel>.
It consists of two entries:</para>

<variablelist>
<varlistentry>
<term><guilabel>Before</guilabel></term>
<listitem>
<para>By entering a value here, additional spacing is added before each paragraph.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>After</guilabel></term>
<listitem>
<para>By entering a value here, additional spacing is added after each paragraph.</para>
</listitem>
</varlistentry>
</variablelist>

<para>On the right of the dialog box, is a preview box, which will
<emphasis>approximate</emphasis> the final layout of your
document.</para>

</sect2>

<sect2 id="para-aligns">
<title>General Layout</title>
<indexterm><primary>paragraph</primary><secondary>justification</secondary></indexterm>
<indexterm><primary>paragraph</primary><secondary>center paragraph</secondary></indexterm>
<indexterm><primary>paragraph</primary><secondary>left/right aligns</secondary></indexterm>
<indexterm><primary>paragraph</primary><secondary>horizontally align paragraphs</secondary></indexterm>

<para>This section determines how the text is placed <emphasis>within
the line</emphasis>.  With other applications, you may have referred to
this simply as <emphasis>alignment</emphasis>, or
<emphasis>justification</emphasis>.</para>

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

<para>Once again, a preview pane is shown on the right side of the dialog box.</para>

<para>In the upper left corner of the dialog box is a section labeled <guilabel>Alignment</guilabel>.</para>

<para>If <guilabel>Left</guilabel>,
<guilabel>Right</guilabel> or <guilabel>Center</guilabel> are selected, the text will
be moved on the line so that it aligns with the left margin, aligns with
the right margin, or is centered between the margins
respectively.</para>

<para>If <guilabel>Justify</guilabel> is selected, &kword; will increase
the space <emphasis>between</emphasis> words, so that each line (with
the exception of the last line in a paragraph), reaches both the left
and right margins.</para>

<tip><para>You can use toolbar buttons to quickly change the justification of one or more paragraphs</para>
<informaltable>
<tgroup cols="2">
<thead>
<row><entry>Button</entry><entry>Command</entry></row>
</thead>
<tbody>
<row><entry><inlinemediaobject><imageobject><imagedata fileref="alignLeft.png" format="PNG"/></imageobject></inlinemediaobject></entry><entry>Left Align </entry></row>
<row><entry><inlinemediaobject><imageobject><imagedata fileref="alignCenter.png" format="PNG"/></imageobject></inlinemediaobject></entry><entry>Center  Align </entry></row>
<row><entry><inlinemediaobject><imageobject><imagedata fileref="alignRight.png" format="PNG"/></imageobject></inlinemediaobject></entry><entry>Right  Align </entry></row>
<row><entry><inlinemediaobject><imageobject><imagedata fileref="alignBlock.png" format="PNG"/></imageobject></inlinemediaobject></entry><entry>Justify Text </entry></row>
</tbody></tgroup>
</informaltable>
</tip>


<para>The lower section controls how &kword; divides paragraphs when a 
paragraph will not fit entirely within the current frame or page.</para>

<para>The first option is labeled <guilabel>Keep lines
together</guilabel>.  If this option is selected, then all of the lines
of the paragraph will remain on the same page.  If this is not selected,
&kword; may choose to move part of a paragraph to a new page or frame.  
For most work, this option is usually left
unchecked.</para>

<para>The next two options are labeled <guilabel>Insert Break Before Paragraph</guilabel>
 and <guilabel>Insert Break After Paragraph</guilabel>.
When one of these options is checked, and the paragraph moves to the
next frame in the frame set, a hard frame break will be inserted in front
of the current paragraph or after the previous paragraph (depending on the option selected).
This will serve to keep the paragraph in the
next frame, even if text prior to that frame is deleted.  This option is
often used in conjunction with <guilabel>Keep lines together</guilabel>,
to ensure that the paragraph does not creep back onto the page during
editing. </para>

</sect2>

<sect2 id="para-borders">
<title>Decorations</title>
<indexterm><primary>paragraph</primary><secondary>borders</secondary></indexterm>

<para>The next section is used to define the background color of the current paragraphs and configure graphical borders
around your paragraphs.</para>

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

<para>Clicking the color button to the right of <guilabel>Background color:</guilabel>, will let you select a color to serve as the background 
of your paragraph. </para>
<para>&kword; can surround (on some or all sides) a
paragraph with a border.  This border can be solid or not, of any color
and of many sizes.  This dialog panel is used to adjust the
borders.</para>

<variablelist>
<varlistentry>
<term><guilabel>Style</guilabel></term>
<listitem>
<para>Use this combo box to select the overall type
of the new border. </para>
<para>The choices are previewed in each selection.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Width</guilabel></term>
<listitem>
<para>This will determine how wide the resulting border will be.  It is
measured in points.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Color</guilabel></term>
<listitem>
<para>Clicking on the color bar will allow you to select a color using the <link
linkend="select-colors">color selection dialog
box</link>.</para>
</listitem></varlistentry>
</variablelist>

<para>Now that it is determined how the borders should look, specify which edges of the paragraphs need borders.</para>

<informaltable frame="none">
<tgroup cols="2">
<tbody>
<row>
<entry><inlinemediaobject><imageobject><imagedata fileref="borbutL.png"
format="PNG" align="right"/></imageobject></inlinemediaobject></entry>
<entry valign="middle">Select/Unselect <guiicon>Left Border</guiicon>.  Clicking this
button will apply the current options to the left paragraph border.
Clicking a second time will remove the left paragraph border.</entry>
</row>

<row>
<entry><inlinemediaobject><imageobject><imagedata fileref="borbutR.png"
format="PNG" align="right"/></imageobject></inlinemediaobject></entry>
<entry valign="middle">Select/Unselect <guiicon>Right Border</guiicon>.  Clicking this
button will apply the current options to the right paragraph border.
Clicking a second time will remove the right paragraph border.</entry>
</row>

<row>
<entry><inlinemediaobject><imageobject><imagedata fileref="borbutT.png"
format="PNG" align="right"/></imageobject></inlinemediaobject></entry>
<entry valign="middle">Select/Unselect <guiicon>Top Border</guiicon>.  Clicking this button
will apply the current options to the top paragraph border.  Clicking a
second time will remove the top paragraph border.</entry>
</row>

<row>
<entry><inlinemediaobject><imageobject><imagedata fileref="borbutB.png"
format="PNG" align="right"/></imageobject></inlinemediaobject></entry>
<entry valign="middle">Select/Unselect <guiicon>Bottom Border</guiicon>.  Clicking this
button will apply the current options to the bottom paragraph border.
Clicking a second time will remove the bottom paragraph border.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<tip><para>It is possible to mix and match border styles, widths and colors in one paragraph.</para>
<para>Simply determine the border style, width and color for one border edge, and select the border 
using the border buttons.  Now alter the style width or color to create a new border look and click the new border button.</para>
</tip>


<para>The <guilabel>Preview</guilabel> window will show you how your
paragraph borders will look.</para>

</sect2>

<sect2 id="para-bullets-and-numbers">
<title>Bullets and Numbering</title>
<indexterm><primary>paragraph</primary><secondary>bulleted</secondary></indexterm>
<indexterm><primary>paragraph</primary><secondary>numbered</secondary></indexterm>
<indexterm><primary>lists</primary></indexterm>

<para>A very common element of a document, is a list of items.  The list
contains several elements which may be numbered, for easy
reference.  Alternatively, the list elements may be simply set off from
the rest of the text with a special character preceding each element.  These special characters
are called bullets.</para>

<para>This dialog box is used to define your bullets or the
numbering method of lists in the document.  This dialog box can also be used to number chapters and sections.</para>

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

<para>The top section of the dialog box has three options:  <guilabel>None</guilabel>, <guilabel>List</guilabel>
and <guilabel>Chapter</guilabel>.</para>

<para>If <guilabel>None</guilabel> is selected, the text is not marked as 
either a list or a chapter.  No other features of this dialog
box will alter the text when this option is chosen.</para>

<para><guilabel>List</guilabel> is used to create
lists in the document.  These lists are
automatically numbered and formatted to appear similar.  
For more information on lists, see the section entitled <link linkend="lists">Lists</link>.</para>

<para><guilabel>Chapter</guilabel> is used to
number chapters and sections of a document.</para>

</sect2>

<sect2 id="para-tabulators">
<title>Tabulators</title>

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

<para>This dialog is used to adjust the tab stops.  For more details,
see <link linkend="tab-stops">Using Tab Stops</link>.</para>

</sect2>

</sect1>
