diff options
Diffstat (limited to 'doc/userguide/programs-and-documents.docbook')
| -rw-r--r-- | doc/userguide/programs-and-documents.docbook | 540 |
1 files changed, 0 insertions, 540 deletions
diff --git a/doc/userguide/programs-and-documents.docbook b/doc/userguide/programs-and-documents.docbook deleted file mode 100644 index 60ced60d3..000000000 --- a/doc/userguide/programs-and-documents.docbook +++ /dev/null @@ -1,540 +0,0 @@ -<chapter id="programs-and-documents"> - -<title>Programs and Documents</title> - -<sect1 id="programs-launching"> - -<title>Launching Programs</title> - -<para>&tde; offers a varying number of ways to launch programs. You may:</para> - <itemizedlist> - <listitem> - <para>Simply select the relevant item in the &kmenu;.</para> - </listitem> - <listitem> - <para>Run the program from &konsole;, or by clicking the &kmenu; and choosing <guimenuitem>Run Command...</guimenuitem> (while you still might prefer the quick keyboard shortcut, which is simply <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo>).</para> - </listitem> - <listitem> - <para>Create a shortcut on the desktop or use &kicker;'s quick launcher.</para> - </listitem> -</itemizedlist> - -<para>The &kmenu; functions much like the Start menu of &Windows;, however -it breaks programs up by what they do. Programs on the &kmenu; are broken -into category menus, such as <guisubmenu>Multimedia</guisubmenu> and -<guisubmenu>Office</guisubmenu>. Under these category menus there are -subcategory menus, such as <guisubmenu>Sound</guisubmenu>, -<guisubmenu>Video</guisubmenu> and <guisubmenu>Graphics</guisubmenu>. Under -the subcategory menus lie program launchers, which, when clicked on, launch -the associated application.</para> - -<para>Depending on the program, there may not be a launcher in the &kmenu;. -To search your hard drive for more applications, click the &kmenu;, choose -<guimenuitem>Run Command</guimenuitem> and type -<userinput><command>kappfinder</command></userinput>. In -&kappfinder;, click <guibutton>Scan</guibutton>, and the hard drive will be -searched for programs. Click the checkbox next to each program to be added -to the &kmenu;, and click <guibutton>Apply</guibutton> and -<guibutton>Close</guibutton>. The &kmenu; now will have new program -launchers under the relevant category menus.</para> - -<para>Launchers to programs may also be placed on the desktop. To create a -new launcher, <mousebutton>right</mousebutton> click on the desktop, and -choose <menuchoice><guimenu>Create -New</guimenu><guimenuitem>Link to -Application</guimenuitem></menuchoice>. On the &kdesktop; properties dialog -box, type in the name of the program on the <guilabel>General</guilabel> -tab. You may also wish to choose a custom icon by clicking on the gear icon. -Click the <guilabel>Application</guilabel> tab and type a short sentence -about the program in the <guilabel>Description</guilabel> textbox. In the -<guilabel>Command</guilabel> textbox, type the name of the program (case -sensitive), and any command line options you wish to use. Choose -<guibutton>OK</guibutton>, and your new program launcher will be created on -your desktop. Simply click on the new launcher on the desktop and the - associated program will run.</para> - -<para>To launch a program using &konsole;, click the &kmenu; and choose -<menuchoice><guisubmenu>System</guisubmenu><guisubmenu>Terminals -</guisubmenu><guimenuitem>Konsole</guimenuitem></menuchoice>. Once &konsole; -appears on the screen, simply type the name of the program you wish to -launch (remembering that <application>bash</application>, the command language interpreter that &konsole; uses by default, is case-sensitive) and press -<keycap>Enter</keycap>. If you are unsure about the name of a program, type -the first few letters then press the 	 key on your keyboard. By pressing -	, <application>bash</application> (through &konsole;) will try to guess the name of the program you wish to -launch. If it finds more then one matching program, a list of - matching programs will be printed on the screen. Type the name of the - program from the list and press <keycap>Enter</keycap> to launch.</para> - -<para>Whichever way you choose, launching a program is a simple affair with -&tde;. From the &kmenu;, to &konsole;, all your programs are just a few -clicks or key-presses away.</para> - -<!-- Add links to "further reading" here --> -<itemizedlist> -<title>Related Information</title> -<listitem><para>Check the &kicker; handbook for more information on enabling or disabling the &kmenu;, adding applications to the quick launch, or on organizing the categorization of the applications in the &kmenu;. You can view the &kicker; handbook either via the &khelpcenter; or by using &konqueror;'s KIOslave by typing <userinput>help:/kicker</userinput> in the Location toolbar.</para> -</listitem> -</itemizedlist> - - - -</sect1> - -&programs-controlling; - -<sect1 id="programs-save-open"> - -<title>Opening and Saving Files</title> -<!-- TODO: Convert this whole thing to an image with callouts. It --> -<!-- should be much nicer that way. --> - - -<para>&tde; provides a unified way to open or save files via the file -dialog. In almost every &tde; program you will find a -<menuchoice><guimenu>File</guimenu><guimenuitem>Open</guimenuitem> -</menuchoice> and <menuchoice><guimenu>File</guimenu> -<guimenuitem>Save</guimenuitem></menuchoice> (and/or <guimenuitem>Save -As...</guimenuitem>) entry.</para> - -<sect2 id="file-dialog"> -<title>The File Dialog</title> - -<!-- -<screenshot> -<screeninfo>The &tde; <quote>Open File</quote> dialog</screeninfo> -<mediaobject> -<imageobject> -<imagedata fileref="open-file-dialog.png" format="PNG"/> </imageobject> -<textobject> -<phrase>The &tde; <quote>Open File</quote> dialog</phrase> -</textobject> -<caption> -<para>The &tde; <quote>Open File</quote> dialog</para> -</caption> -</mediaobject> -</screenshot> ---> -<screenshot> -<mediaobjectco> -<imageobjectco> -<areaspec units="calspair"> -<area id="navigation-area-co" coords="1 1"/> -<area id="icon-view-co" coords="1 1"/> -<area id="bottom-area-co" coords="1 1"/> -<area id="quick-access-co" coords="1 1"/> -<area id="preview-area-co" coords="1 1"/> -</areaspec> -<imageobject> -<imagedata fileref="open-file-dialog.png" format="PNG"/> -</imageobject> -</imageobjectco> -</mediaobjectco> -</screenshot> - -<!-- ====================================================================== - -<calloutlist> - -<callout arearefs="pt-first-channel-1"><para>This is called the <interface>Input Line</interface>. To send a message to everyone in the channel, type the message here and press &Enter;. - Your message, as well as everyone else's messages appear in the channel scroll above. - Each message is preceded by the time and user's &nickname;.</para></callout> - - -</calloutlist> - - - ====================================================================== --> -<para>This dialog consists of between three and five areas. The -top area is where you find the navigation and configuration functions. The -main area (in the middle) is where all your files are being displayed as -icons. This is called an icon view. The bottom area is where you can edit -filename or filter expressions and say <guibutton>Save</guibutton> or -<guibutton>Open</guibutton>.</para> - -<para>In addition to that you can add two even more sophisticated areas: -the <link linkend="quick-access">Quick Access Navigation Panel</link> and -the <link linkend="preview-area">Preview Panel</link>.</para> - -<calloutlist> - -<callout arearefs="navigation-area-co"> - -<para>Next to the three navigation buttons (one directory -<guiicon>up</guiicon>, <guiicon>back</guiicon> and -<guiicon>forward</guiicon>) and the <guiicon>new folder</guiicon> button -there is the <guiicon>bookmarks</guiicon> menu. Here you can mark any folder -you visit often to find it quickly. The <guiicon>wrench</guiicon> icon holds -the different functions to sort your files by name, date or size and to -enable the two extra panels mentioned above. Next to it you can type the -directory and choose (on the very right side) the encoding.</para> -</callout> - - -<callout arearefs="icon-view-co"> - -<para>You'll find the icon view in the middle of the dialog. You will find -most of the navigation functions in the context menu by clicking on the -items or the background with the <mousebutton>right</mousebutton> mouse -button.</para> - -</callout> - -<callout arearefs="bottom-area-co"> - - -<para>The bottom of the dialog consists of the address field holding the -file name you chose or typed in and the maybe most powerful tool: The -filter. Here you can make the icon view display only items that match the -criteria you define. Try filtering files whose names contain -<quote>air</quote> by typing <userinput>*air*</userinput> into the filter -field.</para> - -</callout> - -<callout arearefs="quick-access-co"> - -<anchor id="quick-access"/> - -<para>The Quick Access Panel (activate it by typing the -<keycap>F9</keycap> key on your keyboard or through the wrench icon on top -of the dialog) provides configurable shortcuts to frequently used -locations on your hard drive or even on the Internet. There are several -preconfigured locations such as your home directory. Try right clicking on -any item to configure it or to empty space to add a new entry. You will be -shown a context menu. Here you can choose the icon size and to add, modify -or rename any entry. Choose <guimenuitem>Add Entry</guimenuitem> and you -will see a window containing anything you need: Type your description, enter -the location (or choose it via the dialog opening by clicking on the -folder symbol), choose a symbol from a vast variety in the symbol dialog -opening when you click on the predefined icon (usually a simple folder -symbol).</para> - -</callout> - -<callout arearefs="preview-area-co"> - -<anchor id="preview-area"/> -<para>The Preview area (activate it by typing the <keycap>F11</keycap> -key on your keyboard or via the wrench icon on top of the dialog) -makes it easy to preview almost any file on your filesystem. Images -will be displayed as thumbnails. Usually also sound files (such as -MP3, Ogg or Wave-Files), text files (among them raw text, PDF and -&HTML;) and even video files (MPG, AVI and so on) will be -previewed.</para> - -<note><para>Note that large files might take a long time to be previewed -(⪚ scaled down if they are large images). You can disable automatic -previews by unselecting <guilabel>Automatic Preview</guilabel> below the -preview. You can still preview individual files: just click <guibutton>Preview</guibutton>. You can also disable previews for files above a certain -size. Go to &kcontrolcenter;, choose <menuchoice><guilabel>TDE -components</guilabel><guilabel>File manager</guilabel></menuchoice>, go to -the <guilabel>Preview and Metafiles</guilabel> tab and change the -<guilabel>Maximum Filesize</guilabel> value.</para></note> - -</callout> -</calloutlist> - -<!-- Add links to "further reading" here --> -<!--<itemizedlist> -<title>Related Information</title> -<listitem><para>to be written</para> -</listitem> -</itemizedlist>--> - - - </sect2> - - -</sect1> - -<sect1 id="configuring-programs"> - -<title>Configuring Programs</title> - -<sect2 id="configure-kapp"> -<title>Application Configuration</title> -<!-- FIXME: Make a more friendly title --> -<indexterm><primary>Configuration</primary></indexterm> -<indexterm><primary>Customization</primary></indexterm> - -<para>&tde; applications are intended to be as useful and usable as -possible <quote>out of the box</quote>, but they also offer a wide -range of options which you can change to make &tde; work for you. As -well as the settings which affect the whole of &tde; (see <xref -linkend="control-center"/>), each application has a set of -configuration options, which you can access using the menu option -<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure -<replaceable>Application</replaceable></guimenuitem> -</menuchoice>. This is the same for all &tde; applications, which -makes it easy to find the configuration dialog for an -application.</para> - -<!-- TODO: Screenie of a typical config dialog --> - -<para>On the left of the configuration dialog is a list of -sections. Clicking on one of these sections displays the configuration -page for that section on the right-hand side of the dialog. You can -change these options to fit your preferences.</para> - -<para>When you have made the changes you want, you can click on -<guibutton>OK</guibutton> to save your changes and close the -configuration dialog. If you want to see the effect of your changes, -but not close the configuration dialog, click on the -<guibutton>Apply</guibutton> button. This is useful if you aren't sure -about the change you've made, and might want to change back, because -the dialog is still open, ready for you to do so.</para> - -<para>If you decide that you don't want to keep the changes you've -made, just click <guibutton>Cancel</guibutton> to close the dialog -without saving your changes.</para> - -</sect2> - -<sect2 id="configure-shortcuts"> -<title>Configuring Keyboard Shortcuts</title> - -<indexterm><primary>Shortcuts</primary></indexterm> -<indexterm><primary>Keybindings</primary></indexterm> - -<para>Most &tde; applications offer keyboard shortcuts for the main -actions in the application. If you find that you don't like the -default keyboard shortcuts, or that they conflict with the shortcuts -of another application (maybe one that's not part of &tde;), you can -change them with the -<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure -Shortcuts...</guimenuitem> -</menuchoice> menu entry. This brings up the -<guilabel>Configure Shortcuts</guilabel> dialog for the -application. As an example of how to use this dialog, let's add a -shortcut for the <guimenuitem>Send Link Address...</guimenuitem> action to -&konqueror;, so that we can email the locations of interesting pages -to friends just by hitting a key (or two): </para> -<procedure> -<step><para>Open the <guilabel>Configure Shortcuts</guilabel> -dialog in &konqueror;, as described above.</para> -</step> -<step><para>Click on the <guilabel>Send Link Address...</guilabel> item -in the main listbox (it's near the bottom, in the -<guilabel>Konqueror</guilabel> section).</para> -</step> -<step><para>In the <guilabel>Shortcut for Selected -Action</guilabel> panel, select <guilabel>Custom</guilabel>, since we -are going to give this action a keyboard shortcut that we have chosen.</para> -</step> -<step><para>A small shortcut entry dialog pops up. Just hit -<keycombo action="simul">&Ctrl;<keycap>E</keycap> -</keycombo> (or whatever you want to change the shortcut to), and the -dialog disappears. The <quote>key</quote> icon in the -<guilabel>Configure Shortcuts</guilabel> dialog now shows the new -shortcut.</para> -</step> -<step><para>If you made a mistake, or change your mind about what -to use as the shortcut, just click on the key icon showing the current -shortcut. The shortcut entry dialog reappears, and you can press the -key combination for the shortcut you want.</para> -</step> -</procedure> - -<!-- TODO: Screenie --> - -</sect2> - -<sect2 id="configure-notifications"> -<title>Configuring Notifications</title> - -<indexterm><primary>Notifications</primary></indexterm> -<indexterm><primary>Sounds</primary></indexterm> - -<para>Something about -<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Notifications...</guimenuitem> -</menuchoice>.</para> -</sect2> - - -<sect2 id="configuring-toolbars"> -<sect2info> -<author> -<firstname>Adriaan</firstname> -<surname>de Groot</surname> -</author> -</sect2info> -<title>Configuring Toolbars</title> - -<para>Nearly every &tde; application has one or more toolbars at the top of -the application window, underneath the menu. The toolbar contains icons -(toolbar buttons) that represent commonly used actions and configuration -settings. The &kmail; window, for instance, has a toolbar that contains -buttons for <guiicon>New Message</guiicon>, <guiicon>Check Mail</guiicon> -and several others. Each of these actions is something you do often, so -that's why they have toolbar buttons as well as menu entries (<guiicon>New -Message</guiicon> is under -<menuchoice><guimenu>Message</guimenu><guimenuitem>New -Message</guimenuitem></menuchoice>, <guiicon>Check Mail</guiicon> is -<menuchoice><guimenu>File</guimenu><guimenuitem>Check -Mail</guimenuitem></menuchoice>).</para> - -<para>Not everybody agrees on what actions are commonly used, though, (I -never use the <guiicon>New Message</guiicon> toolbar button or the menu -item, I use the keyboard shortcut <keycombo -action="simul">&Ctrl;<keycap>N</keycap></keycombo>). To ensure that your -screen isn't cluttered with things you don't need, each toolbar can be -customized. Additionally, you can usually customize which toolbars are -displayed and how, as well.</para> - -<sect3 id="customizing-toolbar-displays"> -<title>Customizing Toolbar Displays</title> - -<para>The easiest thing to customize with the toolbars of any given -application is whether they are displayed at all. Most applications have a -<menuchoice><guimenu>Settings</guimenu><guisubmenu>Toolbars</guisubmenu> -</menuchoice> menu where you can select which toolbars are displayed and -which are not. &konqueror; has four toolbars, <interface>Main</interface>, -<interface>Extra</interface>, <interface>Location</interface> and -<interface>Bookmark</interface>. It can be convenient to turn off the -<interface>Bookmark</interface> toolbar to save -screen space. To do so, click on the <guimenu>Settings</guimenu> menu, -choose <guisubmenu>Toolbars</guisubmenu>, and then uncheck the -<guimenuitem>Bookmark Toolbar</guimenuitem> entry (do this just by clicking -on the menu item).</para> - -<para>If there is no <guimenu>Settings</guimenu> menu, you can also -<mousebutton>right</mousebutton> click on the toolbar itself, and choose the -<guisubmenu>Toolbars</guisubmenu> sub-menu from the resulting context -menu.</para> - -<para>The same <guimenu>Toolbar</guimenu> context menu, accessed by -<mousebutton>right</mousebutton> clicking on the toolbar, allows you to -customize other properties of the toolbar:</para> - -<itemizedlist> -<listitem> -<para>Its orientation, so that instead of appearing at the top of the -window under the menu bar you can place it on the left, right or bottom of -the window.</para> -</listitem> -<listitem> -<para>Its orientation, so that the toolbar <quote>floats</quote> as a -separate window which you can move independently.</para> -</listitem> -<listitem> -<para>Its orientation, so that the toolbar is squashed into a little flat -grip that you can re-open by double-clicking on it (this is subtly -different from making the toolbar vanish completely, since it it easier to -cause it to re-appear).</para> -</listitem> -<listitem> -<para>The appearance of text alongside, underneath, or instead of the icons -on the toolbar.</para> -</listitem> -<listitem> -<para>The size of the icons (if they are not supplanted by -text).</para> -</listitem> -</itemizedlist> -</sect3> - -<sect3 id="customizing-icons-on-toolbar"> -<title>Customizing the Icons on the Toolbar</title> - -<para>The toolbar is intended for actions that you perform often, so what do -you do if there is some useless icon there, like <guiicon>Cut</guiicon>? Or -what if you really want a <guiicon>cut</guiicon> button on the toolbar, but -the application doesn't give you one? This is where the customize toolbars -dialog comes in — it give you complete control over the actions that -are available on each toolbar.</para> - -<para>Choose <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure -Toolbars</guimenuitem></menuchoice> from the application's menu, or -<guimenuitem>Configure Toolbars</guimenuitem> from the context menu of the -toolbar itself. This displays the configure toolbars dialog, which consists -of a combobox <!-- drop-down box? --> with which you can select -<emphasis>which</emphasis> toolbar to customize, and two lists of items -— one of the available actions, and one of the actions that are -already in use on the toolbar.</para> - -<para>Often there are many many more actions available ( <guiicon>activate -tab #12</guiicon>, for instance) than you would ever want on the toolbar, or -even that you know exist in the application. The customize toolbar dialog -can be a learning experience. You can drag actions from one list box to the -other, rearrange the items on the toolbar <!-- in the list box on the right -..... not sure if I should be LTR-centric -->, or change the icon for a -selected action. This allows you to drag the actions you don't want off of -the toolbar and into the list of available actions; similarly, the actions -you do want can be dragged into the toolbar. Clicking -<guibutton>OK</guibutton> in the dialog immediately updates the toolbar with -your new preferred actions.</para> - -<para>There are a few special items that can end up in the listbox for the -current toolbar:</para> - -<itemizedlist> -<listitem> -<para>separators, which exist in two flavors: -<itemizedlist> -<listitem><para><guilabel>line separator</guilabel> appears as a line -between two action icons</para> -</listitem> -<listitem><para><guilabel>separator</guilabel> appears as a larger -space between two action icons</para> -</listitem> -</itemizedlist> -</para> -</listitem> -<listitem> -<para><guilabel><Merge></guilabel>, which is a special item that -allows plugins and other loadable components of the application to insert -their actions into the toolbar as well. It is generally not a good idea to -remove this, since you cannot get it back.</para> -</listitem> -<listitem> -<para><guilabel>ActionList:</guilabel>, these appear in various flavors -(there is a viewmode_toolbar one in &konqueror;) and again these -represent lists of actions that might be inserted by -plugins.</para> -</listitem> -</itemizedlist> - -<para>Whenever you click on an action in the list of current actions, a -description of it is shown in the dialog. This description will warn you if -it is a bad idea to remove the action.</para> - -<para>If you do not like to drag things around, there are four buttons in -the middle of the dialog which allow you to move the selected action from -one list to the other, and to move a selected current action up or down in -the list. There must be a way to restore the default toolbars in an -application, in order to recover from accidentally deleting an important -action like <guilabel><Merge></guilabel>, but I don't know what it -is.</para> - -<!-- Add links to "further reading" here --> -<!-- <itemizedlist> -<title>Related Information</title> -<listitem><para>to be written</para> -</listitem> -</itemizedlist>--> - - -</sect3> -</sect2> - -</sect1> - -</chapter> - -<!-- Keep this comment at the end of the file -Local variables: -mode: xml -sgml-omittag:nil -sgml-shorttag:nil -sgml-namecase-general:nil -sgml-general-insert-case:lower -sgml-minimize-attributes:nil -sgml-always-quote-attributes:t -sgml-indent-step:0 -sgml-indent-data:true -sgml-parent-document:("index.docbook" "book" "sect1") -sgml-exposed-tags:nil -sgml-local-catalogs:nil -sgml-local-ecat-files:nil -End: ---> |