<chapter id="guides">
<title>Detailed Guides: Document Storage and Printing</title>

<para>This section of the documentation will cover everything you need
to know about starting a new document, saving a document, retrieving a
saved document and printing a docuemnt.</para> 

<sect1 id="new-doc">
<title>Beginning a New Document</title>

<para>Starting a new document can be done 5 ways:</para>

<itemizedlist>
<listitem>
<para>You can <link linkend="starting-kword">start &kword; from the
&kde; Panel</link>.</para>
</listitem>

<listitem>
<para>You can <link linkend="starting-kword">start &kword; from the
command line</link> by typing<screen><prompt>$</prompt>
<userinput><command>kword &amp;</command></userinput></screen></para>
</listitem>

<listitem>
<para>You can begin a new document in &kword; by selecting <menuchoice>
<guimenu>File</guimenu><guimenuitem>New</guimenuitem></menuchoice> from
the Menu bar</para>
</listitem>

<listitem>
<para>You can use the keyboard shortcut: <keycombo
action="simul">&Ctrl;<keycap>N</keycap></keycombo></para>
</listitem>

<listitem>
<para>or by clicking <inlinemediaobject><imageobject><imagedata
fileref="filenew2.png" format="PNG"
align="center"/></imageobject></inlinemediaobject> on the
toolbar.</para>
</listitem>

</itemizedlist>

<para>However you begin a new document, a dialog box appears:</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="ChooseTempDia.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>
<para>This dialog box allows you to:</para>

<itemizedlist spacing="compact">
<listitem>
<para><link linkend="new-doc-from-template">Start a New document from a
template</link></para>
</listitem>
<listitem>
<para><link linkend="loading-existing-doc">Open an existing
document</link></para>
</listitem>
<listitem>
<para><link linkend="loading-recent-doc">Open a recent
document</link></para>
</listitem>
<listitem>
<para><link linkend="loading-empty-doc">Start an <quote>Empty</quote>
document. (This is the default)</link></para>
</listitem>
</itemizedlist
>
<tip>
<para>You can use the following keyboard shortcuts:</para>

<informaltable>
<tgroup cols="2"><tbody>
<row><entry>New document from a template</entry><entry><keycombo
action="simul">&Alt;<keycap>T</keycap></keycombo></entry></row>
<row><entry>Open a recent document</entry><entry><keycombo
action="simul">&Alt;<keycap>R</keycap></keycombo></entry></row>
<row><entry>Start and Empty document</entry><entry><keycombo
action="simul">&Alt;<keycap>E</keycap></keycombo></entry></row>
</tbody></tgroup></informaltable>

<para>If you use the keyboard shortcuts, you will need to press
<keycap>Enter</keycap> on the keyboard or click
<guibutton>OK</guibutton> to confirm your selection.</para>

</tip>

<sect2 id="new-doc-from-template">
<title>Starting a new document from a template</title>

<para>In order to start a new document based on a template, you must
first choose your template.</para>

<para>Remember templates are either Text Oriented or Page Layout
templates. If you need to review the differences, click <link
linkend="wp-vs-dtp">here</link>.</para>

<para>You can use the tabs labled Text Oriented and Page Layout to
display all the available templates of that group.</para>

<para>Once you are on the correct tab, you are shown all the available
templates, each with a title and a small icon which shows you the
general layout of the template. </para>

<tip>
<para>&kword; comes with two standard template groups. You can add
new tabs by installing outside templates, or creating templates of your
own.</para>
</tip>

<para>To select your template, click on it with the left button.  The
selected template will be highlighted.  Confirm your choice by clicking
the <guibutton>OK</guibutton> button. This will begin a new document
with that template.</para>

<tip>
<para>For faster access to a template, simply double click on the
template, and &kword; will immediatly load that template.</para>
</tip>

</sect2>

<sect2 id="loading-existing-doc">
<title>Open an existing document</title>

<para>Click on the <guibutton>Choose</guibutton> button, and an new
dialog box is revealed.  For more details on this dialog box refer to
<link linkend="loading">Retreiving a saved document</link>.</para>

<sect3 id="loading-recent-doc">
<title>Open a Recent Document</title>
<para>&kword; keeps track of the most recently edited documents.  You can select one of these documents by using the drop-down box
to the right of the radio button labeled <guilabel>Open a recent document</guilabel>.</para>


</sect3>
<sect3 id="loading-empty-doc">
<title>Loading an Empty Document</title>

<para>This is the default action, and begins a new document in Text Oriented Mode, with one frame per page.
This is an excellent choice for every day correspondance, or general
word processing.  Simply click <guibutton>OK</guibutton> to
begin.</para>

</sect3>

</sect2>

</sect1>

<sect1 id="saving">
<title>Saving a Document</title>

<para>Once you have entered text and data into a document, you will
usually want to save this to a file on your hard drive.</para>

<sect2 id="command-save">
<title>The Save Command</title>

<para>The Save command can be invoked 3 ways:</para>

<itemizedlist>
<listitem>
<para>By selecting <menuchoice>
<guimenu>File</guimenu><guimenuitem>Save</guimenuitem></menuchoice> from
the Menu Bar</para>
</listitem>

<listitem>
<para>You can use the keyboard shortcut: <keycombo
action="simul">&Ctrl;<keycap>S</keycap></keycombo></para>
</listitem>

<listitem>
<para>or by clicking <inlinemediaobject><imageobject><imagedata
fileref="filefloppy.png"
format="PNG"/></imageobject></inlinemediaobject> on the toolbar.</para>
</listitem>
</itemizedlist>

<para>Any of these methods results in the same action by &kword;.</para>

<para>By selecting the <guimenuitem>Save</guimenuitem> command, you are
instructing &kword; to save the file under the current filename. You
will not be given the option to change the filename or its location. If
you want to change the name of the file, or where it is saved, you must
select <link linkend="command-save-as"><menuchoice>
<guimenu>File</guimenu><guimenuitem>Save
As...</guimenuitem></menuchoice></link> from the Menu bar.</para>

<para>If you have not saved this file before, it does not have a
filename.  &kword; automatically executes the <link
linkend="command-save-as"><guimenuitem>Save As...</guimenuitem></link>
command so you can provide a file name. </para>

<para>&kword; does not report a sucessful save.  Therefore, if the file
was saved without incident, &kword; will return you to editing your
document.</para>

<para>You can verify that the file was saved, by checking &kword;s title
bar.  If there are unsaved changes, the titlebar will have
<emphasis>[modified]</emphasis> in the titlebar.  If the save was
successful, only the filename will be in the titlebar.  If there is a
probelm with the save, an error box will appear.</para>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="saved1.png" format="PNG"/></imageobject>
<caption><para>Saved Successfully</para></caption>
</mediaobject>
</screenshot>

<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="saved2.png" format="PNG"/></imageobject>
<caption><para>The document still has unsaved changes</para></caption>
</mediaobject>
</screenshot>

</sect2>

<sect2 id="command-save-as">
<title>The Save As.. Command</title>

<para>The Save As... command can be invoked 2
ways:</para>

<itemizedlist>
<listitem>
<para>By selecting <menuchoice> <guimenu>File</guimenu><guimenuitem>Save
As...</guimenuitem></menuchoice> from the Menu bar</para>
</listitem>
<listitem>
<para>or by trying to <guimenuitem>Save</guimenuitem> a file which does
not yet have a filename.</para>
</listitem>
</itemizedlist>

<para>The difference between the <guimenuitem>Save</guimenuitem> and the
<guimenuitem>Save As...</guimenuitem> command, is the <guimenuitem>Save
As...</guimenuitem> command prompts you for a filename, and lets you
select a different file format or location.  The
<guimenuitem>Save</guimenuitem> command simply saves the file in the
previous location.</para>

<para>When you select the <guimenuitem>Save As...</guimenuitem>
function, a dialog appears.</para>

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

<para>Lets look at this dialog more closely:</para>

<para>This dialog shows my current directory is <filename
class="directory">/home/mmcbride/kword</filename>.  You can see this by
the textbox at the top of the dialog</para>

<para>The large box below that shows I currently have 1 folders in this
directory, entitled <emphasis>Past Work</emphasis>, and 2 files
(<emphasis>Job Description</emphasis> and
<emphasis>Resume</emphasis>).</para>

<para>In the upper left corner, is a blue arrow pointed up.  This arrow
will take you up one level in the directory structure.</para>

<para>The next two buttons are backwards and forward buttons.  These
buttons work just like a browser, where you can use the back button to
travel to the previous directory, and the forward button to advance into
a directory you just came from.</para>

<para>Next to the arrow buttons, is a button that looks like a house.
Clicking this will take you to your home directory.</para>

<para>Next to the home button, is a reload button.  Clicking this
button, causes &kword; to reload the current directory in the event
things have changed.</para>

<para>Next to the reload button, is a button with a grey ribbon on it.
This button allows you to set and navigate through bookmarks.  This is a
quick way to jump to commonly accessed directories.  By clicking this
button, a submenu appears which allows you to add bookmarks or jump to a
new bookmark.</para>

<para>Next to the bookmark button, is a new folder button.  If you want
to create a new folder, simply click the button.  &kword; will ask for a
name for the folder.  Then the folder will be created and you will
automatically be placed in the new folder.</para>

<para>The text box labled <guilabel>Location</guilabel> is blank, which
indicates this file does not currently have a filename at all.</para>

<para>The text box labled <guilabel>Filter</guilabel> shows we intend to
save this as a &kword; file.  Using &kword;, you can save the file as other
formats.  For information on other filters, see the section on <link
linkend="filters">Filters</link>.</para>

<para>There is a <guibutton>Cancel</guibutton> button, if you click this
button, the save will be aborted, and you will return to editing the
document.</para>

<para>There is an <guibutton>OK</guibutton> button, which will be used
when we have selected the correct location, correct format and correct
filename.  Clicking this button saves the file.</para>

<para>Using this dialog, you can move through the directory tree to find
a location to save your document in.</para>

<para>To enter a folder click on that folder.  To exit that folder,
click the blue up arrow button.</para>

<para>When you are in the correct folder, you can type a name into the
<guilabel>Location</guilabel> box. There is no need to put a <literal
role="extension">.kwd</literal> at the end of your filename, &kword;
will do this for you.</para>

<note>
<para>&UNIX; filenames are more flexible than many other operating
systems.  Filenames can:</para>

<itemizedlist spacing="compact">
<listitem><para>be of nearly any length</para></listitem>
<listitem><para>be any comination of upper and lower case letters</para></listitem>
<listitem><para>include spaces and puncuation</para></listitem>
</itemizedlist>

<para>Filenames should not:</para>

<itemizedlist spacing="compact">

<listitem><para>begin with a space or period</para></listitem>
<listitem><para>end with a common file extension (<literal
role="extension">.ps</literal>,<literal
role="extension">.pdf</literal>,etc).  This will tell &kword; to try to
export to that filetype.  &kword; has only certain specific <link
linkend="filters">filters</link>.</para>
</listitem>
</itemizedlist>
</note>

<para>Once you have entered the correct information you can click on
<guibutton>OK</guibutton> to complete the save.</para>

<para>&kword; does not report a sucessful save.  Therefore, if the file
was saved without incident, &kword; will return you to editing your
document.  If there is a probelm with the save, an error box will
appear.</para>

<note>
<para>&kword; will only allow you to save your file where you are
allowed to by the permisions listed by the operating system. If you try
to save outside that area, &kword; will generate an error.</para>
</note>

</sect2>

</sect1>

<sect1 id="loading">
<title>Retrieving a Saved Document</title>

<para>
The <command>Open</command> command can be invoked 4 ways:
</para>

<itemizedlist>
<listitem>
<para>By clicking <guilabel>Open a previously saved document</guilabel>
and the <guilabel>Choose</guilabel> button when <link
linkend="new-doc">Opening a New Document</link></para>
</listitem>

<listitem>
<para>By selecting <menuchoice>
<guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice> from
the Menu bar</para>
</listitem>

<listitem>
<para>You can use the keyboard shortcut:
<keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo></para>
</listitem>

<listitem>
<para>or by clicking <inlinemediaobject><imageobject><imagedata
fileref="fileopen.png" format="PNG"/></imageobject></inlinemediaobject>
on the toolbar.</para>
</listitem>
</itemizedlist>

<para>Any of these methods results in the same action by &kword;.</para>

<para>When trying to open a file, a dialog appears.</para>

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

<para>Lets look at this dialog more closely:</para>

<para>This dialog shows my current directory is
<filename class="directory">/home/mmcbride/kword</filename>.  You can see this by the
textbox at the top of the dialog</para>

<para>The large box below that shows I currently have 1 folder in this
directory, entitled <filename>Past Work</filename>, and 2 files
(<filename>Job Description</filename> and
<filename>Resume</filename>).</para>

<para>In the upper left corner, is a blue arrow pointed up.  This arrow
will take you up one level in the directory structure.</para>

<para>The next two buttons are backwards and forward buttons.  These
buttons work just like a browser, where you can use the back button to
travel to the previous directory, and the forward button to advance into
a directory you just came from.</para>

<para>Next to the arrow buttons, is a button that looks like a house.
Clicking this will take you to your home directory.</para>

<para>Next to the home button, is a reload button.  Clicking this
button, causes &kword; to reload the current directory in the event
things have changed.</para>

<para>Next to the reload button, is a button with a grey ribbon on it.
This button allows you to set and navigate through bookmarks.  This is a
quick way to jump to commonly accessed directories.  By clicking this
button, a submenu appears which allows you to add bookmarks or jump to a
new bookmark.</para>

<para>Next to the bookmark button, is a new folder button.  If you want
to create a new folder, simply click the button.  &kword; will ask for a
name for the folder.  Then the folder will be created and you will
automatically be placed in the new folder.</para>

<para>The text box labled <guilabel>Location</guilabel> is blank.  Once
you click on a filename, that filename will appear in this blank.
Alternativly, you can simply type the filename in the blank.</para>

<para>The text box labled <guilabel>Filter</guilabel> shows we intend to
load all file types.  Using KWord, you can load files from other
formats.  For information on this, see the section on <link
linkend="filters">Filters</link>.</para>

<tip>
<para>Another function of the <guilabel>Filter</guilabel> box, is to act
as a file mask. A file mask hides all the files that &kword; believes
are unimportant to your current task.  When the &kword; filetype is set
to &kword; file, the dialog box only shows Folders, and files ending in
<literal role="extension">.kwd</literal>.  If you file does not end in
<literal role="extension">.kwd</literal>, you need to change the file
type box to read <guilabel>All files</guilabel>, by selecting the drop
down box.  Now all files will be displayed.</para>
</tip>

<para>Using this dialog, you can move through the directory tree to find
a location to load your document from.</para>

<para>To enter a folder, you double click on that folder.  To exit that
folder click the blue up arrow button.</para>

<para>There is a <guibutton>Cancel</guibutton> button, if you click this
button, the load will be aborted.</para>

<para>There is a <guibutton>OK</guibutton> button, which will be used
when we have selected the correct location, correct format and correct
filename.</para>

</sect1>

<sect1 id="printing">
<title>Printing A Document</title>

<para>The Print command can be invoked 3 ways:</para>

<itemizedlist>
<listitem>
<para>By selecting <menuchoice>
<guimenu>File</guimenu><guimenuitem>Print</guimenuitem></menuchoice>
from the Menu bar</para>
</listitem>
<listitem>
<para>You can use the keyboard shortcut:
<keycombo>&Ctrl;<keycap>P</keycap></keycombo></para>
</listitem>
<listitem>
<para>or by clicking <inlinemediaobject><imageobject><imagedata
fileref="fileprint.png" format="PNG"/></imageobject></inlinemediaobject>
on the toolbar.</para>
</listitem>
</itemizedlist>

<para>No matter how you do this, the &kde; print dialog will
appear.</para>

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

<para>The top drop down box labeled <guilabel>Name</guilabel> shows the
currently selected printer.  To configure this printer click on the
<guibutton>Properties</guibutton> button.</para>

<para>To select a different printer, click on the dropdown box and
select the desired printer.</para>

<para>If you want to print your output into a postscript file, select
Print to File.  You can now use the <guibutton>Browse</guibutton> button
to locate the files destination.  As an alternative, you can enter the
absolute path and filename for your new file.</para>

<para>Under <guilabel>Page Selection</guilabel>, you can select either
to print the whole document (the default), print the page the cursor is
located on, or print a range of pages.  If you select the
<guilabel>Print Range</guilabel> option, you will be given the
opportunity to select your start and end pages in the text boxe
provided.</para>

<para>In the box in the lower right, you should set the number of copies
you want printed.  You can either enter the number directly into the
box, or use the arrows to adjust the number. &kword; can print a maximum
of 9999 copies at once.</para>

<para>You can have &kde; collate your documents by clicking on the
<guilabel>Collate</guilabel> check box.  If selected, &kde; will print
all of the pages for copy 1, then print all the pages for copy 2, &etc;
If not selected, &kde; will print all of the copies of the first page,
then all of the copies of the second page, &etc;</para>

<para>You can also determine if the document is printed in forward order
(print first page first), or reverse order (print last page
first).</para>


<para>Just above the <guibutton>OK</guibutton> you can tell &kde; to
print the Even pages, the Odd pages or All pages.</para>

<para>When you are satisfied with your selections, you can click
<guibutton>OK</guibutton> to print.</para>

<para>If you click on <guibutton>Cancel</guibutton>, the printing will
be aborted.</para>

</sect1>

</chapter>    
