From 09595bfea08228958cb272a49664fc8a0b9b3d60 Mon Sep 17 00:00:00 2001 From: Eugene O'Connor Date: Tue, 9 Sep 2003 00:18:02 +0000 Subject: Updates for GNOME 2.4 Desktop Syatem Administration Guide. --- gnome2-system-admin-guide/C/appendixa.xml | 32 +- gnome2-system-admin-guide/C/gconf.xml | 739 ++++++++++++--------- gnome2-system-admin-guide/C/gdm.xml | 550 +++++++++++++++ gnome2-system-admin-guide/C/glossary.xml | 52 +- gnome2-system-admin-guide/C/help.xml | 102 +++ gnome2-system-admin-guide/C/menustructure.xml | 35 +- gnome2-system-admin-guide/C/mimetypes.xml | 292 ++++---- gnome2-system-admin-guide/C/performance.xml | 509 +++++++++----- gnome2-system-admin-guide/C/screensavers.xml | 35 +- gnome2-system-admin-guide/C/sessions.xml | 37 +- gnome2-system-admin-guide/C/system-admin-guide.xml | 16 +- gnome2-system-admin-guide/C/themes.xml | 396 +++++++---- 12 files changed, 1956 insertions(+), 839 deletions(-) create mode 100644 gnome2-system-admin-guide/C/gdm.xml create mode 100644 gnome2-system-admin-guide/C/help.xml (limited to 'gnome2-system-admin-guide') diff --git a/gnome2-system-admin-guide/C/appendixa.xml b/gnome2-system-admin-guide/C/appendixa.xml index 2ac858c..585f00f 100644 --- a/gnome2-system-admin-guide/C/appendixa.xml +++ b/gnome2-system-admin-guide/C/appendixa.xml @@ -1,10 +1,8 @@ - - Hidden Directories This appendix describes the hidden directories that the -GNOME desktop adds to the home directories of users. +GNOME Desktop adds to the home directories of users. hidden directories @@ -15,7 +13,7 @@ GNOME desktop adds to the home directories of users. A hidden directory is a directory that has a name that begins with a period (.). describes the hidden directories that the GNOME -desktop adds to the home directories of users. +Desktop adds to the home directories of users. Hidden Directories in User Home Directories @@ -98,24 +96,23 @@ the user. The Nautilus file manager -contains a preference that enables users to use Nautilus -to manage the desktop background. If the user selects this option, this directory -contains the objects that are on the Nautilus desktop -background of the user. This directory contains the following: +contains a preference that enables users to use the file manager to +manage the desktop. If the user selects this option, this directory contains +the objects that are on the desktop of the user. This directory contains the +following: - Objects on the desktop background, for example, the Home object, the Trash object, and other launchers. -The objects appear in the directory as desktop entry files. For example, the starthere.desktop file contains a link to the Start Here location. + Objects on the desktop, for example, the Home +object, the Trash object, and other launchers. The objects +appear in the directory as desktop entry files. For example, the starthere.desktop file contains a link to the Start Here location. Removable media volumes that are mounted. The file manager also contains a preference that enables -users to use the home directory as the desktop background directory, instead -of .gnome-desktop. If a user selects this -option, the contents of the home directory are displayed as desktop background -objects. +users to use the home directory as the desktop directory, instead of .gnome-desktop. If a user selects this option, the contents of +the home directory are displayed as desktop objects. @@ -185,7 +182,7 @@ user. For example, this directory can contain the following: adds. - Nautilus desktop background images. + Nautilus desktop images. @@ -197,9 +194,8 @@ adds. - Contains desktop themes and window frame themes -that the user adds. The user can add themes from the Themes -preference tool. + Contains controls themes, window frame themes, and +icons themes that the user adds. The user can add themes from the Theme preference tool. diff --git a/gnome2-system-admin-guide/C/gconf.xml b/gnome2-system-admin-guide/C/gconf.xml index 6226414..c6786f6 100644 --- a/gnome2-system-admin-guide/C/gconf.xml +++ b/gnome2-system-admin-guide/C/gconf.xml @@ -1,8 +1,10 @@ - Using GConf The information in this chapter describes how to use GConf to manage user preferences. + + Configuration Editor + Introducing GConf @@ -11,8 +13,8 @@ introduction GConf simplifies the administration of preferences -for users in the GNOME desktop environment. GConf -enables system administrators to do the following: +for users in the desktop environment. GConf enables +system administrators to do the following: Set mandatory values for particular preferences for all users. @@ -45,6 +47,9 @@ preference, all applications that use the preference are immediately updated.

A command line tool, gconftool-2. + + Configuration Editor + GConf Repository @@ -58,8 +63,8 @@ is an element in the repository that corresponds to an application preference. For example, the /apps/gnome-session/options/show_splash_screen preference key corresponds to the Show splash screen on login option in the Sessions preference tool. The GNOME -user interface does not contain all of the preference keys in the GConf repository. For example, the Sessions -preference tool does not contain an option that corresponds to the /apps/gnome-session/options/splash_screen_text key. +Desktop user interface does not contain all of the preference keys in the GConf repository. For example, the Sessions +preference tool does not contain an option that corresponds to the /apps/gnome-session/options/allow_tcp_connections key. The repository is structured like a simple hierarchical file system. The repository contains the following: @@ -88,7 +93,7 @@ repository depends on the backend module that is used to read the repository. The following is an example of the /desktop/gnome/interface/font_name preference key when an Extensible Markup Language (XML) backend module is used to read the repository: <entry name="font_name" mtime="1038323555" muser="user123" type="string"> -<stringvalue>avantgarde 10</stringvalue></entry> +<stringvalue>Sans 10</stringvalue></entry> When this guide refers to a preference key, the path to the key is added to the name of the key. For example, the font_name @@ -104,7 +109,7 @@ is referred to as /desktop/gnome/interface/font_name. The GConf repository contains a series of storage locations that are called configuration sources. The configuration sources are listed in the GConf path file. The location of the GConf -path file is /etc/gconf/version_number/path. Each user has a path file. Each line in the path file specifies +path file is /etc/gconf/version-number/path. Each user has a path file. Each line in the path file specifies the following information: @@ -370,13 +375,14 @@ a .schemas extension. The schema definition files are included in the /etc/gconf/schemas directory. You can use the schema definition files to create a new configuration source. Some schema definition files correspond closely to a part of the GNOME -user interface. For example, system_http_proxy.schemas +Desktop user interface. For example, system_http_proxy.schemas corresponds to the Network Proxy preference tool. Other schema definition files contain preference keys that are not present -in the GNOME user interface. For example, the /apps/gnome-session/options/splash_screen_text key is not present in the user interface. - Some parts of the GNOME user interface contain preferences that represent -preference keys from more than one schema definition file. For example, the Keyboard Shortcuts preference tool contains preferences that -represent keys from the panel-global-config.schemas and metacity.schemas files. +in the GNOME Desktop user interface. For example, the /apps/gnome-session/options/splash_screen_text key is not present in the user interface. + Some parts of the GNOME Desktop user interface contain preferences that +represent preference keys from more than one schema definition file. For example, +the Keyboard Shortcuts preference tool contains +preferences that represent keys from the panel-global-config.schemas and metacity.schemas files. @@ -427,7 +433,10 @@ values. All applications use this cache, so applications only need to access the configuration sources once. To terminate the GConf daemon, run the following command: - # gconftool-2 --shutdown + + # + gconftool-2 --shutdown + GConf Command Line Tool @@ -455,8 +464,11 @@ an application. For example, use the following command to display the values of all keys in the /desktop/gnome directory and subdirectories. - # gconftool-2 --recursive-list -/desktop/gnome + + # + gconftool-2 --recursive-list +/desktop/gnome + lists some of the options that you can use with the gconftool-2 command.
@@ -500,7 +512,7 @@ in a directory that you specify. - --config-source=configuration_source + --config-source=configuration-source @@ -522,6 +534,22 @@ When you use this option, GConf bypasses the server. Ensure that the GConf daemon, gconfd-2, is not running before you use this option. + + + + --dump + + + + Generates a list that contains all preference +keys in a GConf repository directory that you specify. +The list contains XML descriptions of all the keys. The list is contained +in a <gconfentryfile> element. + For example, +you can redirect the output from this option to generate a file that lists +all keys that are related to your panel configuration. You can use the --load option with this file. + + @@ -544,6 +572,19 @@ key that you specify. Displays a help message about the gconftool-2 command, and the options that you can use with the gconftool-2 command. + + + + --load=filename + + + + Use +this option to sets the values of preference keys in the current directory +in a configuration source to the values in the file that you specify. The +file that you specify must contain XML descriptions of the keys, in a <gconfentryfile> element. + + @@ -583,7 +624,7 @@ an owner for a schema key. - Displays the value of all preference keys in all + Displays the values of all preference keys in all subdirectories in a directory that you specify. @@ -612,8 +653,11 @@ with the --set option to specify the data type of the value that you want to set. For example, the following command sets the value of the /apps/gnome-terminal/profiles/Default/background_color key in the user configuration source: - # gconftool-2 --set "/apps/gnome-terminal/profiles/Default/background_color" ---type string "#000000" + + # + gconftool-2 --set "/apps/gnome-terminal/profiles/Default/background_color" +--type string "#000000" + You can also use the --direct option and the --config-source option with the --set option to write a value to another configuration source. @@ -654,8 +698,11 @@ option to specify the attribute that you want to update:For example, the following command sets the short description in the schema key for the /apps/gnome-terminal/profiles/Default/background_color key: - # gconftool-2 --set-schema "/schemas/apps/gnome-terminal/profiles/Default/background_color" ---short-desc "Default background color of terminal" + + # + gconftool-2 --set-schema "/schemas/apps/gnome-terminal/profiles/Default/background_color" +--short-desc "Default background color of terminal" + @@ -682,7 +729,7 @@ option to specify a short description for a schema key. - --type=data_type + --type=data-type @@ -767,20 +814,29 @@ values or default preference values for users, you must ensure that the To set a mandatory value or a default value for a preference key, use the gconftool-2 command, as follows: - # gconftool-2 --direct --config-source configuration_source --type data_type ---set preference_key value + + # + gconftool-2 --direct --config-source configuration-source --type data-type +--set preference-keyvalue + For example, to set wwwproxy.xyz.com as the mandatory HTTP proxy host, run the following command: - # gconftool-2 --direct --config-source + + # + gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.mandatory --type string --set /system/http_proxy/host -wwwproxy.xyz.com +wwwproxy.xyz.com + The user cannot override this preference value. You can also use the gconftool-2 command to set default values. For example, to set the default number of workspaces to five, run the following command: - # gconftool-2 --direct --config-source + + # + gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.defaults --type int --set /apps/metacity/general/num_workspaces -5 +5 + The user can override this preference value. Before you change mandatory preference values or default preference @@ -806,11 +862,17 @@ GConf the values of the preference keys in the /system/http_proxy/ location. For example, to set a mandatory value for the HTTP proxy host, run the following command: - # gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.mandatory --type string --set /system/http_proxy/host proxy_name + + # + gconftool-2 --direct --config-source +xml:readwrite:/etc/gconf/gconf.xml.mandatory --type string --set /system/http_proxy/host proxy-name + To set a default value for the HTTP proxy host, run the following command: - # gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.defaults --type string --set /system/http_proxy/host proxy_name + + # + gconftool-2 --direct --config-source +xml:readwrite:/etc/gconf/gconf.xml.defaults --type string --set /system/http_proxy/host proxy-name + You can also set other HTTP proxy-related preferences. For information on the other HTTP proxy preferences, see the system_http_proxy.schemas schema definition file. @@ -829,12 +891,18 @@ value as follows: setting with GConf - # gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.mandatory ---type bool --set /apps/gnome-print-manager/show_all_jobs false + + # + gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.mandatory +--type bool --set /apps/gnome-print-manager/show_all_jobs false + To set a default value for this preference, run the following command: - # gconftool-2 --direct --config-source + + # + gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.defaults --type bool --set /apps/gnome-print-manager/show_all_jobs -false +false + You can also set other print manager preferences. For information on the other print manager preferences, see the gnome-print-manager.schemas schema definition file. @@ -850,11 +918,17 @@ the other print manager preferences, see the gnome-print-manager.schem To set a mandatory number of workspaces, use the following command: - # gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.mandatory --type int --set /apps/metacity/general/num_workspaces integer + + # + gconftool-2 --direct --config-source +xml:readwrite:/etc/gconf/gconf.xml.mandatory --type int --set /apps/metacity/general/num_workspaces integer + To set a default number of workspaces, use the following command: - # gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.defaults --type int --set /apps/metacity/general/num_workspaces integer + + # + gconftool-2 --direct --config-source +xml:readwrite:/etc/gconf/gconf.xml.defaults --type int --set /apps/metacity/general/num_workspaces integer + You can also set other window manager preferences. For information on the other window manager preferences, see the metacity.schemas schema definition file. @@ -873,13 +947,19 @@ schema definition file. keys in the /desktop/gnome/accessibility/keyboard location. For example, if you want to set a mandatory value so that keyboard accessibility features are enabled, run the following command: - # gconftool-2 --direct --config-source + + # + gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.mandatory --type bool --set /desktop/gnome/accessibility/keyboard/enable -true +true + To set a default value for this preference, run the following command: - # gconftool-2 --direct --config-source + + # + gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.defaults --type bool --set desktop/gnome/accessibility/keyboard/enable -false +false + You can also set other keyboard accessibility preferences. For information on the other keyboard accessibility preferences, see the desktop_gnome_accessibility_keyboard.schemas schema definition file. @@ -894,89 +974,21 @@ on the other keyboard accessibility preferences, see the desktop_gnome setting shortcut preferences with GConf To set -keyboard shortcut preferences, you modify the values of preference keys in -two locations. The following table shows the locations to modify, and the -part of the user interface to which the locations correspond: - - - - - - - - GConf Location - - - User Interface Component - - - - - - - - /apps/panel/global - - - - Keyboard Shortcuts preference -tool, Desktop section - - - - - - /apps/metacity/general - - - - Keyboard Shortcuts preference -tool, Window Management section - - - - - - For example, you might want users to use only the AltF3 - keyboard shortcut to open the Run Program dialog. To set this mandatory value, run the following command: - # gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.mandatory --type string --set /apps/panel/global/run_key -'<Alt>F3' - You might want users to use AltF11 -to maximize windows, by default. To set this default value, run the following -command: - # gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.defaults --type string --set /apps/metacity/window_keybindings/maximize -'<Alt>F11' +keyboard shortcut preferences, you modify the values of preference keys in /apps/metacity/global_keybindings location. For example, you might +want users to use only the AltF3 keyboard +shortcut to open the Run Program dialog. To set this +mandatory value, run the following command: + + # + gconftool-2 --direct --config-source +xml:readwrite:/etc/gconf/gconf.xml.mandatory --type string --set /apps/metacity/global_keybindings +'<Alt>F3' + You can also set other keyboard shortcut preferences. For information -on the other keyboard shortcut preferences, see the panel-global-config.schemas and metacity.schemas schema definition files. - - - To Set Global Panel Preferences - - GConf - global panel preferences, setting - - - panels - setting -global preferences with GConf - - To set global preferences -for panels, you modify the values of the preference keys in the /apps/panel/global location. For example, if you do not want users -to ever use panel animation, set a mandatory value as follows: - # gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.mandatory --type bool --set /apps/panel/global/enable_animations -false - To set a default value for this preference, run the following command: - # gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.defaults --type bool --set /apps/panel/global/enable_animations -false - You can also set other global panel preferences. For information on -the other global panel preferences, see the panel-global-config.schemas schema definition file. +on the other keyboard shortcut preferences, see the metacity.schemas schema definition file. - To Set Preferences for Individual Panels and Panel Objects + Setting Panel and Panel Object Preferences GConf panel object preferences, setting @@ -990,9 +1002,9 @@ preferences, setting individual panels preferences, individual, setting with GConf - The panel-per-panel-config.schemas -schema definition file specifies the following details of the panels on the -desktop: + The panel-default-setup.entries schema +definition file specifies the following details of the panels in the desktop +environment: Number of panels. @@ -1009,12 +1021,12 @@ desktop: The configuration of individual panels and of panel objects is a complex task. To configure individual panels and panel objects, you must first understand -the structure of the panel-per-panel-config.schemas schema -definition file. For more information on the panel-per-panel-config.schemas schema definition file, see the next section. +the structure of the panel-default-setup.entries schema +definition file. For more information on the panel-default-setup.entries schema definition file, see the next section. To set preferences for individual panels and panel objects, you must set the values of many preferences in a configuration source. The easiest -way to set the values of many preferences is to use a script. For a sample -script that sets preferences for a panel and objects on the panel, see . +way to set the values of panel preferences is to use the gconftool-2 command with the --dump and --load options. For more information on how to set preferences for panels +and objects on panels, see . Schema Definition File for Individual Panels and Panel Objects @@ -1027,207 +1039,160 @@ script that sets preferences for a panel and objects on the panel, see schema definition files panel and panel object - The schema definition file panel-per-panel-config.schemas contains sections that specify panels -and panel contents for small, medium, and large screens. The section for small -screens and the section for large screens are not functional at the time of -publication of this guide. To learn about preference keys for panels or panel -objects, read the section for medium screens only. - The medium section of the file panel-per-panel-config.schemas is structured as follows: + The schema definition file panel-default-setup.entries contains sections that specify panels +and panel contents. The panel-default-setup.entries file +is structured as follows: Preference keys that specify the general structure of panels, -applets, and other panel objects on the desktop. The following keys specify -the number of panels, applets, and other panel objects that appear on the -desktop: +applets, and other panel objects in the desktop environment. The following +keys specify the number of panels, applets, and other panel objects that appear +in the desktop environment: - /apps/panel/default_profiles/medium/general/panel_id_list + /apps/panel/default_setup/general/toplevel_id_list - /apps/panel/default_profiles/medium/general/applet_id_list + /apps/panel/default_setup/general/applet_id_list - /apps/panel/default_profiles/medium/general/object_id_list + /apps/panel/default_setup/general/object_id_list The keys also assign identifiers to each panel, applet, and panel object. -For example, the following excerpt from panel-per-panel-config.schemas specifies that two panels appear on the desktop: - <key>/schemas/apps/panel/default_profiles/medium/ -general/panel_id_list</key> -. -. -. -<default>[00000001,00000002]</default> - In panel-per-panel-config.schemas, the identifier -00000001 identifies the bottom edge panel, and the identifier 00000002 identifies -the Menu Panel. +For example, the following sample from panel-default-setup.entries specifies that one panel appears in the desktop environment: + <entry> + <key>toplevel_id_list</key> + <schema_key>/schemas/apps/panel/general/toplevel_id_list</schema_key> + <value> + <list type="string"> + <value> + <string>bottom_panel</string> + </value> + </list> + </value> + </entry> + In panel-default-setup.entries, the identifier bottom_panel identifies the bottom edge panel. Preference keys that specify the properties of the panels. The panel property keys are structured as follows: - /apps/panel/default_profiles/medium/panels/panel_number/panel_property_key - For example, the key /apps/panel/default_profiles/medium/panels/00000001/screen_edge specifies the edge of the display on which the bottom edge panel -resides. - The keys that specify the properties of the bottom edge panel are listed -first. The keys that specify the properties of the Menu Panel are listed at -the end of the medium section in panel-per-panel-config.schemas. + /apps/panel/default_setup/toplevels/panel-name/panel-property-key + For example, the key /apps/panel/default_setup/toplevels/bottom_panel/size specifies the size of the bottom panel. Preference keys that list the panel objects, the panel object properties, and the panels in which the objects reside. For example, the following -excerpt from panel-per-panel-config.schemas specifies -object 00000001: - <key>/schemas/apps/panel/default_profiles/medium/ -objects/00000001/object_type</key> -. -. -. -<default>launcher-object</default> -. -. +sample from panel-default-setup.entries specifies a Main Menu object at the left side of the bottom panel: + <entrylist base="/apps/panel/default_setup/objects/main_menu"> + <entry> + <key>object_type</key> + <schema_key>/schemas/apps/panel/objects/object_type</schema_key> + <value> + <string>menu-object</string> + </value> + </entry> + <entry> + <key>toplevel_id</key> + <schema_key>/schemas/apps/panel/objects/toplevel_id</schema_key> + <value> + <string>bottom_panel</string> + </value> + </entry> + <entry> + <key>position</key> + <schema_key>/schemas/apps/panel/objects/position</schema_key> + <value> + <int>0</int> + </value> + </entry> . -<key>/schemas/apps/panel/default_profiles/medium/ -objects/00000001/launcher_location</key> . . -. -<default>applications:///nautilus.desktop</default> -. -. -. -<key>/schemas/apps/panel/default_profiles/medium/ -objects/00000001/panel_id</key> -. -. -. -<default>00000002</default> - The object is a launcher that starts Nautilus -file manager. The launcher resides in the Menu Panel. + </entrylist> Preference keys that list the applets, the applet preferences, -and the panels in which the applets reside. For example, the following excerpt -from panel-per-panel-config.schemas specifies applet -00000001: - <key>/schemas/apps/panel/default_profiles/medium/ -applets/00000001/object_type</key> -. -. -. -<default>bonobo-applet</default> -. -. -. -<key>/schemas/apps/panel/default_profiles/medium/ -applets/00000001/panel_id</key> -. -. -. -<default>00000001</default> -. +and the panels in which the applets reside. For example, the following sample +from panel-default-setup.entries specifies the Window List applet, in the bottom panel: + <entrylist base="/apps/panel/default_setup/applets/window_list"> + <entry> + <key>object_type</key> + <schema_key>/schemas/apps/panel/objects/object_type</schema_key> + <value> + <string>bonobo-applet</string> + </value> + </entry> + <entry> + <key>toplevel_id</key> + <schema_key>/schemas/apps/panel/objects/toplevel_id</schema_key> + <value> + <string>bottom_panel</string> + </value> + </entry> + <entry> + <key>position</key> + <schema_key>/schemas/apps/panel/objects/position</schema_key> + <value> + <int>2</int> + </value> + </entry> . . -<key>/schemas/apps/panel/default_profiles/medium/ -applets/00000001/bonobo_iid</key> . -. -. -<default>OAFIID:GNOME_TasklistApplet</default> - The applet is the Window List applet. The -applet resides in the bottom edge panel. + <entry> + <key>bonobo_iid</key> + <schema_key>/schemas/apps/panel/objects/bonobo_iid_type</schema_key> + <value> + <string>OAFIID:GNOME_WindowListApplet</string> + </value> + </entry> + </entrylist> - Sample Script for Setting Individual Panel Preferences - This section contains a sample script that sets the preferences for -a panel that has the following major characteristics: - + To Set Preferences for Individual Panels and Panel Objects + To set the preferences for a panel and the objects on a panel perform +the following steps: + + + Log in to a GNOME session, and configure the panels as required. + - The panel is an edge panel, and resides at the bottom edge -of the screen. + Use the --dump option with the gconftool-2 command line tool to generate a file that contains an +XML description of your panel configuration. The --dump +option generates a list that contains all preference keys in a GConf repository directory that you specify. + For example, the following command creates an XML description of the +default panel configuration in a file called my-panel-setup.entries: + + # + gconftool-2 --dump /apps/panel/profiles/default +> my-panel-setup.entries + - The panel contains a file manager launcher and a Terminal launcher. + Open the my-panel-setup.entries file +in a text editor, and modify the file as required. - The panel contains a Window List -applet. + Use the --load option with the gconftool-2 command line tool to set the values of the default configuration +source to the values in the my-panel-setup.entries file. +For example, the following command sets the values of the keys in the default +configuration source to the values of the corresponding keys in my-panel-setup.entries: + + # + gconftool-2 --direct --config-source +xml:readwrite:/etc/gconf/gconf.xml.defaults --load my-panel-setup.entries + - - The sample script also sets other minor preferences. All of the preferences -have default values, not mandatory values. - The sample script follows: - # Usage is: set_key <type> <key> <value> <extra options if any> - -function set_key() -{ - TYPE="$1" - shift - KEY="$1" - shift - VALUE="$1" - shift - OTHER_ARGS="$*" - gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.defaults ---owner=panel $OTHER_ARGS --type "$TYPE" --set "$KEY" "$VALUE" -} - -# Define the number of panels, the number of launchers, and the number of applets -set_key list /apps/panel/default_profiles/medium/general -/panel_id_list [00000001] --list-type string -set_key list /apps/panel/default_profiles/medium/general -/object_id_list [00000001,00000002] --list-type string -set_key list /apps/panel/default_profiles/medium/general -/applet_id_list [00000001] --list-type string - -# Define the characteristics of the panel -set_key string /apps/panel/default_profiles/medium/panels -/00000001/panel_type edge-panel -set_key string /apps/panel/default_profiles/medium/panels -/00000001/panel_size panel-size-x-small -set_key string /apps/panel/default_profiles/medium/panels -/00000001/screen_edge panel-edge-bottom -set_key bool /apps/panel/default_profiles/medium/panels -/00000001/hide_buttons_enabled false -set_key string /apps/panel/default_profiles/medium/panels -/00000001/panel_background_type no-background - -# Define the first launcher -set_key string /apps/panel/default_profiles/medium/objects -/00000001/object_type launcher-object -set_key string /apps/panel/default_profiles/medium/objects -/00000001/launcher_location 'applications:///nautilus.desktop' -set_key string /apps/panel/default_profiles/medium/objects -/00000001/panel_id 00000001 -set_key int /apps/panel/default_profiles/medium/objects -/00000001/position 20 - -# Define the second launcher -set_key string /apps/panel/default_profiles/medium/objects -/00000002/object_type launcher-object -set_key string /apps/panel/default_profiles/medium/objects -/00000002/launcher_location 'applications:///System/gnome-terminal.desktop' -set_key string /apps/panel/default_profiles/medium/objects -/00000002/panel_id 00000001 -set_key int /apps/panel/default_profiles/medium/objects -/00000002/position 25 - -# Define the applet -set_key string /apps/panel/default_profiles/medium/applets -/00000001/object_type bonobo-applet -set_key string /apps/panel/default_profiles/medium/applets -/00000001/bonobo_iid OAFIID:GNOME_TasklistApplet -set_key string /apps/panel/default_profiles/medium/applets -/00000001/panel_id 00000001 -set_key int /apps/panel/default_profiles/medium/applets -/00000001/position 25 + @@ -1284,19 +1249,25 @@ interface to which the keys correspond:For example, to set Sans 12 as the mandatory application font, run the following command: - # gconftool-2 --direct --config-source + + # + gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.mandatory --type string --set /desktop/gnome/interface/font_name “Sans -12” +12” + - desktop background - font preferences, -setting with GConf + desktop + font preferences, setting +with GConf - To set palatino 12 as the default desktop background object font, run the following -command: - # gconftool-2 --direct --config-source + To set palatino 12 +as the default desktop object font, run the following command: + + # + gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.defaults --type string --set /apps/nautilus/preferences/desktop_font “palatino -12” +12” + To Set Desktop Background Preferences @@ -1311,11 +1282,17 @@ xml:readwrite:/etc/gconf/gconf.xml.defaults --type string --set /apps/nautilus/p To set desktop background preferences, you modify the values of the preference keys in the /desktop/gnome/background location. For example, to set a mandatory image for the desktop background, run the following command: - # gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.mandatory --type string --set /desktop/gnome/background/picture_filename filename.png + + # + gconftool-2 --direct --config-source +xml:readwrite:/etc/gconf/gconf.xml.mandatory --type string --set /desktop/gnome/background/picture_filename filename.png + To set a default value for this preference, run the following command: - # gconftool-2 --direct --config-source -xml:readwrite:/etc/gconf/gconf.xml.defaults --type string --set /desktop/gnome/background/picture_filename filename.png + + # + gconftool-2 --direct --config-source +xml:readwrite:/etc/gconf/gconf.xml.defaults --type string --set /desktop/gnome/background/picture_filename filename.png + You can also set other desktop background preferences. For information on the other desktop background preferences, see the desktop_gnome_background.schemas schema definition file. @@ -1333,13 +1310,19 @@ with GConfTo set splash image preferences, you modify the value of the preference keys in the /apps/gnome-session/options/ location. For example, if you do not want users ever to see a splash image, set a mandatory value as follows: - # gconftool-2 --direct --config-source + + # + gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.mandatory --type bool --set /apps/gnome-session/options/show_splash_screen -false +false + To set a default value for this preference, run the following command: - # gconftool-2 --direct --config-source + + # + gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.defaults --type bool --set /apps/gnome-session/options/show_splash_screen -false +false + You can also set other splash image preferences. For information on the other splash image preferences, see the gnome-session.schemas schema definition file. @@ -1357,11 +1340,155 @@ valuesTo restore the default preference values for a user, run the following command: - # gconftool-2 --direct --config-source user_configuration_source --recursive-unset - Replace user_configuration_source with the + + # + gconftool-2 --direct --config-source user-configuration-source --recursive-unset + + Replace user-configuration-source with the configuration source in the .gconf directory in the home directory of the user. This command resets the values of all preference keys, in all subdirectories, from the user setting to the setting in the default configuration source. + + Using Configuration Editor + + GConf + Configuration Editor + + + Configuration Editor + overview + + Configuration Editor enables +you to do the following: + + + Modify the values of the keys in the GConf +repository. + + + View documentation on the keys in the GConf +repository. + + + To open Configuration Editor, choose ApplicationsSystem ToolsConfiguration Editor. +shows the Configuration Editor window. +
+ Configuration Editor Window + + + + + + + Configuration Editor window. Callouts: Tree pane, Modification pane, Documentation pane. + + + +
+ The Configuration Editor window contains +the following panes: + + + Tree pane + + Enables you to navigate +the directories and subdirectories in the GConf +repository. Use this pane to display the keys that you want to modify in the +modification pane. The tree pane is on the left side of the window. + + + + Modification pane + + Displays the keys +in the selected GConf repository directory. Use +this pane to select keys that you want to modify, and to modify the values +of keys. The modification pane is in the upper part of the right side of the +window. + The icons beside the keys in the modification pane indicate what type +of value you can enter for the key. For example, the check mark icon beside +the /system/http_proxy/use_http_proxy key indicates that +you can enter a boolean value for the key. + The icons also indicate if you cannot edit the value of a key. For example, +a key icon beside a schema key indicates that you cannot modify the value +of the key. + + + + Documentation pane + + Displays documentation +for the currently selected key. Use this pane to read more information on +the GConf preference keys. + + + + + GConf + GConf editor, +using + + You can copy the names of keys so that +you can paste the name of the key into another application. You can also add +bookmarks to keys. + The following sections describe how to use the Configuration +Editor. + + To Modify the Value of a Key + + Configuration Editor + modifying key +values + + To modify the value of a key, perform +the following steps: + + + Use the tree pane to display the key that you want to modify +in the modification pane. + + + Select the key to modify. + + + To change the value of an integer key or a string key, click +in the Value column of the key. Type the new value for +the key. + To change the value of a boolean key, click in the Value +column of the key. + + + + + To Copy a Key Name + + Configuration Editor + copying key names + + To copy a key name, select the key whose name +you want to copy in the modification pane. Choose EditCopy key name. If required, +you can paste the name of the key into another application. + + + Using Bookmarks With Keys + + Configuration Editor + bookmarks + + To access a key in your bookmarks, choose the key from the Bookmarks menu. You can add keys to your Bookmarks +menu. + + To Add a Bookmark + To add a bookmark, select the key that you want to bookmark in the modification +pane. Choose BookmarksAdd bookmark. + + + To Delete a Bookmark + To delete a bookmark, choose BookmarksEdit bookmarks. An Edit bookmarks dialog is displayed. Select the bookmark in the +dialog, then click Delete. + + + diff --git a/gnome2-system-admin-guide/C/gdm.xml b/gnome2-system-admin-guide/C/gdm.xml new file mode 100644 index 0000000..f34d4b1 --- /dev/null +++ b/gnome2-system-admin-guide/C/gdm.xml @@ -0,0 +1,550 @@ + + Configuring GDM + + This chapter describes how to configure GDM in the GNOME Desktop. + + + Introduction to GDM + + GDM + introduction + + To start a GNOME Desktop session, users must log in to authenticate +their identity. The login screen provides gateway to the desktop environment +for the user. The GNOME Display Manager (GDM) application controls the login screen. + GDM also enables you to log in to another +session without closing the current session. + + + Configuring GDM + + GDM + configuring + + To configure GDM, use the GDM +Configurator application. To open GDM Configurator, choose ApplicationsSystem ToolsGDM Configurator. + You can configure GDM in the following functional +areas: + + + + General + + + + + Standard greeter + + + + + Graphical greeter + + + + + Security + + + + + XDMCP + + + + + General Settings + Use the General tabbed section to set general GDM +preferences. + lists the general GDM settings that you can +configure. +
+ General GDM Settings + + + + + + + Element + + + Description + + + + + + + + Local + + + + Information +to be provided in a future release. + + + + + + Remote + + + + Information to be provided in a future release. + + + + + + Always use 24 hour clock format + + + + Information to be provided in a future release. + + + + + + Login a user automatically on first bootup + + + + Information to be provided in a future release. + + + + + + Automatic login username + + + + Information to be provided in a future release. + + + + + + Login a user automatically after a specified number +of seconds + + + + Information to be provided +in a future release. + + + + + + Timed login username + + + + Information to be provided in a future release. + + + + + + Seconds before login + + + + Information to be provided in a future release. + + + + +
+ + + Standard Greeter Settings + Use the Standard greeter tabbed section to set +preferences for the standard greeter. + lists the standard greeter settings that +you can configure. + + Standard Greeter Settings + + + + + + + Element + + + Description + + + + + + + + Logo + + + + Information +to be provided in a future release. + + + + + + Welcome string + + + + Information to be provided in a future release. + + + + + + Show choosable user images (face browser) + + + + Information to be provided in a future release. + + + + + + No background + + + + Information to be provided in a future release. + + + + + + Image + + + + + + + + + + Color + + + + + + + + + + Scale background image to fit + + + + Information to be provided in a future release. + + + + + + Only color on remote displays + + + + Information to be provided in a future release. + + + + + + Background color + + + + Information to be provided in a future release. + + + + +
+ + + Graphical Greeter Settings + Use the Graphical greeter tabbed section to set +preferences for the graphical greeter. + lists the graphical greeter settings that +you can configure. + + Graphical Greeter Settings + + + + + + + Element + + + Description + + + + + + + Greeter list + + + Information to be +provided in a future release. + + + + + + Install new theme + + + + Information to be provided in a future release. + + + + +
+ + + Security Settings + Use the Security tabbed section to set security +preferences for GDM. + lists the security settings that you can +configure. + + Security Settings + + + + + + + Element + + + Description + + + + + + + + Allow root to login with GDM + + + + Information to be provided in a future release. + + + + + + Allow root to login remotely with GDM + + + + Information to be provided in a future release. + + + + + + Allow remote timed logins + + + + Information to be provided in a future release. + + + + + + Show system menu + + + + Information to be provided in a future release. + + + + + + Allow configuration from the login screen + + + + Information to be provided in a future release. + + + + + + Retry delay (seconds) + + + + Information to be provided in a future release. + + + + +
+ + + XDMCP Settings + Use the XDMCP tabbed section to set preferences +for XDMCP. + lists the XDMCP settings that you can configure. + + XDMCP Settings + + + + + + + Element + + + Description + + + + + + + + Enable XDMCP + + + + Information to be provided in a future release. + + + + + + Honour indirect requests + + + + Information to be provided in a future release. + + + + + + Listen on UDP port + + + + Information to be provided in a future release. + + + + + + Maximum pending requests + + + + Information to be provided in a future release. + + + + + + Max pending indirect requests + + + + Information to be provided in a future release. + + + + + + Maximum remote sessions + + + + Information to be provided in a future release. + + + + + + Maximum wait time + + + + Information to be provided in a future release. + + + + + + Maximum indirect wait time + + + + Information to be provided in a future release. + + + + + + Displays per host + + + + Information to be provided in a future release. + + + + + + Ping interval (minutes) + + + + Information to be provided in a future release. + + + + +
+ + + + Logging in to a New Session + + GDM + logging in to new session + + + New login application + + To log in to a new session, choose ApplicationsSystem ToolsNew login. A login screen is displayed. Enter your username +and password to log in. + + diff --git a/gnome2-system-admin-guide/C/glossary.xml b/gnome2-system-admin-guide/C/glossary.xml index 6c9ddf9..65dd29a 100644 --- a/gnome2-system-admin-guide/C/glossary.xml +++ b/gnome2-system-admin-guide/C/glossary.xml @@ -1,4 +1,3 @@ - Glossary @@ -9,12 +8,16 @@ .directory file + + .omf file + + application registry The application registry is a location that contains text files which register applications. The location of the application registry -for the GNOME desktop is /usr/share/gnome/application-registry. +for the GNOME Desktop is /usr/share/gnome/application-registry. @@ -22,8 +25,7 @@ for the GNOME desktop is /usr/share/gnome/application-registry A data file that provides information about an item in a menu. The desktop entry file specifies the details for the item such as a name, -a command to run, an icon, and so on. Desktop entry files have -a .desktop file extension. +a command to run, an icon, and so on. Desktop entry files have a .desktop file extension. @@ -134,27 +136,24 @@ icon to represent files of that MIME type. MIME keys files have a .key A MIME type identifies the format of a file. The MIME type enables applications to read the file. For example, an email application can -use the MIME type to detect what type of file is in a file attached to an -email. +use the image/png MIME type to detect that a Portable Networks +Graphic (PNG) file is attached to an email. MIME type registry The MIME type registry is a location that contains text files -which register MIME types for the GNOME desktop. The location of the MIME -type registry for the GNOME desktop is /usr/gnome/share/mime-info. +which register MIME types for the desktop environment. The location of the +MIME type registry for the GNOME Desktop is /usr/gnome/share/mime-info. - - Netscape color palette + + OMF file - The Netscape color palette is a -general-purpose palette of 216 colors. The Netscape -color palette is designed to optimize the use of color on systems that support -8-bit color. The Netscape color palette is also -called the websafe color palette and the Netscape -color cube. + Open Source Metadata Framework file. This is a file that is +associated with the XML file for a manual. The OMF file contains information +about the manual that is used by the help browser. OMF files have a .omf extension. @@ -165,12 +164,21 @@ file content sniffer. The pattern mask identifies bits in the pattern to ignore when searching for a pattern in a file. + + pregenerate + + To convert source XML files for online help to HTML before +the online help is used. You can pregenerate help to improve the performance +of the help browser. Use the yelp-pregenerate command to +pregenerate help. + + screensaver A screensaver is an application that replaces the image on a screen when the screen is not in use. The screensaver application for the -GNOME desktop is XScreenSaver. +GNOME Desktop is XScreenSaver. @@ -205,4 +213,14 @@ several directories. files specify the structure of your menus. + + websafe color palette + + The websafe color palette is a general-purpose palette of +216 colors. The websafe color palette is designed to optimize the use of color +on systems that support 8-bit color. The websafe color palette is also called +the Netscape color palette and the Netscape +color cube. + + diff --git a/gnome2-system-admin-guide/C/help.xml b/gnome2-system-admin-guide/C/help.xml new file mode 100644 index 0000000..af0224b --- /dev/null +++ b/gnome2-system-admin-guide/C/help.xml @@ -0,0 +1,102 @@ + + Help System + + This chapter describes the Help system in the GNOME Desktop. + + + Introduction + + online Help + Help + + + Help + introduction + + The GNOME Desktop displays Help in the Yelp Help +browser. The source documents for the Help are XML files. The XML files are +written to the DocBook XML Version 4.1.2 document type definition (DTD). The +DocBook XML files are converted to HTML, and the HTML is displayed in the +Help browser. For more information on DocBook XML, see the following URL: + + http://www.oasis-open.org/docbook/xml + + The Help system uses Open Source Metadata Framework +(OMF) files, and a cataloging system. The next sections describe OMF files +and the cataloging system. + + + OMF Files + + .omf files + OMF files + + + Help + OMF files + + + OMF files + + The XML file for each manual +has an associated OMF file. The OMF file contains information about the manual +that is used by the Help browser. OMF files have a .omf +extension. + When you install an application, the installation process installs an +OMF file to a directory of OMF files. If a Help document has an associated +OMF file in an OMF file directory, the Help document is displayed in the Help +browser. + OMF files contain information about Help documents such as the following: + + + The location of the XML file for the Help document + + + The title of the Help document + + + A subject category to which the Help document belongs + + + + + ScrollKeeper Cataloging System + + Help + ScrollKeeper cataloging system + + + ScrollKeeper cataloging system + + ScrollKeeper is a cataloging +system for documentation. The Help browser uses ScrollKeeper to catalog the manuals on the system. ScrollKeeper manages the information in the OMF files for the Help browser. + ScrollKeeper uses the information in the +OMF files to enable the Help browser to find Help documents on a system. When +you install an application, the installation process installs an OMF file +to a directory of OMF files. + ScrollKeeper builds a table of contents for +each Help document that has an associated OMF file. ScrollKeeper builds the table of contents from the XML file specified in +the OMF file. The table of contents for the Help document is displayed in +the left pane of the Help browser window, and enables users to navigate the +Help document in the left pane. The title of the document in the OMF file +is also displayed in the left pane of the Help browser window. + ScrollKeeper contains a hierarchy of subject +categories to which a Help document can belong. The Help documents are organized +into this hierarchy of subject categories in the left pane of the Help browser +window. The subject category of the document in the OMF file determines the +location of the document in the hierarchy. The hierarchy of subject categories +is defined in the following file: + + /usr/share/scrollkeeper/Templates/C/scrollkeeper_cl.xml + + The subject category of a document must correspond to a subject category +in the following file: + + /usr/share/scrollkeeper/Templates/C/scrollkeeper_cl.xml + + + If the Help document XML file is moved to a new location, then +you might need to update the location in the OMF file. + + + diff --git a/gnome2-system-admin-guide/C/menustructure.xml b/gnome2-system-admin-guide/C/menustructure.xml index f576c73..d090e0f 100644 --- a/gnome2-system-admin-guide/C/menustructure.xml +++ b/gnome2-system-admin-guide/C/menustructure.xml @@ -1,9 +1,8 @@ - Customizing Menus - The information in this chapter describes how GNOME implements -menus and how you can customize menus. + The information in this chapter describes how the GNOME +Desktop implements menus and how you can customize menus. Introduction to Menus @@ -11,8 +10,8 @@ menus and how you can customize menus. menus introduction - The way in which GNOME implements menus in the desktop enables you to -do the following: + The way in which the GNOME Desktop implements menus enables you to do +the following: Customize the menu hierarchy easily. The menu hierarchy is @@ -28,7 +27,7 @@ about the menu hierarchy to applications when you install the applications.Configure menus so that users cannot modify the menus. - Menus in the GNOME desktop use the following components: + Menus in the GNOME Desktop use the following components: File abstraction layer @@ -104,7 +103,7 @@ for all users - Vfolders + Vfolders and Menus menus vfolders @@ -117,7 +116,7 @@ a vfolder is a virtual representation of items that reside in a physical location or physical locations on your system. For example, a vfolder might represent the contents of several directories. A vfolder is an abstraction from one or more physical locations. In terms of menus in the -GNOME desktop, a vfolder is a representation in a menu of items that might +GNOME Desktop, a vfolder is a representation in a menu of items that might be physically located in several directories. menus @@ -380,7 +379,7 @@ links to a file, folder, or FTP site. Specifies -the help file to display when you choose Help on application_name from the menu item popup menu. +the help file to display when you choose Help on application-name from the menu item popup menu. @@ -409,11 +408,10 @@ URL: http://www.freedesktop.org/standards/desktop-entry-spec/desktop-entry-spec.html - Panel launchers and desktop background objects also use desktop -entry files. The desktop entry files for launchers and desktop background -objects provide the same information as for items in a menu. For example, -the desktop entry files provide the command to run when a user chooses the -launcher or object. + Panel launchers and desktop objects also use desktop entry files. +The desktop entry files for launchers and desktop objects provide the same +information as for items in a menu. For example, the desktop entry files provide +the command to run when a user chooses the launcher or object. @@ -507,7 +505,7 @@ or the filename extension. menus editing - You use the following desktop components to edit menus: + You use the following desktop environment components to edit menus: Nautilus file manager @@ -544,10 +542,11 @@ menus. file manager - adding menus with + adding menus +with - To add a menu for all users, -perform the following steps: + To add a menu for all users, perform the +following steps: In a file manager window, access the location where you want diff --git a/gnome2-system-admin-guide/C/mimetypes.xml b/gnome2-system-admin-guide/C/mimetypes.xml index ac3ff2f..759a681 100644 --- a/gnome2-system-admin-guide/C/mimetypes.xml +++ b/gnome2-system-admin-guide/C/mimetypes.xml @@ -1,12 +1,11 @@ - MIME Types This chapter describes how applications detect MIME types, -how to register MIME types, and how to add applications to the GNOME desktop. +how to register MIME types, and how to add applications to the desktop environment. - Introduction + Introduction to MIME Types MIME types introduction @@ -17,9 +16,9 @@ to read the file. Applications such as Internet browsers and email applications use the MIME type to handle files of different types. For example, an email application can use the MIME type to detect what type of file is in a file attached to an email. - In the GNOME desktop, the Nautilus file manager -uses MIME types to identify the type of a file. The file manager needs to -know the MIME type of a file to perform the following tasks: + The Nautilus file manager uses MIME types +to identify the type of a file. The file manager needs to know the MIME type +of a file to perform the following tasks: Open the file in an appropriate application. @@ -51,7 +50,8 @@ the procedure that you must follow to add a new application. detecting MIME types - Applications can detect the MIME type of a file as follows: + Applications +can detect the MIME type of a file as follows: The application uses file content sniffers @@ -162,141 +162,141 @@ this entry. - - Pattern Masks - - MIME types - pattern mask - - - pattern mask - - A + + + Pattern Masks + + MIME types + pattern mask + + + pattern mask + + A pattern mask identifies bits in the pattern to ignore when searching for a pattern in a file. The following is an example of a file content sniffer with a pattern mask: - 0 string BMxxxx\000\000 &0xffff00000000ffff image/bmp - The pattern and mask in the example are as follows: - - - - - - - - - - - - - - - Pattern - - - - B - - - - - M - - - - - x - - - - - x - - - - - x - - - - - x - - - - - \000 - - - - - \000 - - - - - - Mask - - - - ff - - - - - ff - - - - - 00 - - - - - 00 - - - - - 00 - - - - - 00 - - - - - ff - - - - - ff - - - - - - - The pattern and mask specify a file with the following characteristics: - - - The file begins with BM. - - - BM is followed by four bytes with any values. - - - The four bytes are followed by \000\000. - - - The file content sniffer specifies that the MIME type of files that + 0 string BMxxxx\000\000 &0xffff00000000ffff image/bmp + The pattern and mask in the example are as follows: + + + + + + + + + + + + + + + Pattern + + + + B + + + + + M + + + + + x + + + + + x + + + + + x + + + + + x + + + + + \000 + + + + + \000 + + + + + + Mask + + + + ff + + + + + ff + + + + + 00 + + + + + 00 + + + + + 00 + + + + + 00 + + + + + ff + + + + + ff + + + + + + + The pattern and mask specify a file with the following characteristics: + + + The file begins with BM. + + + BM is followed by four bytes with any values. + + + The four bytes are followed by \000\000. + + + The file content sniffer specifies that the MIME type of files that match the pattern and mask is image/bmp. - MIME Type Registry @@ -368,9 +368,9 @@ is the MIME type of the file. In MIME information files, the filename pattern to search for is written as a regular expression. The format of MIME type entries in MIME information files is as follows: - MIME_type - ext[,priority]: list_of_extensions - regex[,priority]: list_of_regular_expressions + MIME-type + ext[,priority]: list-of-extensions + regex[,priority]: list-of-regular-expressions You can specify a priority value for the filename extension and the regular expression. You can use the priority value to differentiate composite filenames. For example, you can assign a priority of 1 @@ -670,7 +670,7 @@ use. - Adding an Application to the GNOME Desktop + Adding an Application to the Desktop Environment MIME types adding applications @@ -679,15 +679,15 @@ use. applications adding - To add an application to the GNOME desktop, perform the -following steps: + To add an application to the desktop environment, perform +the following steps: Add a menu item for the application. For more information on how to add an item to a menu, see . - Add an icon for the application to /usr/gnome/share/icons/theme_name/icon_size/apps. + Add an icon for the application to /usr/gnome/share/icons/theme-name/icon-size/apps. For more information on icons and themes, see Installing Themes. @@ -706,7 +706,7 @@ registry. For more information on MIME keys files, see Improving Performance This chapter describes how to improve the performance of -the GNOME desktop. +the GNOME Desktop. - Introduction + Introduction to Improving Performance performance, improving introduction This chapter lists several preferences whose -settings you can change to improve the performance of the GNOME desktop. You -can use the gconftool-2 command to set values for preferences +settings you can change to improve the performance of the desktop environment. +You can use the gconftool-2 command to set values for preferences for users. The example commands in this chapter show how to set values in the user configuration source. You can also use the --direct and --config-source options to set mandatory values or default values for preferences. @@ -37,18 +36,24 @@ usage reducing This section describes preferences that -you can set to reduce CPU usage by the GNOME desktop. +you can set to reduce CPU usage by the desktop environment. - To Use Themes Which Require Less CPU Resources + To Use Theme Options Which Require Less CPU Resources + + themes + window frame options + and CPU usage + themes and CPU usage - Some window frame themes load image files to draw the window frame. -Other themes use simpler techniques to draw the window frame. - The default theme is Crux. Crux loads image files, and can be slow on -systems with limited CPU resources. To reduce CPU usage, use one of the following -window frame themes: + Some window frame theme +options load image files to draw the window frame. Other options use simpler +techniques to draw the window frame. + The default window frame option is Crux. Crux loads image files, and +can be slow on systems with limited CPU resources. To reduce CPU usage, use +one of the following window frame options: Atlanta @@ -57,7 +62,8 @@ window frame themes: Esco - The following window frame themes also use less CPU resources than Crux: + The following window frame options also use less CPU resources than +Crux: AgingGorilla @@ -70,30 +76,39 @@ window frame themes: - Metabox does not work well with inverse desktop themes such as -HighContrastInverse. Use Atlanta with inverse desktop themes. + Metabox does not work well with inverse controls options such +as HighContrastInverse. Use Atlanta with inverse controls options. - - themes - changing - - To change the window frame theme, run the following command: - # gconftool-2 --type string ---set /apps/metacity/general/theme theme_name + themeswindow frame optionschangingTo change the window +frame theme option, run the following command: + + # + gconftool-2 --type string +--set /apps/metacity/general/theme option-name + For example, to use Atlanta, run the following command: - # gconftool-2 --type string ---set /apps/metacity/general/theme Atlanta - Alternatively, users can choose ApplicationsDesktop PreferencesThemes, then select the appropriate theme. + + # + gconftool-2 --type string +--set /apps/metacity/general/theme Atlanta + + Alternatively, users can choose ApplicationsDesktop PreferencesTheme, then select the appropriate option. You can use the Metacity Theme Viewer -to measure the performance of a window frame theme, and to preview the theme. +to measure the performance of a window frame option, and to preview the option. To start Metacity Theme Viewer, use the following command: - # metacity-theme-viewer theme_name + + # + metacity-theme-viewer option-name + For example, to measure the performance of Atlanta and preview Atlanta, run the following command: - # metacity-theme-viewer -Atlanta + + # + metacity-theme-viewer +Atlanta + @@ -106,51 +121,35 @@ Atlanta menu icons and CPU usage - Some items in menus display an icon beside the item. To -turn off this feature, run the following command: menu icons turning off - # gconftool-2 ---type bool --set /desktop/gnome/interface/menus_have_icons false + Some items in menus display an icon beside the +item. To turn off this feature, run the following command: + + # + gconftool-2 --type bool +--set /desktop/gnome/interface/menus_have_icons false + Alternatively, users can choose ApplicationsDesktop PreferencesMenus & Toolbars, then deselect the Show icons in menus option. - - To Reduce CPU Usage by Turning On Wireframe Mode - - wireframe mode - and CPU usage - - The Metacity window manager has a wireframe mode for when -you move and resize windows. When wireframe mode is turned on, only the outline -of windows is displayed when you move and resize windows. The contents of -the window do not need to be updated during the move or resize. The contents -of the window are displayed when the move or resize is complete. - - wireframe mode - turning on - - To turn on wireframe mode, run the following command: - # gconftool-2 --type bool ---set /apps/metacity/general/wireframe_move_resize true - To Reduce CPU Usage by Turning Off the Splash Screen splash screen and CPU usage - By default, when users log in to the GNOME desktop, a splash -screen is displayed. Icons are displayed on the splash screen while the user -logs in. You can turn off the splash screen to reduce CPU usage during login. - - splash screen - turning off - - To turn off the splash screen, run the following command: - # gconftool-2 --type bool ---set /apps/gnome-session/options/show_splash_screen false + By default, when users log in to the desktop environment, +a splash screen is displayed. Icons are displayed on the splash screen while +the user logs in. You can turn off the splash screen to reduce CPU usage during +login. + splash screenturning offTo turn off the splash screen, run the following command: + + # + gconftool-2 --type bool +--set /apps/gnome-session/options/show_splash_screen false + Alternatively, users can choose ApplicationsDesktop PreferencesAdvancedSessions, then deselect the Show splash screen on login option. @@ -162,9 +161,12 @@ then deselect the Show splash screen on login option. When users show or hide panels, the panels can show or hide in an animated style. To turn off panel animation, run the following command: - # gconftool-2 --type bool ---set /apps/panel/global/enable_animations false - Alternatively, users can choose ApplicationsDesktop PreferencesAdvancedThemes, + + # + gconftool-2 --type bool +--set /apps/panel/global/enable_animations false + + Alternatively, users can choose ApplicationsDesktop PreferencesAdvancedPanel, then deselect the Animation option. @@ -238,7 +240,7 @@ to never, the CPU usage and the network traffic are reduced. The following table describes the performance preferences for the file -manager. For the fastest performance, set the value of the preferences to never. +manager. For the fastest performance, set the value of the preferences to never. @@ -264,10 +266,13 @@ manager. For the fastest performance, set the value of the preferences to Specifies when to preview the content of text files in the icon that represents the file. To never preview the content of text files, run the following command: - # gconftool-2 --type string --set /apps/nautilus/preferences/show_icon_text -never - Alternatively, users can perform the following -steps: + + # + gconftool-2 --type string --set /apps/nautilus/preferences/ + show_icon_text never + + Alternatively, users can perform +the following steps: Choose EditPreferences from a file manager window, then choose Performance. @@ -288,10 +293,12 @@ preference. Specifies when to show the number of items in folders. To never show the number of items in folders, run the following command: - # gconftool-2 --type string --set /apps/nautilus/preferences/show_directory_item_counts -never - Alternatively, users can perform the following -steps: + + # + gconftool-2 --type string --set /apps/nautilus/preferences/ + show_directory_item_counts never + + Alternatively, users can perform the following steps: Choose EditPreferences from a file manager window, then choose Performance. @@ -312,10 +319,12 @@ Folders preference. Specifies when to show thumbnails of image files. To never show thumbnails, run the following command: - # gconftool-2 --type string --set /apps/nautilus/preferences/show_image_thumbnails -never - Alternatively, users can perform the following -steps: + + # + gconftool-2 --type string --set /apps/nautilus/preferences/ + show_image_thumbnails never + + Alternatively, users can perform the following steps: Choose EditPreferences from a file manager window, then choose Performance. @@ -336,8 +345,11 @@ Files preference. Specifies when to preview the content of sound files. To never preview the content of sound files, run the following command: - # gconftool-2 --type string --set /apps/nautilus/preferences/preview_sound -never + + # + gconftool-2 --type string --set /apps/nautilus/preferences/preview_sound +never + Alternatively, users can perform the following steps: @@ -365,55 +377,56 @@ preference. you to turn off the side pane and the toolbar. To improve file manager performance, turn off the side pane and the toolbar. To turn off the side pane, run the following command: - # gconftool-2 --type bool ---set /apps/nautilus/preferences/start_with_sidebar false + + # + gconftool-2 --type bool +--set /apps/nautilus/preferences/start_with_sidebar false + Alternatively, users can choose EditPreferences from a file manager window, then choose Windows, and then deselect the Display side pane option. The next time that users open a file manager window, the window does not display a side pane. - - file manager - toolbar, turning off - - To turn off the toolbar, run the following command: - # gconftool-2 --type bool ---set /apps/nautilus/preferences/start_with_toolbar false + file managertoolbar, turning +offTo turn off the toolbar, run the following command: + + # + gconftool-2 --type bool +--set /apps/nautilus/preferences/start_with_toolbar false + Alternatively, users can choose EditPreferences from a file manager window, then choose Windows, and then deselect the Display toolbar option. The next time that users open a file manager window, the window does not display a toolbar. You can also turn off the location bar. Users can use the CtrlL keyboard shortcut to display a location bar when required. - - file manager - location bar, turning -off - - To turn off the location bar, run the following + file managerlocation bar, turning +offTo turn off the location bar, run the following command: - # gconftool-2 --type bool ---set /apps/nautilus/preferences/start_with_location_bar false + + # + gconftool-2 --type bool +--set /apps/nautilus/preferences/start_with_location_bar false + Alternatively, users can choose EditPreferences from a file manager window, then choose Windows, and then deselect the Display location bar option. The next time that users open a file manager window, the window does not display a location bar. - To Turn Off the Desktop Background + To Turn Off the Desktop file manager - desktop background, turning -off + desktop, turning off - desktop background - turning off + desktop + turning +off - The file manager contains -a preference that enables users to use Nautilus -to manage the desktop background. Users can disable the desktop background -to improve performance. However, if users disable the desktop background, -users cannot do the following: + The file manager contains a preference that +enables users to use Nautilus to manage the desktop. +Users can disable the desktop to improve performance. However, if users disable +the desktop, users cannot do the following: - Use the Desktop Background menu. + Use the Desktop menu. Use the file manager to change the pattern or color of the @@ -423,9 +436,12 @@ desktop background. Use the Home object and the Trash object. The Home object and the Trash object are not displayed on the desktop. - To disable the desktop background, run the following command: - # gconftool-2 --type bool ---set /apps/nautilus/preferences/show_desktop false + To disable the desktop, run the following command: + + # + gconftool-2 --type bool +--set /apps/nautilus/preferences/show_desktop false + Alternatively, users can choose EditPreferences from a file manager window. Users can then choose Desktop & Trash, and then deselect the Use Nautilus to draw the desktop option. @@ -433,29 +449,37 @@ the Use Nautilus to draw the desktop option. - Reducing X11 Network Traffic + Reducing X Window System Network Traffic reducing - X11 network traffic + X Window System network traffic - X11 network traffic, reducing + X Window System network traffic, +reducing network traffic, reducing - This section describes preferences that you can set to reduce X11 network -traffic on the GNOME desktop. + This section describes preferences that you can +set to reduce X Window System network traffic on the desktop environment. - To Use Themes Which Create Less Network Traffic + To Use Theme Options Which Create Less Network Traffic + + themes + window frame options + and network traffic + themes and network traffic - Remote display protocols do not transfer every pixel in -a block of pixels if all pixels in the block are the same color. - To reduce X11 network traffic, use a window frame theme that uses solid -colors. That is, use one of the following window frame themes: + Remote +display protocols do not transfer every pixel in a block of pixels if all +pixels in the block are the same color. + To reduce X Window System network traffic, use a window frame theme +option that uses solid colors. That is, use one of the following window frame +options: Atlanta @@ -464,7 +488,7 @@ colors. That is, use one of the following window frame themes: Esco - For information on how to change the theme, see . + For information on how to change theme options, see . To Reduce Network Traffic by Turning Off Display of Icons in Menus @@ -473,21 +497,11 @@ colors. That is, use one of the following window frame themes: and network traffic Some items in menus display an icon beside the item. If -the icon is located on another file system, this feature can increase X11 -network traffic. This feature can also increase X11 network traffic if the -panels are displayed on a remote host. +the icon is located on another file system, this feature can increase X Window +System network traffic. This feature can also increase X Window System network +traffic if the panels are displayed on a remote host. For information on how to turn off this feature, see . - - To Reduce Network Traffic by Turning On Wireframe Mode - - wireframe mode - and network traffic - - If the application that displays the window -is running on a remote host, wireframe mode reduces X11 network traffic. - For more information on wireframe mode, see . - Reducing Color Usage and Improving Display Quality @@ -505,48 +519,54 @@ is running on a remote host, wireframe mode reduces X11 network traffic. Many modern computer systems support 24-bit color, that is, 16,777,216 colors. However, many users still use systems that support 8-bit color, that is, 256 colors. - The GNOME desktop uses the Netscape color palette. + The desktop environment uses the websafe color palette. This palette is a general-purpose palette of 216 colors, which is designed to optimize the use of color on systems that support 8-bit color. However, -some visual components of the GNOME desktop are designed for systems that -support 24-bit color. +some visual components of the desktop environment are designed for systems +that support 24-bit color. The following display problems might occur on systems that support 8-bit color: Windows, icons, and background images might appear grainy. - Many themes, background images, and icons use colors that are not in the Netscape color palette. The colors that are not in the palette -are replaced with the nearest equivalent or a dithered approximation. This -use of replacement colors causes the grainy appearance. + Many themes, background images, and icons use colors that are not in the +websafe color palette. The colors that are not in the palette are replaced +with the nearest equivalent or a dithered approximation. This use of replacement +colors causes the grainy appearance. - Applications that do not use the Netscape -color palette have less colors available. Color errors might occur. Some colors -might not appear in the user interface of the application. Some applications -might crash if the application cannot allocate colors. + Applications that do not use the websafe color palette have +less colors available. Color errors might occur. Some colors might not appear +in the user interface of the application. Some applications might crash if +the application cannot allocate colors. Color flashing might occur when users switch between applications -that use the Netscape color palette, and applications -that do not use this palette. The applications that do not use the Netscape color palette might use a custom colormap. When the -custom colormap is used, other visual components might lose colors, then become -unviewable. +that use the websafe color palette, and applications that do not use this +palette. The applications that do not use the websafe color palette might +use a custom colormap. When the custom colormap is used, other visual components +might lose colors, then become unviewable. The following sections describe how to optimize the appearance of the -GNOME desktop for systems that support 8-bit color. +desktop environment for systems that support 8-bit color. - To Use Themes That Use the Netscape Color Palette + To Use Theme Options That Use the Websafe Color Palette + + themes + window frame options + and color usage + themes and color usage - Some window frame themes use colors that are in the Netscape -color palette. Bright and Esco use colors from the Netscape color palette. -Bright and Esco do not have the grainy appearance of other themes on 8-bit -color displays. Use Bright or Esco for the best color display on 8-bit visual -modes. - For information on how to change the theme, see . + Some window +frame theme options use colors that are in the websafe color palette. Bright +and Esco use colors from the websafe color palette. Bright and Esco do not +have the grainy appearance of other window frame options on 8-bit color displays. +Use Bright or Esco for the best color display on 8-bit visual modes. + For information on how to change theme options, see . To Reduce Color Usage by Turning Off Display of Icons in Menus @@ -555,8 +575,8 @@ modes. and color usage Some items in menus display an icon beside the item. If -the icon contains colors that are not in the Netscape -color palette, this feature can increase the number of colors used. +the icon contains colors that are not in the websafe color palette, this feature +can increase the number of colors used. For information on how to turn off this feature, see . @@ -566,7 +586,7 @@ color palette, this feature can increase the number of colors used. and color usage You can turn off the splash screen to make more colors available -for the GNOME desktop and applications. +for the desktop environment and for applications. For information on how to turn off the splash screen, see . @@ -576,16 +596,171 @@ for the GNOME desktop and applications. using solid color Use a solid color for the desktop background. -Use of a solid color reduces the number of colors used by the GNOME desktop. +Use of a solid color reduces the number of colors used by the desktop environment. To set a solid color for the desktop background, run the following commands: - # gconftool-2 --type string ---set /desktop/gnome/background/picture_options none - # gconftool-2 --type string ---set /desktop/gnome/background/color_shading_type solid - # gconftool-2 --type string ---set /desktop/gnome/background/primary_color \#hexadecimal_color + + # + gconftool-2 --type string +--set /desktop/gnome/background/picture_options none + + + # + gconftool-2 --type string +--set /desktop/gnome/background/color_shading_type solid + + + # + gconftool-2 --type string +--set /desktop/gnome/background/primary_color \#hexadecimal-color + Alternatively, users can choose ApplicationsDesktop PreferencesBackground, then choose a solid color for the desktop background. + + Improving Performance of Help + + improving + Help performance + + + Help + improving performance + + + performance, improving + Help + + The source documents for the +Help are XML files. The XML files are converted to HTML, and the Yelp Help browser displays the HTML. The HTML can be pregenerated, that is, the XML can be converted to HTML before +the Help is used. + Alternatively, the conversion can be performed automatically when a +user calls a Help file. If the conversion is performed when the user calls +the Help file, the conversion has a significant impact on the speed with which +Help documents are displayed. + To avoid performance problems with the Help, pregenerate the HTML so +that the Help browser does not need to do the conversion. Use the yelp-pregenerate command to pregenerate a Help document. The syntax +of the yelp-pregenerate command is as follows: + + yelp-pregenerate + + + + + + + filename + + + + + + + The following table describes the options and arguments +for the yelp-pregenerate command: + + + + + + + + Option or Argument + + + Description + + + + + + + + -a + + + + Pregenerates +all XML files that are registered in the ScrollKeeper +database. This option is the default option. + + + + + + -f + + + + Pregenerates +only the XML files that you specify in the command. + + + + + + filename + + + + The name of the XML file or XML files that you want to pregenerate. + + + + + + locale + + + + The +locale for which you want to pregenerate the XML files. The default locale +is C, or English. + + + + + + For example, to pregenerate the English version of all XML files in +the file system, run the following command: + + # + yelp-pregenerate -a + + You do not need to specify the locale in this example, as the default +locale is C. To pregenerate the Spanish version of the gedit manual, run the following command: + + # + yelp-pregenerate -f gedit.xml +es + + When a user opens a Help file, the Help browser does the following: + + + The Help browser searches for the appropriate HTML file. If +the Help browser finds the HTML file, the Help browser compares the modification +dates of the HTML file and the corresponding XML file. If the HTML file is +more recent than the XML file, the HTML file is displayed. + + + If the HTML file is older than the XML file, the XML file +is converted to HTML. + + + If the Help browser does not find a HTML file for a Help document, +the XML file is converted to HTML. + + + In other words, the Help browser displays pregenerated HTML if the pregenerated +HTML file is present. If the pregenerated HTML file is not present, the Help +browser converts the XML file to HTML. + + You might want to pregenerate the Help for any new applications +that you want to add to your desktop environment. If there are severe space +restrictions in your environment, you might choose not to pregenerate the +Help. + + diff --git a/gnome2-system-admin-guide/C/screensavers.xml b/gnome2-system-admin-guide/C/screensavers.xml index 53ed1f0..30311ef 100644 --- a/gnome2-system-admin-guide/C/screensavers.xml +++ b/gnome2-system-admin-guide/C/screensavers.xml @@ -1,4 +1,3 @@ - Setting Screensavers @@ -7,7 +6,7 @@ This chapter also provides information on how to modify the displays that are available for the screensaver. - Introduction + Introduction to Screensavers screensavers introduction @@ -18,15 +17,9 @@ are available for the screensaver. A screensaver is an application that replaces the image on a screen when the screen is not in use. The screensaver -application for the GNOME desktop is XScreenSaver. +application for the GNOME Desktop is XScreenSaver. The following sections describe how to set preferences for the XScreenSaver application, and how to modify the displays that are available for the screensaver. - - The XScreenSaver application does not -allow you to lock your screen if you are logged in as root. -If you want to be able to lock your screen, log in as a normal user. To obtain -system administrator privileges, open a terminal window, then use the su command to log in as root. - Setting Screensaver Preferences @@ -64,7 +57,7 @@ locations, depending on the platform, as follows: - Solaris Operating Environment + Solaris Operating System @@ -75,10 +68,9 @@ locations, depending on the platform, as follows: - To modify screensaver application preferences, users can right-click -on the Lock button, then choose Properties. The user can then modify preferences in the XScreenSaver dialog. When a user modifies the screensaver preferences, the -preferences are stored in the home directory of the user, in the $HOME/.xscreensaver file. For information on screensaver preferences, -see GNOME 2.2 Desktop User Guide. + To modify screensaver application preferences, users can use the Screensaver preference tool. To start the Screensaver preference tool, choose ApplicationsDesktop PreferencesScreensaver from the Menu Panel. When a user modifies +the screensaver preferences, the preferences are stored in the home directory +of the user, in the $HOME/.xscreensaver file. For information on screensaver preferences, see GNOME 2.2 Desktop User Guide. Users can also run the command /usr/X11R6/bin/xscreensaver-demo to open the XScreenSaver dialog. To set default screensaver preferences for all users, modify the XScreenSaver file. You can also use the XScreenSaver dialog to create a $HOME/.xscreensaver file, then copy the file to the location of the XScreenSaver @@ -91,7 +83,10 @@ want to change this default display behavior. To activate changes to the screensaver preferences, use the following command to reload screensaver preferences: - # xscreensaver-command -restart + + # + xscreensaver-command -restart + The xset application does not work with XScreenSaver at the time of publication of @@ -114,11 +109,11 @@ file. to the /usr/X11R6/lib/xscreensaver/hacks directory. Add the command for the screensaver display to the XScreenSaver file or the $HOME/.xscreensaver file. Include any arguments that are required to run the screensaver display on the whole -desktop, rather than in a window. For example, you might want to include the -root option to display the screensaver display on the desktop. - To disable a screensaver display, add -a minus sign (-) at the start of the command for the screensaver display in -the preferences file. The following excerpt from a $HOME/.xscreensaver file shows a disabled Qix (solid) screensaver -display: +screen, rather than in a window. For example, you might want to include the -root option to display the screensaver display on the whole screen. + To disable a screensaver display, add a minus sign (-) at +the start of the command for the screensaver display in the preferences file. +The following excerpt from a $HOME/.xscreensaver file +shows a disabled Qix (solid) screensaver display: - "Qix (solid)" qix -root -solid -segments 100 diff --git a/gnome2-system-admin-guide/C/sessions.xml b/gnome2-system-admin-guide/C/sessions.xml index 01b19eb..d7db396 100644 --- a/gnome2-system-admin-guide/C/sessions.xml +++ b/gnome2-system-admin-guide/C/sessions.xml @@ -1,4 +1,3 @@ - Session Management @@ -7,17 +6,17 @@ how to set session defaults. The chapter also contains information on sessions and login scripts. - Introduction + Introduction to Sessions sessions introduction - A GNOME desktop session occurs between the time that a user -logs in to the GNOME desktop and the time that the user logs out. The session -manager starts after the Login Manager authenticates -the user. The session manager enables the user to manage the session. For -example, a user can save the state of a session and return to that session -the next time that the user logs in. + A session occurs between the time that a user logs in to +the desktop environment and the time that the user logs out. The session manager +starts after the Login Manager authenticates the +user. The session manager enables the user to manage the session. For example, +a user can save the state of a session and return to that session the next +time that the user logs in. At a minimum, the following applications run in a session: @@ -28,7 +27,7 @@ the next time that the user logs in. The gnome-panel application, which -runs the panels on the GNOME desktop. +runs the panels in the desktop environment. The Metacity window manager. @@ -91,24 +90,4 @@ the default settings in /usr/share/gnome/default.session are used. To save the current session as the default session, users can run the gnome-session-save command. - - Login Scripts - - sessions - login scripts - - The GNOME desktop does not support system-wide login scripts -or logout scripts. The session manager only allows users to configure user -sessions. Users can configure non-session-managed startup applications with -the Sessions preference tool. - - You can work around the lack of support for system-wide login scripts. -To create a system-wide login script, create the script in the /usr/dt/config/Xsession.d directory. Name the script as follows: - - number_greater_than_1000.name - - For example, name the script 1050.login. For more -information on the /usr/dt/config/Xsession.d file, see The XSession File in the dtlogin1 man page. - - diff --git a/gnome2-system-admin-guide/C/system-admin-guide.xml b/gnome2-system-admin-guide/C/system-admin-guide.xml index 790eaab..3953ab9 100644 --- a/gnome2-system-admin-guide/C/system-admin-guide.xml +++ b/gnome2-system-admin-guide/C/system-admin-guide.xml @@ -1,14 +1,15 @@ - - + + + + @@ -51,6 +52,14 @@ Sun Microsystems GNOME Documentation Project + + + GNOME 2.2 Desktop System Administration Guide V2.1 + January 2003 + + Sun Microsystems + GNOME Documentation Project + GNOME 2.0 Desktop System Administration Guide V2.0 @@ -74,6 +83,7 @@ &menustructure; &themes; &mimetypes; +&gdm; &screensavers; &sessions; &performance; diff --git a/gnome2-system-admin-guide/C/themes.xml b/gnome2-system-admin-guide/C/themes.xml index 1384d8d..02620aa 100644 --- a/gnome2-system-admin-guide/C/themes.xml +++ b/gnome2-system-admin-guide/C/themes.xml @@ -1,138 +1,300 @@ - Installing Themes - This chapter describes the types of theme that are available -in the GNOME desktop, how to install themes, and how to create a custom theme. + This chapter describes themes, the theme settings that are +available in the GNOME Desktop, how to install options for theme settings, +and how to create a custom option. - Introduction + Introduction to Themes themes introduction A theme is a group of coordinated settings that specifies the visual -appearance of a part of the GNOME desktop. Users can choose themes to change -the appearance of the desktop. - The following types of theme affect different parts of the GNOME desktop: +appearance of a part of the desktop environment. Users can choose themes to +change the appearance of the desktop. + A theme contains settings that affect different parts of the GNOME desktop, +as follows: - Desktop themes + Controls + + themescontrols optionsintroductionGTK+ themesthemes, controls optionsThe controls setting for a theme determines the visual +appearance of windows, panels, and applets. The controls setting also determines +the visual appearance of the GNOME-compliant interface items that appear on +windows, panels, and applets, such as menus, icons, and buttons. Some of the +controls setting options that are available are designed for special accessibility +needs. Users can choose an option for the controls setting from the Controls tabbed section in the Theme +preference tool. + + + + Window frame - desktop -themes - themes + themes + window frame options + introduction - Desktop themes determine -the visual appearance of windows, panels, and applets. Desktop themes also -determine the visual appearance of the GNOME-compliant interface items that -appear on windows, panels, and applets, such as menus, icons, and buttons. -Some of the desktop themes that are available in GNOME are designed for special -accessibility needs. Users can choose a desktop theme from the Widget Theme tabbed section in the Theme -preference tool. + + Metacity themes + themes, window frame options + + The window frame setting +for a theme determines the appearance of the frames around windows only. Users +can choose an option for the window frame setting from the Window +Border tabbed section in the Theme preference +tool. - Window frame themes + Icon - window frame themes - themes + themes + icons options + introduction + + + icon themes + themes, icons options - Window frame -themes determine the appearance of the frames around windows only. Users can -choose a window frame theme from the Window Frames tabbed -section in the Theme preference tool. + The icon setting for a theme determines the appearance of +the icons on panels and the desktop background. Users can choose an option +for the icon setting from the Icons tabbed section in +the Theme preference tool. - - To Install a Desktop Theme - - themes - desktop theme, installing - - Desktop themes reside in the /usr/share/themes directory. The typical structure of a desktop theme in the file -system is as follows: - + + Theme Index File + Each theme has an index file which defines the characteristics of the +theme. The name of the index file is /usr/share/theme/theme-name/index.theme. + The following is a sample theme index file: + [Desktop Entry] +Type=X-GNOME-Metatheme +Name=High Contrast Large +Name[es]=Alto contraste grande +Comment=Large black-on-white text and icons +Comment[es]=Textos e iconos grandes en negro sobre blanco +Encoding=UTF-8 + +[X-GNOME-Metatheme] +GtkTheme=HighContrastLargePrint +IconTheme=HighContrast +MetacityTheme=Atlanta +ApplicationFont=sans 18 + + The following table describes the keys in theme index files: + + Keys in Theme Index Files - - + + + + + + Index File Key + + + Description + + + - - Theme file - - + - /usr/share/themes/theme_name/gtk-2.0/gtkrc + Type + + Specifies that this theme determines the appearance +of several theme options, such as controls, window frames, and icons. + - - Image files + + + Name + - + + The name of the theme. This is the name of +the theme that is displayed in the Theme preference +tool. + + + + - /usr/share/themes/theme_name/pixmaps/*.* + Comment + + A brief description of the theme. This is +the text that is displayed under the name of the theme in the Theme preference tool. + - - - - Typically, a new desktop theme is supplied as a .tar.gz -file. To install the new desktop theme, unzip the .tar.gz -file, then untar the .tar file into the /usr/share/themes directory. - If a user adds a desktop theme, the theme is stored in the $HOME/.themes directory. - Users can install their own desktop themes. If a user installs a desktop -theme, the theme is stored in the $HOME/.themes directory. - - - To Install a Window Frame Theme - - themes - window frame theme, installing - - Window frame themes reside in the /usr/share/themes/theme_name/metacity-1 -directory. The typical structure of a window frame theme in the file system -is as follows: - - - - - - - Theme file + + + GtkTheme + + + + Corresponds to the controls setting in the Theme +preference tool. Specifies which controls setting option to apply to windows, +panels, and applets. - + + + - /usr/share/themes/theme_name/metacity-1/metacity-theme-1.xml + IconTheme + + Corresponds to the icons setting in the Theme preference +tool. Specifies which icons setting option to apply to panels and the desktop +background. + - - Image files + + + MetacityTheme + - + + Corresponds to the window frame setting in the Theme +preference tool. Specifies which window frame setting option to apply to windows. + + + + - /usr/share/themes/theme_name/metacity-1/*.* + ApplicationFont + + Corresponds to the application font setting +in the Font preference tool. + - - Typically, a new window frame theme is supplied as a .tar.gz file. To install the new window frame theme, unzip the .tar.gz file, then untar the .tar file into -the /usr/share/themes directory. - Users can install their own window frame themes. If a user installs -a window frame theme, the theme is stored in the $HOME/.themes -directory. +
+ + + To Install a New Controls Option + + themes + controls options + installing + + You can add a new option +for the controls setting in the Theme preference +tool. Controls options reside in the /usr/share/themes +directory. The typical structure of a controls option in the file system is +as follows: + + + Option file + + + /usr/share/themes/option-name/gtk-2.0/gtkrc + + + + + Image files + + + /usr/share/themes/option-name/pixmaps/*.* + + + + + Typically, a new option for the controls setting is supplied +as a .tar.gz file. To install the new controls option, +unzip the .tar.gz file, then untar the .tar file into the /usr/share/themes directory. + Users can install their own options for the controls setting. If a user +installs an option for the controls setting, the option is stored in the $HOME/.themes directory. + + + To Install a New Window Frame Option + + themes + window frame options + installing + + You can add a new option +for the window frame setting in the Theme preference +tool. Window frame options reside in the /usr/share/themes/option-name/metacity-1 directory. The typical structure +of a window frame option in the file system is as follows: + + + Option file + + + /usr/share/themes/option-name/metacity-1/metacity-theme-1.xml + + + + + Image files + + + /usr/share/themes/option-name/metacity-1/*.* + + + + + Typically, a new option for the window frame setting +is supplied as a .tar.gz file. To install the new window +frame option, unzip the .tar.gz file, then untar the .tar file into the /usr/share/themes directory. + Users can install their own options for the window frame setting. If +a user installs an option for the window frame setting, the option is stored +in the $HOME/.themes directory. + + + To Install a New Icons Option + + themes + icons options + installing + + You can add a new option for the icons +setting in the Theme preference tool. Icons options +reside in the /usr/share/icons/option-name +directory. The typical structure of an icons option in the file system is +as follows: + + + Option file + + + /usr/share/icons/option-name + + + + + Image files + + + /usr/share/icons/option-name/icons/*.* + + + + + Typically, a new option for the icons setting +is supplied as a .tar.gz file. To install the new icons +option, unzip the .tar.gz file, then untar the .tar file into the /usr/share/icons directory. + Users can install their own options for the icons setting. If a user +installs an option for the icons setting, the option is stored in the $HOME/.icons/option-name directory. Installing Icons for Themes @@ -140,16 +302,28 @@ directory. themes installing icons - The GNOME desktop provides several themes that are designed -for users with special visual needs. For example, some of the themes are designed -for users with low vision. The themes contain several versions of each icon -so that the icon can be displayed in each theme. + The desktop environment provides several themes that are +designed for users with special visual needs. For example, some of the themes +are designed for users with low vision. Several versions of icons might be +required so that the icon can be displayed properly in each theme. You might need to install a new icon for an application. When you install a new icon, you must create several versions of the icon, so that the icon -displays correctly in the themes. You can create the icons in several formats, -for example Portable Network Graphic (PNG) format. The suggested size of icons -for the GNOME desktop is 48 pixels by 48 pixels. At this size, most themes -can rescale the icons. +displays correctly in the themes. You must create several versions of the +following types of icon: + + + Icons that are used within applications in the desktop environment. + + + Icons that are used internally by GTK+ applications, or GTK+ +stock icons. + + + When you install a new icon, you must create several versions of the +icon, so that the icon displays correctly in the themes. You can create the +icons in several formats, for example Portable Network Graphic (PNG) format. +The suggested size of icons for the desktop environment is 48 pixels by 48 +pixels. At this size, most themes can rescale the icons. When you install a new icon, create the following 48 × 48 pixel versions of the icon: @@ -174,32 +348,24 @@ to add icons to the HighContrast theme, add the icons to the /usr/shar For example, to add icons to the HighContrast theme, add references to the icons to the /usr/share/themes/HighContrast/gtk-2.0/gtkrc file. - The instructions above apply only to the following types of icon: - - - Icons that are used within applications in the GNOME desktop. - - - Icons that are used internally by GTK+ applications, or GTK+ -stock icons. - - For more information on how to create icons for application launchers and for panels, see http://www.freedesktop.org/standards/icon-theme-spec.html. - To Create a Custom Desktop Theme + To Create a Custom Controls Option themes - creating custom desktop + controls options + creating custom - If the desktop themes that the GNOME desktop provides are -not suitable for the needs of your users, you can create a custom desktop -theme. To create a custom desktop theme, perform the following steps: + If the options for the +controls setting are not suitable for the needs of your users, you can create +a custom controls option. To create a custom controls option, perform the +following steps: - Create a directory structure for the theme in the /usr/share/themes directory. Use the same directory structure that -other themes use. For example, to create a theme that is called SmallPrint, + Create a directory structure for the option in the /usr/share/themes directory. Use the same directory structure that +other options use. For example, to create an option that is called SmallPrint, create the following directories: @@ -215,22 +381,22 @@ create the following directories: - Locate the gtkrc theme file that is closest -to meeting the needs of your users. Copy the file to the gtk-2.0 directory of your new theme. + Locate the gtkrc file that is closest +to meeting the needs of your users. Copy the file to the gtk-2.0 directory of your new option. Open the gtkrc file in a text editor, and modify the attributes of the interface elements as required. - If the new theme includes images, install the images for the -new theme in the pixmaps directory of your new theme. -If the new theme uses images from another theme, you do not need to create -copies of the images for the new theme. Instead, ensure that the reference + If the new option includes images, install the images for +the new option in the pixmaps directory of your new option. +If the new option uses images from another option, you do not need to create +copies of the images for the new option. Instead, ensure that the reference to the images in the pixmap_path entry in the gtkrc file is correct. - Users can now choose the new theme. + Users can now choose the new option for the controls setting. For more information on gtkrc files, see http://developer.gnome.org/doc/API/2.0/gtk/index.html. -- cgit