<?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY kappname "&systemsettings;"> <!ENTITY package "kdebase-workspace"> <!ENTITY % addindex "IGNORE"> <!ENTITY % English "INCLUDE"> ]> <book lang="&language;"> <bookinfo> <title>The &systemsettings; Handbook</title> <authorgroup> <author> &Richard.Johnson; &Richard.Johnson.mail; </author> <!-- TRANS:ROLES_OF_TRANSLATORS --> </authorgroup> <copyright> <year>2007</year> <holder>&Richard.Johnson;</holder> </copyright> <legalnotice>&FDLNotice;</legalnotice> <date>2010-10-05</date> <releaseinfo>1.0 (&kde; 4.6)</releaseinfo> <abstract> <para> This documentation describes &kde;'s system configuration and administration center. </para> </abstract> <keywordset> <keyword>KDE</keyword> <keyword>System</keyword> <keyword>Settings</keyword> <keyword>configuration</keyword> <keyword>administration</keyword> <keyword>config</keyword> <keyword>admin</keyword> </keywordset> </bookinfo> <chapter id="introduction"> <title>Introduction</title> <para> The &kde; &systemsettings; provides the user with a centralized and convenient way to configure all of the &kde; settings. </para> <para> &systemsettings; is made up of multiple modules. Each module is a separate application, however the &kde; &systemsettings; organizes all of these applications into a single location. </para> <tip> <para> Each &systemsettings; module can be executed individually </para> <para> See section entitled <link linkend="run-modules-individually">Running individual &systemsettings; modules</link> for more information. </para> </tip> <para> &systemsettings; groups all of the configuration modules into several categories: <itemizedlist> <listitem><para><link linkend="application-appearance">Common Appearance and Behavior</link></para></listitem> <listitem><para><link linkend="workspace-appearance">Workspace Appearance and Behavior</link></para></listitem> <listitem><para><link linkend="network">Network and Connectivity</link></para></listitem> <listitem><para><link linkend="hardware">Hardware</link></para></listitem> <listitem><para><link linkend="system-administration">System Administration</link></para></listitem> </itemizedlist> </para> <para> The modules that make up &systemsettings; fall under one of the above categories, making it easier to locate the correct configuration module. </para> </chapter> <chapter id="using-kapp"> <title>Using &systemsettings;</title> <para> This section details the use of &systemsettings; itself. For information on each individual module, please see <link linkend="modules">&systemsettings; Modules</link>. </para> <sect1 id="starting"> <title>Starting &systemsettings;</title> <para> The &kde; &systemsettings; can be started in one of three ways: </para> <orderedlist> <listitem> <para> By selecting <menuchoice><guimenu>K Button</guimenu><guisubmenu>Applications</guisubmenu><guimenuitem>System Settings</guimenuitem></menuchoice>. </para> </listitem> <listitem> <para> By pressing <keycombo>&Alt;<keycap>F2</keycap></keycombo>. This will bring up the &krunner; dialog. Type <command>systemsettings</command>, and press &Enter;. </para> </listitem> <listitem> <para> Type <command>systemsettings &</command> at any command prompt. </para> </listitem> </orderedlist> <para> All three of these methods are equivalent, and produce the same result. </para> </sect1> <sect1 id="screen"> <title>The &kde; &systemsettings; Screen</title> <para> When you start &systemsettings;, you are presented with a window, which is divided into three functional parts. </para> <para> Across the top is a toolbar. The toolbar provides the user with the ability to go back into the main view from within a module using the <guibutton>Overview</guibutton>, or to search for something within all of the modules. You can also find a <guimenu>Help</guimenu> menu as well as a <guibutton>Configure</guibutton> button which provides you a dialog with alternate view settings. </para> <para> Underneath the toolbar is an icon view of the individual modules that make up &systemsettings; grouped by different categories. By default, if your mouse stays a few seconds over an icon, a detailed tooltip appears, explaining the purpose of the module. </para> </sect1> <sect1 id="general"> <title>&systemsettings; Categories</title> <para>A brief overview of all categories and their modules:</para> <variablelist> <varlistentry id="application-appearance" > <term>Common Appearance and Behavior</term> <listitem> <para><itemizedlist> <listitem><para> Account Details (Password & User Account, Paths, KDE Wallet, Social Desktop, Web Shortcuts) </para></listitem> <listitem><para> Application Appearance (Style, Colors, Icons, Fonts, Emoticons) </para></listitem> <listitem><para> Application and System Notifications (Manage Notifications, System Bell, Launch Feedback) </para></listitem> <listitem><para> File Associations </para></listitem> <listitem><para> Locale (Country/Region & Language, Spell Checker) </para></listitem> <listitem><para> Personal Information (Akonadi Resources Configuration, KDE Resources) </para></listitem> <listitem><para> Shortcuts and Gestures (Custom Shortcuts, Standard Keyboard Shortcuts, Global Keyboard Shortcuts) </para></listitem> </itemizedlist> </para> </listitem> </varlistentry> <varlistentry id="workspace-appearance" > <term>Workspace Appearance and Behavior</term> <listitem> <para><itemizedlist> <listitem><para> Desktop Effects </para></listitem> <listitem><para> Workspace Appearance (Window Decorations, Cursor Theme, Desktop Theme, Splash Screen) </para></listitem> <listitem><para> Accessibility (Accessibility, Text-to-Speech) </para></listitem> <listitem><para> Default Applications </para></listitem> <listitem><para> Desktop Search </para></listitem> <listitem><para> Window Behavior (Task Switcher, Window Behavior, Window Rules) </para></listitem> <listitem><para> Workspace Behavior (Virtual Desktops, Screen Edges, Workspace) </para></listitem> </itemizedlist> </para> </listitem> </varlistentry> <varlistentry id="network" > <term>Network and Connectivity</term> <listitem> <para><itemizedlist> <listitem><para> Network Settings (Proxy, Connection Preferences, Service Discovery) </para></listitem> <listitem><para> Sharing (Windows Shares, Samba) </para></listitem> </itemizedlist> </para> </listitem> </varlistentry> <varlistentry id="hardware" > <term>Hardware</term> <listitem> <para><itemizedlist> <listitem><para> Printer Configuration </para></listitem> <listitem><para> Device Actions </para></listitem> <listitem><para> Digital Camera </para></listitem> <listitem><para> Display and Monitor (Size & Orientation, Screen Saver, Gamma, Multiple Monitors) </para></listitem> <listitem><para> Information Sources </para></listitem> <listitem><para> Input Devices (Keyboard, Mouse, Joystick, Remote Controls) </para></listitem> <listitem><para> Power Management </para></listitem> <listitem><para> Removable Devices </para></listitem> <listitem><para> Multimedia (Audio CDs, CDDB Retrieval, Phonon) </para></listitem> </itemizedlist> </para> </listitem> </varlistentry> <varlistentry id="system-administration" > <term>System Administration</term> <listitem> <para><itemizedlist> <listitem><para> Date & Time </para></listitem> <listitem><para> Font Installer </para></listitem> <listitem><para> Login Screen </para></listitem> <listitem><para> Permissions (PolicyKit Authorization) </para></listitem> <listitem><para> Startup and Shutdown (Autostart, Service Manager, Session Management) </para></listitem> <listitem><para> Task Scheduler </para></listitem> </itemizedlist> </para> </listitem> </varlistentry> </variablelist> </sect1> <sect1 id="exiting"> <title>Exiting the &kde; &systemsettings;</title> <para> &systemsettings; can be exited in one of two ways: </para> <orderedlist> <listitem> <para> Press <keycombo>&Ctrl;<keycap>Q</keycap></keycombo> on the keyboard. </para> </listitem> <listitem> <para> Click on the <guibutton>Close</guibutton> button located in the toolbar. </para> </listitem> </orderedlist> </sect1> <sect1 id="configuring"> <title>Configuring &systemsettings;</title> <para> The <guiicon>Configure</guiicon> icon in the toolbar allows you to change some &systemsettings; parameters. You can change from <guilabel>Icon View</guilabel> (default view) to <guilabel>Classic Tree View</guilabel>. </para> <para> You can also turn off the detailed tooltips by unchecking <guilabel>Show detailed tooltips</guilabel>. You will then get only normal tooltips. </para> </sect1> <sect1 id="run-modules-individually"> <title>Running Individual &systemsettings; Modules</title> <para> Individual modules can be run without running &systemsettings; using the command <command>kcmshell4</command> from the command line. Type <command>kcmshell4 --list</command> to see a list of the available &kde; &systemsettings; modules. </para> </sect1> </chapter> <chapter id="modules"> <title>The &kde; &systemsettings; Modules</title> <para> In order to make it as easy as possible, the &kde; &systemsettings; has organized options into five categories. Under each category, there are icons grouped together under subcategories. Each icon is called a module. When you click on a module icon, you will be presented with the options of the module in the main window. </para> <para> Each module will have some or all of the following buttons: </para> <variablelist> <varlistentry> <term>Help</term> <listitem> <para> This button will provide help specific to the current module. Clicking the button will open &khelpcenter; in a new window providing detailed information on the module. </para> </listitem> </varlistentry> <varlistentry> <term>Defaults</term> <listitem> <para> Clicking this button will restore this module to its default values. You must click <guibutton>Apply</guibutton> to save the options. </para> </listitem> </varlistentry> <varlistentry> <term>Reset</term> <listitem> <para> This button will "Reset" the module to the previous settings. </para> </listitem> </varlistentry> <varlistentry> <term>Apply</term> <listitem> <para> Clicking this button will save all changes to &kde;. If you have changed anything, clicking <guibutton>Apply</guibutton> will cause the changes to take effect. </para> </listitem> </varlistentry> </variablelist> <note> <para> You must either "Reset" or "Apply" the any changes before changing to another module. </para> <para> If you try to change without saving or resetting your options, you will be asked if you want to save your changes, or discard them. </para> </note> </chapter> <chapter id="credits"> <title>Credits and License</title> <para> &systemsettings; </para> <para> Program copyright 2007 Benjamin C. Meyer. </para> <para> Contributors: <itemizedlist> <listitem> <para> Will Stephenson <email>wstepheson@kde.org</email> </para> </listitem> <listitem> <para>Michael D. Stemle, Jr. <email>manchicken@notsosoft.net</email> </para> </listitem> <listitem> <para> Matthias Kretz <email>kretz@kde.org</email> </para> </listitem> <listitem> <para> &Daniel.Molkentin; &Daniel.Molkentin.mail; </para> </listitem> <listitem> <para> &Matthias.Elter; &Matthias.Elter.mail; </para> </listitem> <listitem> <para> Frans Englich <email>englich@kde.org</email> </para> </listitem> <listitem> <para> Michael Jansen <email>kde@michael-jansen.biz</email> </para> </listitem> </itemizedlist> </para> <para> Documentation Copyright © 2008 &Richard.Johnson; &Richard.Johnson.mail; </para> <!-- TRANS:CREDIT_FOR_TRANSLATORS --> &underFDL; &underGPL; </chapter> &documentation.index; </book> <!-- Local Variables: mode: xml sgml-minimize-attributes:nil sgml-general-insert-case:lower sgml-indent-step:0 sgml-indent-data:nil End: vim:tabstop=2:shiftwidth=2:expandtab kate: space-indent on; indent-width 2; tab-width 2; indent-mode none; -->