<sect1 id="links">
<sect1info>
<authorgroup>
<author>
<firstname>Mike</firstname>
<surname>McBride</surname>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
</sect1info>
<title>Document Links </title>
<indexterm><primary>document links</primary></indexterm>

<para>&kword; has the ability to insert Internet addresses, email addresses, locations within the current document (bookmarks) and external file locations with a descriptor.  This is most often used to
create web pages in &kword;.</para>

<para>Once inserted into the document, the descriptor will be visible in &kword;, but when saved as a web document, the descriptor will become
 the hyperlink for the location specified with the address.</para>

<sect2 id="links-new"><title>Insert a new document link</title>
<para>To insert a document link select <menuchoice>
<guimenu>Insert</guimenu>
<guimenuitem>Link...</guimenuitem>
</menuchoice> from the menubar. This will bring up a small dialog box.</para>

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

<para>Using the icon bar on the left, choose which link type you want to insert.</para>
<para>In the comment field, type the text you want to appear in your web document (for example:  The KOffice Web Site).</para>
<para>In the address field, type the Internet address, email address or
file location you want the comment to be linked with (for example:  http://www.koffice.org) </para>
<para>Click <guibutton>OK</guibutton>.</para>
<note><para>By default, &kword; displays links underlined (as in most browsers).  You can turn this behavior on and off by
selecting <menuchoice> <guimenu>Settings</guimenu><guimenuitem>Configure
&kword;...</guimenuitem></menuchoice> from the menubar and selecting the <guilabel>Misc</guilabel> page.  More information can be found
<link linkend="opt-misc">here</link>.</para></note>
</sect2>
<sect2 id="links-open"><title>Opening a document link</title>
<para>You can use a document link from within &kword;.</para>
<para>Simply click once on the document link with the &RMB;.  A popup menu will appear.  Select <guilabel>Open Link</guilabel>.</para>
<para>A document link to a web site will open a new browser window and take you directly to that web site.  A document link to an
email address, will open a new message in your email program.  A document link to a file will open the appropriate viewer or editor for 
that file type.</para>
</sect2>

<sect2 id="links-copy"><title>Copy a document link</title>
<para>You can use a document link in another application, by copying it from a &kword; document.</para>
<para>Simply click once on the document link with the &RMB;.  A popup menu will appear.  Select <guilabel>Copy Link</guilabel>.</para>
<para>The link address has now been inserted into the clipboard.  You can paste your clipboard entry into any other application.</para>
</sect2>
<sect2 id="links-edit"><title>Changing a document link</title>
<para>To change the details of a document link Simply click 
once on the document link with the &RMB;.  A popup menu will appear.  Select <guilabel>Change Link...</guilabel>.</para>
<para>The <guilabel>Insert Link</guilabel> dialog box will appear, with the current settings of the link displayed.</para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="linkdlg.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para>Make any appropriate changes and click <guibutton>OK</guibutton> to make your changes.</para>

</sect2><sect2 id="links-delete"><title>Deleting a document link</title>
<para>You can delete a document link like any other text in your document.</para>
<para>Simply place the cursor at the end of the document link, and press &Backspace;.  Alternatively, place 
the cursor at the beginning of the document link and press <keycap>Delete</keycap> on the keyboard. The document link is deleted in its entirety.</para>
</sect2>
<sect2 id="links-remove"><title>Converting a document link to text</title>
<para>If a document link is no longer needed as a link, but you want to preserve the text that is the link, click once on the document link with the &RMB;.  A popup menu will appear.  Select <guilabel>Remove Link...</guilabel>.  The linked text will now become plain text, and the link will be deleted.</para>

</sect2>



</sect1>
