<sect1 id="format-para">
<sect1info>
<authorgroup>
<author
><firstname
>Mike</firstname
> <surname
>McBride</surname
> </author>
<othercredit role="translator"
><firstname
>Andrew</firstname
><surname
>Coles</surname
><affiliation
><address
><email
>andrew_coles@yahoo.co.uk</email
></address
></affiliation
><contrib
>Conversion to British English</contrib
></othercredit
> 
</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 dialogue will appear.</para>

<para
>The <guilabel
>Paragraph Settings</guilabel
> dialogue consists of six tabbed sections labelled <link linkend="indents-and-spaces"
>Indent and Spacing</link
>, <link linkend="para-aligns"
>Aligns</link
>, <link linkend="para-borders"
>Borders</link
>, <link linkend="para-bullets-and-numbers"
>Bullets/Numbering</link
>, <link linkend="tab-stops"
>Tabulators</link
>, and <link linkend="para-shadow"
>Shadow</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 dialogue 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 dialogue box is labelled <guilabel
>Indent</guilabel
>, and consists of three parts:</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 box. To alter the first line, specify that value in the text box labelled <guilabel
>First Line</guilabel
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Right</guilabel
></term>
<listitem>
<para
>Enter a value in this 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 box to indent the first line of a paragraph away from the left margin.</para
></listitem>
</varlistentry>
</variablelist>

<para
>The next 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 labelled <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 labelled <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>

<para
>The next section is labelled <guilabel
>Line Spacing</guilabel
>. It consists of two elements:</para>

<variablelist>
<varlistentry>
<term
>combo box</term>
<listitem>
<para
>The combo box determines the spacing between lines. There are three predefined line spacing choices: <guilabel
>Single</guilabel
>, <guilabel
>1.5 lines</guilabel
> and <guilabel
>Double</guilabel
>. You can also select <guilabel
>Custom</guilabel
> which will allow you to enter a specific line spacing.</para>
<para
>The values selected here will be applied to all lines within the selected paragraphs.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Text box</term>
<listitem>
<para
>Enter a value in this text box to specify the spacing between paragraphs. This value only changes the spacing when <guilabel
>Custom</guilabel
> is selected in the combo box to the left.</para>

<note>
<para
>Changes to this entry do <emphasis
>not</emphasis
> affect the line spacing between lines of different paragraphs.</para>
</note>
</listitem>
</varlistentry>
</variablelist>

<para
>The last section is labelled <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 dialogue box, is a preview box, which will <emphasis
>approximate</emphasis
> the final layout of your document.</para>

</sect2>

<sect2 id="para-aligns">
<title
>Aligns</title>
<indexterm
><primary
>paragraph</primary
><secondary
>justification</secondary
></indexterm>
<indexterm
><primary
>paragraph</primary
><secondary
>centre 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 as <emphasis
>alignment</emphasis
>, or <emphasis
>justification</emphasis
>.</para>

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

<para
>There are only 4 choices.</para>

<para
>If <guilabel
>Left</guilabel
>, <guilabel
>Right</guilabel
> or <guilabel
>Centre</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 centred 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
>Centre 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
>On the right of the dialogue box, is a preview box, which will <emphasis
>approximate</emphasis
> the final layout of your document.</para>

</sect2>

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

<para
>The next section is used to define and configure graphical borders around your paragraphs.</para>

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

<para
>&kword; can surround (on some or all sides) a paragraph with a border. This border can be solid or not, of any colour and of any size. This dialogue 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
>Colour</guilabel
></term>
<listitem>
<para
>Clicking on the colour bar will allow you to select a colour using the <link linkend="select-colors"
>colour selection dialogue 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 Left Border. 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 Right Border. 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 Top Border. 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 Bottom Border. 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 colours in one paragraph.</para>
<para
>Simply determine the border style, width and colour for one border edge, and select the border using the border buttons. Now alter the style width or colour to create a new border look and select 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 dialogue box is used to define your bullets or the numbering method of lists in the document.. This dialogue 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 dialogue 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 dialogue 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 dialogue is used to adjust the tab stops. For more details, see <link linkend="tab-stops"
>Using Tab Stops</link
>.</para>

</sect2>
<sect2 id="para-shadow">
<title
>Shadows</title>
<indexterm
><primary
>paragraph</primary
><secondary
>shadows</secondary
></indexterm>
<indexterm
><primary
>text</primary
><secondary
>shadowing</secondary
></indexterm>

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

<para
>This tab is used to create an artificial shadow of the text in the paragraph.</para>
<para
>On the right of the dialogue is a preview box. This box can be used to <emphasis
>approximate</emphasis
> the final look of the text.</para>
<para
>The colour of the shadow can be adjusted by clicking on the button labelled <guilabel
>Colour</guilabel
>. &kword; will use the <link linkend="select-colors"
>colour selection dialogue box</link
> to change the colour of the shadow.</para>
<para
>Use the spinbox labelled <guilabel
>Distance</guilabel
> to select the distance the shadow moves away from the text. A distance of zero will hide the shadow behind the original text.</para>
<para
>Select one of the 8 direction buttons to determine which direction the shadow will move in.</para>
<para
>When you are happy with your selections, click <guibutton
>OK</guibutton
> to apply your changes.</para>
</sect2>
</sect1>
