mirror of
https://bitbucket.org/smil3y/kde-workspace.git
synced 2025-02-24 10:52:51 +00:00
391 lines
14 KiB
Text
391 lines
14 KiB
Text
<chapter id="config">
|
|
<title>Customizing &kde; software</title>
|
|
|
|
<sect1 id="toolbars">
|
|
<sect1info>
|
|
<authorgroup>
|
|
<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
|
|
<!-- TRANS:ROLES_OF_TRANSLATORS -->
|
|
</authorgroup>
|
|
</sect1info>
|
|
<title>Customizing Toolbars</title>
|
|
|
|
<!--FIXME link from korganizer config-toolbars section-->
|
|
<!--FIXME link from <sect2 id="configtoolbars"> in sheets/config.docbook> -->
|
|
<!--FIXME link from <sect2 id="configuration-toolbars"> in extragear/multimedia-git/kplayer/doc/en_US/configuration.docbook -->
|
|
<screenshot id="screenshot-toolbars-toolbar">
|
|
<screeninfo>The &gwenview; Toolbar</screeninfo>
|
|
<mediaobject>
|
|
<imageobject><imagedata fileref="toolbars-toolbar.png" format="PNG"/></imageobject>
|
|
<textobject><phrase>The &gwenview; toolbar.</phrase></textobject>
|
|
<caption><para>The toolbar in
|
|
<ulink url="http://kde.org/applications/graphics/gwenview/">&gwenview;</ulink>.
|
|
</para></caption>
|
|
</mediaobject>
|
|
</screenshot>
|
|
|
|
<sect2 id="toolbars-items">
|
|
<title>Modifying Toolbar Items</title>
|
|
|
|
<para>To customize an application's toolbars, go to
|
|
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
|
|
Toolbars...</guimenuitem></menuchoice> or right-click on a toolbar and select
|
|
<guimenuitem>Configure Toolbars...</guimenuitem>.</para>
|
|
|
|
<para>On the left side of the toolbar configuration panel, the available items
|
|
that you can put in your toolbar are shown. On the right, the ones that already
|
|
appear on the toolbar are shown. At the top, you can select the toolbar
|
|
you wish to modify or view.</para>
|
|
|
|
<para>Above each side of the panel there is a <guilabel>Filter</guilabel> text
|
|
box you can use to easily find items in the list.</para>
|
|
|
|
<screenshot id="screenshot-toolbars-customize">
|
|
<screeninfo>The Customize Toolbars Window</screeninfo>
|
|
<mediaobject>
|
|
<imageobject><imagedata fileref="toolbars-configure.png" format="PNG"/></imageobject>
|
|
<textobject><phrase>The Customize Toolbars window.</phrase></textobject>
|
|
<caption><para>The Customize Toolbars window in &gwenview; with the
|
|
<guibutton>Previous</guibutton> button selected.</para></caption>
|
|
</mediaobject>
|
|
</screenshot>
|
|
|
|
<sect3 id="toolbars-items-add">
|
|
<title>Adding an Item</title>
|
|
<para>You can add an item to your toolbar by selecting it from the left side and
|
|
clicking on the right arrow button.</para>
|
|
</sect3>
|
|
|
|
<sect3 id="toolbars-items-remove">
|
|
<title>Removing an Item</title>
|
|
<para>You can remove an item by selecting it and clicking the left arrow
|
|
button.</para>
|
|
</sect3>
|
|
|
|
|
|
<sect3 id="toolbars-items-rearrange">
|
|
<title>Changing the Position of Items</title>
|
|
|
|
<para>You can change the position of the items by moving them lower or higher in
|
|
the list. To move items lower, press the down arrow button, while to move items
|
|
higher press the up arrow button. You can also change items' position by
|
|
dragging and dropping them.</para>
|
|
|
|
<para>On horizontal toolbars, the item that's on top will be the one on the left.
|
|
On vertical toolbars, items are arranged as they appear in the toolbar.</para>
|
|
|
|
</sect3>
|
|
|
|
<sect3 id="toolbars-items-separator">
|
|
<title>Adding a Separator</title>
|
|
<para>You can add separator lines between items by adding a
|
|
<guilabel>--- separator ---</guilabel> item to the toolbar.</para>
|
|
</sect3>
|
|
|
|
<sect3 id="toolbars-items-defaults">
|
|
<title>Restoring Defaults</title>
|
|
|
|
<para>You can restore your toolbar to the way it was when you installed the
|
|
application by pressing the <guibutton>Defaults</guibutton> button at the bottom
|
|
of the window and then confirming your decision.</para>
|
|
|
|
</sect3>
|
|
|
|
<sect3 id="toolbars-items-text-icons">
|
|
<title>Changing Text and Icons</title>
|
|
|
|
<para>You can change the icon and text of individual toolbar items by selecting
|
|
an item and clicking either the <guibutton>Change Icon...</guibutton> or
|
|
<guibutton>Change Text...</guibutton> button.</para>
|
|
<!--FIXME Icon selection and icon categories -> own section?
|
|
Change Text -> Option "Hide text when toolbar shows text alongside icons"
|
|
-->
|
|
</sect3>
|
|
</sect2>
|
|
|
|
<sect2 id="toolbars-appearance">
|
|
<title>Customizing Toolbar Appearance</title>
|
|
|
|
<para>You can change the appearance of toolbars by right-clicking on a toolbar
|
|
to access it's context menu.</para>
|
|
<!-- settings for each toolbar separately-->
|
|
<sect3 id="toolbars-appearance-text-position">
|
|
<title>Text Position</title>
|
|
|
|
<para>You can change the appearance of text on toolbars in the
|
|
<guisubmenu>Text Position</guisubmenu> submenu of a toolbar's context menu.</para>
|
|
|
|
<para>You can choose from:</para>
|
|
<itemizedlist>
|
|
|
|
<listitem><para>
|
|
<guimenuitem>Icons</guimenuitem> -
|
|
only the icon for each toolbar item will appear.
|
|
</para></listitem>
|
|
|
|
<listitem><para>
|
|
<guimenuitem>Text</guimenuitem> -
|
|
only the text label for each toolbar item will appear.
|
|
</para></listitem>
|
|
|
|
<listitem><para>
|
|
<guimenuitem>Text Alongside Icons</guimenuitem> -
|
|
<!--this may need to be changed to 'left' for RTL languages-->
|
|
the text label will appear to the right of each toolbar item's icon
|
|
</para></listitem>
|
|
|
|
<listitem><para>
|
|
<guimenuitem>Text Under Icons</guimenuitem> -
|
|
the text label will appear underneath each toolbar item's icon
|
|
</para></listitem>
|
|
|
|
</itemizedlist>
|
|
|
|
<para>You can also show or hide text for individual toolbar items by
|
|
right-clicking on an item and checking or unchecking the item under
|
|
<guilabel>Show Text</guilabel>.</para>
|
|
|
|
</sect3>
|
|
|
|
<sect3 id="toolbars-appearance-icon-size">
|
|
<title>Icon Size</title>
|
|
|
|
<para>You can change the size of toolbar items' icons by selecting
|
|
<guisubmenu>Icon Size</guisubmenu> from the toolbar's context menu.</para>
|
|
|
|
<para>You can choose from the following options: (each lists the icon size
|
|
in pixels)</para>
|
|
|
|
<itemizedlist>
|
|
<listitem><para><guimenuitem>Small (16x16)</guimenuitem></para></listitem>
|
|
<listitem><para><guimenuitem>Medium (22x22)</guimenuitem>
|
|
[the default value]</para></listitem>
|
|
<listitem><para><guimenuitem>Large (32x32)</guimenuitem></para></listitem>
|
|
<listitem><para><guimenuitem>Huge (48x48)</guimenuitem></para></listitem>
|
|
</itemizedlist>
|
|
|
|
</sect3>
|
|
|
|
<sect3 id="toolbars-appearance-move">
|
|
<title>Moving Toolbars</title>
|
|
|
|
<para>In order to move toolbars, you must <quote>unlock</quote> them. To do
|
|
so, uncheck <guimenuitem>Lock Toolbar Positions</guimenuitem> from a toolbar's
|
|
context menu. To restore the lock, simply recheck this menu item.</para>
|
|
|
|
<para>You can change a toolbar's position from the
|
|
<guisubmenu>Orientation</guisubmenu> submenu of its context menu.</para>
|
|
|
|
<para>You can choose from:</para>
|
|
<itemizedlist>
|
|
<listitem><para><guimenuitem>Top</guimenuitem>
|
|
[the default in many applications]</para></listitem>
|
|
<listitem><para><guimenuitem>Left</guimenuitem></para></listitem>
|
|
<listitem><para><guimenuitem>Right</guimenuitem></para></listitem>
|
|
<listitem><para><guimenuitem>Bottom</guimenuitem></para></listitem>
|
|
</itemizedlist>
|
|
|
|
<para>You can also move a toolbar by clicking and holding onto the dotted line
|
|
at the left of horizontal toolbars or the top of vertical toolbars and dragging
|
|
it to your desired location.</para>
|
|
|
|
</sect3>
|
|
|
|
<sect3 id="toolbars-appearance-show-hide">
|
|
<title>Show/Hide Toolbars</title>
|
|
|
|
<para>If your application has only one toolbar, you can hide a toolbar by
|
|
deselecting <guimenuitem>Show Toolbar</guimenuitem> from either the toolbar's
|
|
context menu or the <guimenu>Settings</guimenu> menu. To restore the toolbar,
|
|
select <guimenuitem>Show Toolbar</guimenuitem> from the <guimenu>Settings</guimenu>
|
|
menu. Note that toolbars must be <quote>unlocked</quote> to hide them from their
|
|
context menu; see <xref linkend="toolbars-appearance-move"/> for more
|
|
information.</para>
|
|
|
|
<para>If your application has more than one toolbar, a submenu called
|
|
<guisubmenu>Toolbars Shown</guisubmenu> will appear in the context menu and
|
|
<guimenu>Settings</guimenu> menu instead of the above menu entry. From that
|
|
menu you may select individual toolbars to hide and show.</para>
|
|
|
|
</sect3>
|
|
</sect2>
|
|
|
|
<sect2 id="toolbars-ack">
|
|
<title>Thanks and Acknowledgments</title>
|
|
<para>Thanks to an anonymous Google Code-In 2011 participant for writing much
|
|
of this section.</para>
|
|
</sect2>
|
|
|
|
</sect1>
|
|
|
|
|
|
<sect1 id="shortcuts">
|
|
<sect1info>
|
|
<authorgroup>
|
|
<author><firstname>Alexey</firstname> <surname>Subach</surname></author>
|
|
<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
|
|
<!-- TRANS:ROLES_OF_TRANSLATORS -->
|
|
</authorgroup>
|
|
</sect1info>
|
|
|
|
<!--FIXME link from
|
|
<sect2 id="configshort"> in tables/config.docbook>
|
|
<sect2 id="configuration-shortcuts"> in extragear/multimedia-git/kplayer/doc/en_US/configuration.docbook
|
|
-->
|
|
<!--FIXME explain Alternate + Global shortcuts in Screenshot and
|
|
another place to change Global Shortcuts (Systemsettings)-->
|
|
<title>Using and Customizing Shortcuts</title>
|
|
|
|
<sect2 id="shortcuts-intro">
|
|
<title>Introduction</title>
|
|
|
|
<para>Many &kde; applications allow you to configure keyboard shortcuts. To open
|
|
the standard keyboard shortcuts configuration panel, go to
|
|
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
|
|
Shortcuts...</guimenuitem></menuchoice>.</para>
|
|
|
|
<para>In the Configure Shortcuts window, you will see a list of all the shortcuts
|
|
available in the current application. You can use the search box at the top to
|
|
search for the shortcut you want.</para>
|
|
|
|
<screenshot id="screenshot-shortcuts-search">
|
|
<screeninfo>The Customize Shortcuts Window</screeninfo>
|
|
<mediaobject>
|
|
<imageobject><imagedata fileref="shortcuts-search.png" format="PNG"/></imageobject>
|
|
<textobject><phrase>The Customize Shortcuts window.</phrase></textobject>
|
|
<caption><para>Searching for shortcuts with <userinput>file</userinput> in
|
|
<ulink url="http://kde.org/applications/system/dolphin/">&dolphin;</ulink>.
|
|
</para></caption>
|
|
</mediaobject>
|
|
</screenshot>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="shortcuts-change">
|
|
<title>Changing a Shortcut</title>
|
|
|
|
<para>To change a shortcut, first click on the name of a shortcut you want to change.
|
|
You will see a radio group where you can choose whether to set the shortcut to its
|
|
default value, or select a new shortcut for the selected action. To set a new shortcut,
|
|
choose <guilabel>Custom</guilabel> and click on the button next to it. Then just
|
|
type the shortcut you would like to use, and your changes will be saved.</para>
|
|
|
|
<screenshot id="screenshot-shortcuts-set">
|
|
<screeninfo>Setting a Shortcut</screeninfo>
|
|
<mediaobject>
|
|
<imageobject><imagedata fileref="shortcuts-set.png" format="PNG"/></imageobject>
|
|
<textobject><phrase>The Customize Shortcuts window demonstrating how to
|
|
set a shortcut.</phrase></textobject>
|
|
</mediaobject>
|
|
</screenshot>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="shortcuts-reset">
|
|
<title>Resetting Shortcuts</title>
|
|
<para>There is a button at the bottom of the window, called <guibutton>Reset to
|
|
Defaults</guibutton>. Clicking on this button will reset all your custom shortcuts
|
|
to their default values.</para>
|
|
|
|
<para>You can also reset an individual shortcut to its default value by selecting
|
|
it, and choosing the <guilabel>Default</guilabel> radio button.</para>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="shortcuts-delete">
|
|
<title>Removing a Shortcut</title>
|
|
|
|
<para>To remove a shortcut, select it from the list, then click the remove icon (a
|
|
black arrow with a cross) to the right of the button that allows you to select
|
|
a shortcut.</para>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id ="shortcuts-schemes">
|
|
<title>Working with Schemes</title>
|
|
|
|
<para>Schemes are keyboard shortcuts configuration profiles, so you can create
|
|
several profiles with different shortcuts and switch between these profiles
|
|
easily.</para>
|
|
|
|
<warning><para>This feature is under development. It is not possible to import
|
|
schemes using a &GUI; at this time.</para></warning>
|
|
|
|
<screenshot id="screenshot-shortcuts-schemes">
|
|
<screeninfo>Working with Schemes</screeninfo>
|
|
<mediaobject>
|
|
<imageobject><imagedata fileref="shortcuts-schemes.png" format="PNG"/></imageobject>
|
|
<textobject><phrase>The Customize Shortcuts window displaying the scheme
|
|
editing tools.</phrase></textobject>
|
|
<caption><para>Editing a scheme called <userinput>work</userinput>.</para></caption>
|
|
</mediaobject>
|
|
</screenshot>
|
|
|
|
<para>To see a menu allowing you to edit schemes, click on the
|
|
<guibutton>Details</guibutton> button at the bottom of the form. The following
|
|
options will appear:</para>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Current Scheme</guilabel></term>
|
|
<listitem><para>Allows you to switch between your schemes.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guibutton>New...</guibutton></term>
|
|
<listitem><para>Creates a new scheme. This opens a window that lets you select
|
|
a name for your new scheme.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guibutton>Delete</guibutton></term>
|
|
<listitem><para>Deletes the current scheme.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guibutton>More Actions</guibutton></term>
|
|
<listitem>
|
|
<para>Opens the following menu:</para>
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><guimenuitem>Save as Scheme Defaults</guimenuitem></term>
|
|
<listitem><para>Sets the current scheme as the default for all new schemes.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guimenuitem>Export Scheme...</guimenuitem></term>
|
|
<listitem><para>Exports the current scheme to a file named <filename><replaceable>applicationname</replaceable><replaceable>schemename</replaceable>shortcuts.rc</filename>.</para>
|
|
<para>
|
|
Move this file to the folder <filename class="directory">$KDEDIR/apps/applicationname/</filename>
|
|
and the exported scheme will be available in the drop down box labelled <guilabel>Current Scheme</guilabel>
|
|
</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="shortcuts-print">
|
|
<title>Printing Shortcuts</title>
|
|
|
|
<para>You can print out a list of shortcuts for easy reference by clicking the
|
|
<guibutton>Print</guibutton> button at the bottom of the window.</para>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="shortcuts-ack">
|
|
<title>Thanks and Acknowledgments</title>
|
|
|
|
<para>Special thanks to Google Code-In 2011 participant Alexey Subach for
|
|
writing much of this section.</para>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|
|
|
|
</chapter>
|