<sect1 id="doc-structure"> <sect1info> <authorgroup> <author> <firstname>Mike</firstname> <surname>McBride</surname> </author> <!-- TRANS:ROLES_OF_TRANSLATORS --> </authorgroup> </sect1info> <title><guilabel>Document Structure</guilabel></title> <indexterm><primary>document structure</primary></indexterm> <para>Sometimes, when editing a complicated document, it can be helpful to look at an organized view of your document.</para> <para>You can use this organized view to jump immediately to certain text frames, select picture frames, change frame properties, delete frames, or simply review your document.</para> <sect2 id="doc-structure-view"> <title>Show and hide <guilabel>Document Structure</guilabel> area</title> <para>Because simple documents do not need the information provided in the <guilabel>Document Structure</guilabel> area, &kword; has the ability to toggle the <guilabel>Document Structure</guilabel> area on and off.</para> <para>To toggle the <guilabel>Document Structure</guilabel> area on and off, select <menuchoice> <guimenu>View</guimenu><guimenuitem>Show Doc Structure</guimenuitem> </menuchoice> from the menubar to make the <guilabel>Document Structure</guilabel> area visible. Select <menuchoice> <guimenu>View</guimenu><guimenuitem>Hide Doc Structure</guimenuitem> </menuchoice> from the menubar to make the <guilabel>Document Structure</guilabel> area disappear.</para> <para>You can move focus to the document structure area by pressing <keycombo>&Alt;<keycap>1</keycap></keycombo>. You can move focus to the main document panel by pressing <keycombo>&Alt;<keycap>2</keycap></keycombo>. </para> </sect2> <sect2 id="doc-structure-navigate"> <title>Navigating the document structure area</title> <para>Lets examine a sample <guilabel>Document Structure</guilabel> area.</para> <screenshot> <mediaobject> <imageobject> <imagedata fileref="docstruct.png" format="PNG"/></imageobject> </mediaobject> </screenshot> <para>As you can see, there are five groups of frames categorized (<guilabel>Text Frames/Frame Sets</guilabel> <guilabel>Pictures</guilabel>, <guilabel>Tables</guilabel>, <guilabel>Formula Frames</guilabel>, <guilabel>Embedded Objects</guilabel>).</para> <variablelist> <varlistentry> <term><guilabel>Text Frames/Frame Sets</guilabel></term> <listitem><para>Within this category, is a list of all text framesets. Below each frameset, each frame is listed. Below each frame, each paragraph is listed.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Pictures</guilabel></term> <listitem><para>Within this category is a list of all frames that contain pictures, and the folder the pictures were loaded from.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Tables</guilabel></term> <listitem><para>Within this category is a list of all frames that contain tables. Note that a table behaves very much like a frameset. Each cell of the table is a frame, and each frame may contain multiple paragraphs.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Formula Frames</guilabel></term> <listitem><para>Within this category is a list of all frames that contain formulas.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Embedded Objects</guilabel></term> <listitem><para>Within this category, is an alphabetical list of all frames that contain data from other &koffice; applications.</para></listitem> </varlistentry> </variablelist> <para>You can use your mouse to select the category you want, or first put focus in the document structure area (press <keycombo>&Alt;<keycap>1</keycap></keycombo>) then use the up and down arrow keys to scroll through the list. Double click on a category to expand or collapse the category, or press the right or left arrow keys.</para> <note><para>Depending on your document, you may not have all categories in your <guilabel>Document Structure</guilabel> area. The category only appears when there is <emphasis>at least one</emphasis> frame in the category.</para></note> </sect2> <sect2 id="doc-structure-edit"> <title>Edit a text frame, frameset, or paragraph using the document structure area</title> <para>To edit a text frame, frameset, or paragraph, click on the item with the &RMB; or scroll to the item and press the <keycap>Menu</keycap> key. A popup menu will appear. Select <guilabel>Edit Text</guilabel> from the menu.</para> </sect2> <sect2 id="doc-structure-speak"> <title>Speak the text of a text frame, frameset, or paragraph using the document structure area</title> <para>If you have the KTTS component installed in your system, you can have the computer speak the text of the document. To speak the text of a frame, frameset, or paragraph, click on the item with the &RMB; or scroll to the item and press the <keycap>Menu</keycap> key. A popup menu will appear. Select <guilabel>Speak Text</guilabel> from the menu.</para> <tip> <para>The <guilabel>Speak Text</guilabel> menu item will be disabled if KTTS is not installed in your system. </para> <para>If KTTS fails to speak the text, or speaks the text in the wrong language, make sure you have a <guilabel>Talker</guilabel> in KTTS configured with the correct language. See <ulink url="help:kttsd">The KTTS Handbook</ulink> for details. Also, make sure the <guilabel>Global Language</guilabel> is properly set in the &kword; settings. </para> </tip> </sect2> <sect2 id="doc-structure-show"><title>Jump to a frame, frameset, or paragraph using the document structure area</title> <para>To display a frame, frameset, or paragraph in the main document panel, click on the item with the &RMB; or scroll to the item and press the <keycap>Menu</keycap> key. A popup menu will appear. Select <guilabel>Show</guilabel> from the menu.</para> </sect2> <sect2 id="doc-structure-delete"><title>Delete frame or frameset using the document structure area</title> <para>To delete a frame or frameset, click on the frame title with the &RMB; or scroll to the frame title and press the <keycap>Menu</keycap> key. A popup menu will appear. Select <guilabel>Delete Frame</guilabel> from the menu.</para> </sect2> <sect2 id="doc-structure-properties"><title>Edit a frame or paragraph properties using the document structure area</title> <para>To change the properties of a frame or paragraph, click on the item with the &RMB; or scroll to the item and press the <keycap>Menu</keycap> key. A popup menu will appear. Select <guilabel>Properties</guilabel> from the menu.</para> </sect2> </sect1>