|
|
|
@ -41,8 +41,8 @@
|
|
|
|
|
</abstract>
|
|
|
|
|
|
|
|
|
|
<keywordset>
|
|
|
|
|
<keyword>KDE</keyword>
|
|
|
|
|
<keyword>TDE</keyword>
|
|
|
|
|
<keyword>administration</keyword>
|
|
|
|
|
<keyword>desktop</keyword>
|
|
|
|
|
<keyword>handbook</keyword>
|
|
|
|
|
<keyword>tutorial</keyword>
|
|
|
|
@ -58,11 +58,11 @@
|
|
|
|
|
|
|
|
|
|
<para>This handbook is a reference guide to
|
|
|
|
|
some &tde; features that are useful to administrators configuring
|
|
|
|
|
multi-user systems. This part also has information that might be useful
|
|
|
|
|
multi-user systems. This guide also has information useful
|
|
|
|
|
to &tde; users with single-user systems: where configuration files are
|
|
|
|
|
stored, what environment variables affect &tde;, and so on. The KIOSK
|
|
|
|
|
framework is the &tde; system which allows administrators to limit
|
|
|
|
|
what users can do in &tde;. That framework is potentially useful in many
|
|
|
|
|
framework is the &tde; system that allows administrators to limit
|
|
|
|
|
what users can do in &tde;. That framework is useful in many
|
|
|
|
|
situations, but especially for running single-function kiosks with,
|
|
|
|
|
for example, only a web browser, hence the name.</para>
|
|
|
|
|
|
|
|
|
@ -90,22 +90,21 @@ class="directory">/opt/trinity</filename>).</para></listitem>
|
|
|
|
|
additional trees can be used for <link
|
|
|
|
|
linkend="user-profiles">profiles</link></para>
|
|
|
|
|
|
|
|
|
|
<informalexample><para>&SuSE; &Linux; for example uses:</para>
|
|
|
|
|
<informalexample><para>For example:</para>
|
|
|
|
|
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
<listitem><para><filename
|
|
|
|
|
class="directory">$<envar>HOME</envar>/.trinity</filename></para></listitem>
|
|
|
|
|
<listitem><para><filename
|
|
|
|
|
class="directory">/opt/trinity</filename>. (This is
|
|
|
|
|
&SuSE;-specific; other distributions may use
|
|
|
|
|
class="directory">/opt/trinity</filename>. (This location is a
|
|
|
|
|
typical default. Some distributions might use
|
|
|
|
|
<filename class="directory">/usr</filename> or <filename
|
|
|
|
|
class="directory">/usr/trinity</filename>)</para></listitem>
|
|
|
|
|
<listitem><para><filename
|
|
|
|
|
class="directory">/etc/opt/trinity</filename>. (This was added by
|
|
|
|
|
&SuSE;).</para></listitem>
|
|
|
|
|
class="directory">/etc/trinity</filename>.</para></listitem>
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
|
|
|
|
|
<para>If you have the KIOSK Admin tool v0.7 or later installed you can
|
|
|
|
|
<para>If you have the KIOSK Admin tool installed you can
|
|
|
|
|
check which directory trees are used with the following command:
|
|
|
|
|
<userinput><command>kiosktool-tdedirs</command>
|
|
|
|
|
<option>--check</option></userinput></para>
|
|
|
|
@ -128,7 +127,7 @@ class="directory">$<envar>HOME</envar>/.trinity/share/mimelnk/text/plain.desktop
|
|
|
|
|
<listitem><para><filename
|
|
|
|
|
class="directory">/opt/trinity/share/mimelnk/text/plain.desktop</filename></para></listitem>
|
|
|
|
|
<listitem><para><filename
|
|
|
|
|
class="directory">/etc/opt/trinity/share/mimelnk/text/plain.desktop</filename></para></listitem>
|
|
|
|
|
class="directory">/etc/trinity/share/mimelnk/text/plain.desktop</filename></para></listitem>
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
|
|
|
|
|
<para>If a user makes a change, the change is written to <filename
|
|
|
|
@ -154,7 +153,7 @@ Shape=circle
|
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
|
<term><filename>/etc/opt/trinity/share/config/foobar</filename></term>
|
|
|
|
|
<term><filename>/etc/trinity/share/config/foobar</filename></term>
|
|
|
|
|
<listitem><programlisting>
|
|
|
|
|
Color=blue
|
|
|
|
|
Position=10,10
|
|
|
|
@ -203,7 +202,7 @@ root writing to $TDEHOME of the user after running
|
|
|
|
|
<seg><filename class="directory">/opt/trinity</filename>, <filename
|
|
|
|
|
class="directory">/usr</filename>, <filename
|
|
|
|
|
class="directory">/usr/trinity</filename></seg>
|
|
|
|
|
<seg>Vendor dependent. Used by &tde; 2. If not set, falls back to
|
|
|
|
|
<seg>Vendor dependent. If not set, falls back to
|
|
|
|
|
compiled-in default.</seg>
|
|
|
|
|
</seglistitem>
|
|
|
|
|
|
|
|
|
@ -212,15 +211,13 @@ compiled-in default.</seg>
|
|
|
|
|
<seg><filename class="directory">/opt/trinity</filename>, <filename
|
|
|
|
|
class="directory">/usr</filename>, <filename
|
|
|
|
|
class="directory">/usr/trinity</filename></seg>
|
|
|
|
|
<seg>New in &tde;3. Can list multiple locations separated by a
|
|
|
|
|
<seg>Can list multiple locations separated by a
|
|
|
|
|
colon. If not set, falls back to $<envar>TDEDIR</envar></seg>
|
|
|
|
|
</seglistitem>
|
|
|
|
|
|
|
|
|
|
</segmentedlist>
|
|
|
|
|
</para>
|
|
|
|
|
<para>Don't <emphasis>need</emphasis> to be set, defaults work just fine.</para>
|
|
|
|
|
<para>Running &tde;2 next to &tde;3? Point $<envar>TDEDIR</envar> to
|
|
|
|
|
&tde; 2 and $<envar>TDEDIRS</envar> to &tde; 3.</para>
|
|
|
|
|
|
|
|
|
|
<informalexample>
|
|
|
|
|
<para>A staff member at a university could have the following
|
|
|
|
@ -228,7 +225,7 @@ settings:</para>
|
|
|
|
|
<programlisting>
|
|
|
|
|
TDEHOME='~/.trinity'
|
|
|
|
|
TDEROOTHOME='/root/.trinity'
|
|
|
|
|
TDEDIRS='/opt/kde_staff:/opt/trinity'
|
|
|
|
|
TDEDIRS='/opt/tde_staff:/opt/trinity'
|
|
|
|
|
</programlisting>
|
|
|
|
|
|
|
|
|
|
</informalexample>
|
|
|
|
@ -239,21 +236,19 @@ TDEDIRS='/opt/kde_staff:/opt/trinity'
|
|
|
|
|
<title>User Profiles</title>
|
|
|
|
|
|
|
|
|
|
<para>In the previous example <filename
|
|
|
|
|
class="directory">/opt/kde_staff</filename> contained additional settings
|
|
|
|
|
class="directory">/opt/tde_staff</filename> contained additional settings
|
|
|
|
|
and applications for staff members. <quote>User Profiles</quote> allow you
|
|
|
|
|
to add this directory only for certain users and not for others. Add the
|
|
|
|
|
following to <filename>/etc/tderc</filename>:</para>
|
|
|
|
|
|
|
|
|
|
<programlisting>
|
|
|
|
|
[Directories-staff]
|
|
|
|
|
prefixes=/opt/kde_staff
|
|
|
|
|
prefixes=/opt/tde_staff
|
|
|
|
|
</programlisting>
|
|
|
|
|
|
|
|
|
|
<para>This creates a profile named <quote>staff</quote> that adds the
|
|
|
|
|
<filename class="directory">/opt/kde_staff</filename> directory
|
|
|
|
|
tree. (Note that &SuSE; &Linux; uses
|
|
|
|
|
<filename>/etc/kde3rc</filename> instead of
|
|
|
|
|
<filename>/etc/tderc</filename>. Now that we have a named profile it
|
|
|
|
|
<filename class="directory">/opt/tde_staff</filename> directory
|
|
|
|
|
tree. Now that we have a named profile it
|
|
|
|
|
can be assigned to users.</para>
|
|
|
|
|
|
|
|
|
|
<para>To map profiles to users a mapping file needs to be specified in
|
|
|
|
@ -261,7 +256,7 @@ can be assigned to users.</para>
|
|
|
|
|
|
|
|
|
|
<programlisting>
|
|
|
|
|
[Directories]
|
|
|
|
|
userProfileMapFile=/etc/kde-user-profile
|
|
|
|
|
userProfileMapFile=/etc/tde-user-profile
|
|
|
|
|
</programlisting>
|
|
|
|
|
|
|
|
|
|
<para>It is now possible to assign a profile based on either the user name
|
|
|
|
@ -269,7 +264,7 @@ or based on the &UNIX; group the user is part of.</para>
|
|
|
|
|
|
|
|
|
|
<para>To assign the staff profile to all users that are a member of the
|
|
|
|
|
&UNIX; group staff_members add the following to
|
|
|
|
|
<filename>/etc/kde-user-profile</filename>:</para>
|
|
|
|
|
<filename>/etc/tde-user-profile</filename>:</para>
|
|
|
|
|
|
|
|
|
|
<programlisting>
|
|
|
|
|
[General]
|
|
|
|
@ -319,8 +314,7 @@ directory tree.</para>
|
|
|
|
|
<varlistentry>
|
|
|
|
|
<term><filename class="directory">lib/trinity</filename></term>
|
|
|
|
|
<listitem><para>This directory contains components, plugins, and other
|
|
|
|
|
runtime loadable objects for use by &tde; 3.<replaceable>x</replaceable>
|
|
|
|
|
applications.</para></listitem>
|
|
|
|
|
runtime loadable objects for use by &tde; applications.</para></listitem>
|
|
|
|
|
</varlistentry>
|
|
|
|
|
</variablelist>
|
|
|
|
|
|
|
|
|
@ -336,7 +330,7 @@ archs.</para>
|
|
|
|
|
<varlistentry>
|
|
|
|
|
<term><filename class="directory">share/applnk</filename></term>
|
|
|
|
|
<listitem><para><literal role="extension">.desktop</literal> files for
|
|
|
|
|
&tde;-menu (old)</para></listitem>
|
|
|
|
|
&tde;-menu (legacy)</para></listitem>
|
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
@ -471,7 +465,7 @@ is used for various &UNIX; sockets.</para>
|
|
|
|
|
<varlistentry>
|
|
|
|
|
<term><filename>$<envar>TDEHOME</envar>/tmp-$<envar>HOSTNAME</envar></filename></term>
|
|
|
|
|
<listitem><para>Usually <filename
|
|
|
|
|
class="directory">/tmp/kde-$<envar>USER</envar>/</filename>, this is used for temporary files.</para>
|
|
|
|
|
class="directory">/tmp/tde-$<envar>USER</envar>/</filename>, this is used for temporary files.</para>
|
|
|
|
|
</listitem>
|
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
|
@ -593,7 +587,7 @@ contains:
|
|
|
|
|
Color=red
|
|
|
|
|
Shape=circle
|
|
|
|
|
</programlisting>
|
|
|
|
|
and <filename>/etc/opt/trinity/share/config/foobar</filename> contains
|
|
|
|
|
and <filename>/etc/trinity/share/config/foobar</filename> contains
|
|
|
|
|
<programlisting>
|
|
|
|
|
[MyGroup]
|
|
|
|
|
Color=blue
|
|
|
|
@ -620,13 +614,13 @@ Shape=circle
|
|
|
|
|
[MyGroup]
|
|
|
|
|
Color=green
|
|
|
|
|
</programlisting>
|
|
|
|
|
and <filename>/opt/kde_staff/share/config/foobar</filename> contains
|
|
|
|
|
and <filename>/opt/tde_staff/share/config/foobar</filename> contains
|
|
|
|
|
<programlisting>
|
|
|
|
|
[MyGroup]
|
|
|
|
|
Color=purple
|
|
|
|
|
Position=20,20
|
|
|
|
|
</programlisting>
|
|
|
|
|
and <filename>/etc/opt/trinity/share/config/foobar</filename> contains
|
|
|
|
|
and <filename>/etc/trinity/share/config/foobar</filename> contains
|
|
|
|
|
<programlisting>
|
|
|
|
|
[MyGroup]
|
|
|
|
|
Color=blue
|
|
|
|
@ -643,7 +637,7 @@ Position=20,20
|
|
|
|
|
</informalexample>
|
|
|
|
|
|
|
|
|
|
<para>To prevent users being able to override default settings,
|
|
|
|
|
settings can be marked immutable. Settings can be made immutable
|
|
|
|
|
settings can be marked <emphasis>immutable</emphasis>. Settings can be made immutable
|
|
|
|
|
individually, per group or per file. An individual entry can be locked
|
|
|
|
|
down by adding <userinput>[$i]</userinput> behind the key, ⪚:
|
|
|
|
|
<programlisting>
|
|
|
|
@ -672,7 +666,7 @@ Color[$i]=blue
|
|
|
|
|
Color=red
|
|
|
|
|
Shape=circle
|
|
|
|
|
</programlisting>
|
|
|
|
|
and <filename>/etc/opt/trinity/share/config/foobar</filename> contains:
|
|
|
|
|
and <filename>/etc/trinity/share/config/foobar</filename> contains:
|
|
|
|
|
<programlisting>
|
|
|
|
|
[MyGroup][$i]
|
|
|
|
|
Color=blue
|
|
|
|
@ -695,13 +689,13 @@ Position=10,10
|
|
|
|
|
Color=red
|
|
|
|
|
Shape=circle
|
|
|
|
|
</programlisting>
|
|
|
|
|
and <filename>/opt/kde_staff/share/config/foobar</filename> contains
|
|
|
|
|
and <filename>/opt/tde_staff/share/config/foobar</filename> contains
|
|
|
|
|
<programlisting>
|
|
|
|
|
[MyGroup]
|
|
|
|
|
Color=purple
|
|
|
|
|
Shape=rectangle
|
|
|
|
|
</programlisting>
|
|
|
|
|
and <filename>/etc/opt/trinity/share/config/foobar</filename> contains
|
|
|
|
|
and <filename>/etc/trinity/share/config/foobar</filename> contains
|
|
|
|
|
<programlisting>
|
|
|
|
|
[MyGroup][$i]
|
|
|
|
|
Color=blue
|
|
|
|
@ -782,9 +776,7 @@ Caption[fr]=Ma Légende
|
|
|
|
|
</informalexample>
|
|
|
|
|
|
|
|
|
|
<para>In general the entries that can appear in a configuration file are not
|
|
|
|
|
documented. With &tde; 3.2 a start has been made to change this. In
|
|
|
|
|
<filename
|
|
|
|
|
class="directory">$<envar>TDEDIR</envar>/share/config.kcfg</filename>, files
|
|
|
|
|
documented. In <filename class="directory">$<envar>TDEDIR</envar>/share/config.kcfg</filename>, files
|
|
|
|
|
can be found that provide a formal description of the possible entries in a
|
|
|
|
|
configuration file. These are used by the new &tde; Configuration Editor
|
|
|
|
|
when available.</para>
|
|
|
|
@ -827,7 +819,7 @@ Auto Save Interval=25
|
|
|
|
|
<sect2 id="tdm">
|
|
|
|
|
<title>&tdm;</title>
|
|
|
|
|
|
|
|
|
|
<para>Always runs as <systemitem class="username">root</systemitem>! Uses
|
|
|
|
|
<para>&tdm; always runs as <systemitem class="username">root</systemitem>. &tdm; uses
|
|
|
|
|
<filename>$<envar>TDEDIR</envar>/share/config/tdmrc</filename> and
|
|
|
|
|
<filename>/etc/X11/xdm/Xservers</filename>. The latter contains entries
|
|
|
|
|
like:</para>
|
|
|
|
@ -854,7 +846,7 @@ Startup - <filename>/etc/X11/xdm/Xstartup</filename> - prepare as root
|
|
|
|
|
Session - <filename>/etc/X11/xdm/Xsession</filename> - starts session as user
|
|
|
|
|
</member>
|
|
|
|
|
<member>
|
|
|
|
|
= For a TDE session: <command>kde</command> or <command>starttde</command>
|
|
|
|
|
= For a TDE session: <command>tde</command> or <command>starttde</command>
|
|
|
|
|
</member>
|
|
|
|
|
<member>
|
|
|
|
|
= If present <filename>~/.xsession</filename> or <filename>~/.xinitrc</filename>
|
|
|
|
@ -872,17 +864,17 @@ Reset - <filename>/etc/X11/xdm/Xreset</filename> - after session finished
|
|
|
|
|
<para>The &tde; startup sequence starts with the
|
|
|
|
|
<filename>starttde</filename> script. In most cases this script gets called
|
|
|
|
|
from the display manager (&tdm;) once the user has been authenticated. Their
|
|
|
|
|
are two very important lines in the <filename>starttde</filename>
|
|
|
|
|
are two important lines in the <filename>starttde</filename>
|
|
|
|
|
script:</para>
|
|
|
|
|
|
|
|
|
|
<programlisting>
|
|
|
|
|
LD_BIND_NOW=true tdeinit +kcminit +knotify and kwrapper
|
|
|
|
|
ksmserver $TDEWM
|
|
|
|
|
LD_BIND_NOW=true $TDEDIR/bin/start_tdeinit_wrapper --new-startup +kcminit_startup
|
|
|
|
|
$TDEDIR/bin/tdeinit_phase1
|
|
|
|
|
</programlisting>
|
|
|
|
|
|
|
|
|
|
<para>The first line starts the <command>tdeinit</command> master process.
|
|
|
|
|
The <command>tdeinit</command> master process is used to start all other
|
|
|
|
|
&tde; processes. It show up in the output of <command>ps
|
|
|
|
|
&tde; processes. It shows up in the output of <command>ps
|
|
|
|
|
<option>aux</option></command> as <computeroutput>tdeinit:
|
|
|
|
|
Running...</computeroutput>. The arguments after <command>tdeinit</command>
|
|
|
|
|
are the names of additional processes to be started. The <token>+</token>
|
|
|
|
@ -957,10 +949,9 @@ needed</para>
|
|
|
|
|
<title><command>tdeinit</command></title>
|
|
|
|
|
<para><command>tdeinit</command> is used to start all other &tde;
|
|
|
|
|
programs. <command>tdeinit</command> can start normal binary program files
|
|
|
|
|
as well as <command>tdeinit</command> loadable modules
|
|
|
|
|
(<acronym>KLM</acronym>s). <acronym>KLM</acronym>s work just like binary
|
|
|
|
|
program files but can be started more efficiently. <acronym>KLM</acronym>s
|
|
|
|
|
live in <filename
|
|
|
|
|
as well as <command>tdeinit</command> loadable modules. Loadable modules
|
|
|
|
|
work just like binary program files but can be started more efficiently.
|
|
|
|
|
Loadable modules live in <filename
|
|
|
|
|
class="directory">$<envar>TDEDIR</envar>/lib/trinity</filename></para>
|
|
|
|
|
|
|
|
|
|
<para>The drawback is that programs started this way appear as
|
|
|
|
@ -983,7 +974,7 @@ knotify
|
|
|
|
|
|
|
|
|
|
<para><computeroutput>tdeinit: Running...</computeroutput> indicates the
|
|
|
|
|
master <command>tdeinit</command> process. The other processes listed are
|
|
|
|
|
programs started as <acronym>KLM</acronym>s.</para>
|
|
|
|
|
programs started as loadable modules.</para>
|
|
|
|
|
|
|
|
|
|
<para>When <command>tdeinit</command> starts for the first time it will
|
|
|
|
|
launch <command>dcopserver</command>, <command>tdelauncher</command>, and
|
|
|
|
@ -1150,7 +1141,7 @@ are:</para>
|
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
|
<term>&klipper;</term>
|
|
|
|
|
<term><command>&klipper;</command></term>
|
|
|
|
|
<listitem><para>A clipboard utility that docks in the panel</para>
|
|
|
|
|
</listitem>
|
|
|
|
|
</varlistentry>
|
|
|
|
@ -1338,14 +1329,14 @@ $XDG_DATA_DIRS/desktop-directories
|
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
|
|
<varlistentry><term>$<envar>XDG_CONFIG_HOME</envar></term><listitem><para>
|
|
|
|
|
(&tde; 3.2) - Defines the base directory relative to which user
|
|
|
|
|
- Defines the base directory relative to which user
|
|
|
|
|
specific configuration files should be stored. Default is
|
|
|
|
|
<filename class="directory">$<envar>HOME</envar>/.config</filename>.</para>
|
|
|
|
|
</listitem>
|
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
|
|
<varlistentry><term>$<envar>XDG_CONFIG_DIRS</envar></term><listitem><para>
|
|
|
|
|
(&tde; 3.2) - Defines the preference-ordered set of base directories
|
|
|
|
|
- Defines the preference-ordered set of base directories
|
|
|
|
|
to search for configuration files in addition to the $<envar>XDG_CONFIG_HOME</envar>
|
|
|
|
|
base directory. The default is <filename class="directory">/etc/xdg</filename> &tde; adds locations from
|
|
|
|
|
$<envar>TDEDIRS</envar> and profiles as well. Used by <literal role="extension">.menu</literal> descriptions in
|
|
|
|
@ -1364,9 +1355,8 @@ $<envar>TDEDIRS</envar> and profiles as well. Used by <literal role="extension">
|
|
|
|
|
|
|
|
|
|
<para><command>tdeinit</command> is used to start all other &tde;
|
|
|
|
|
programs. <command>tdeinit</command> can start normal binary program f iles
|
|
|
|
|
as well as <command>tdeinit</command> loadable modules
|
|
|
|
|
(<acronym>KLM</acronym>s). <acronym>KLM</acronym>s work just like binary
|
|
|
|
|
program files but can be started more efficiently. <acronym>KLM</acronym>s
|
|
|
|
|
as well as <command>tdeinit</command> loadable modules. Loadable modules work just like binary
|
|
|
|
|
program files but can be started more efficiently. Loadable modules
|
|
|
|
|
live in <filename
|
|
|
|
|
class="directory">$<envar>TDEDIR</envar>/lib/trinity</filename></para>
|
|
|
|
|
|
|
|
|
@ -1412,7 +1402,7 @@ package.</para>
|
|
|
|
|
|
|
|
|
|
</chapter>
|
|
|
|
|
|
|
|
|
|
<chapter id="customizing-kde">
|
|
|
|
|
<chapter id="customizing-tde">
|
|
|
|
|
<title>Customizing &tde;</title>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@ -1436,7 +1426,7 @@ package.</para>
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
</para>
|
|
|
|
|
</listitem>
|
|
|
|
|
<listitem><para>Vendor-specific (⪚ &SuSE;'s My Computer)</para>
|
|
|
|
|
<listitem><para>Vendor-specific</para>
|
|
|
|
|
</listitem>
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
|
|
|
|
@ -1454,7 +1444,7 @@ role="extension">.desktop</literal> file:
|
|
|
|
|
Encoding=UTF-8
|
|
|
|
|
Icon=/opt/trinity/share/apps/kdesktop/pics/ksslogo.png
|
|
|
|
|
Type=Link
|
|
|
|
|
URL=http://www.kde.org/
|
|
|
|
|
URL=http://www.trinitydesktop.org/
|
|
|
|
|
</programlisting>
|
|
|
|
|
</para>
|
|
|
|
|
</sect2>
|
|
|
|
@ -1658,19 +1648,17 @@ copied from <filename
|
|
|
|
|
class="directory">/etc/skel/Desktop</filename></para></listitem>
|
|
|
|
|
|
|
|
|
|
<listitem><para><filename
|
|
|
|
|
class="directory">$<envar>TDEDIR</envar>/apps/kdesktop/Desktop</filename>
|
|
|
|
|
class="directory">$<envar>TDEDIR</envar>/share/apps/kdesktop/Desktop</filename>
|
|
|
|
|
(merged)</para></listitem>
|
|
|
|
|
|
|
|
|
|
<listitem><para><filename
|
|
|
|
|
class="directory">$<envar>TDEDIR</envar>/apps/kdesktop/DesktopLinks</filename>
|
|
|
|
|
class="directory">$<envar>TDEDIR</envar>/share/apps/kdesktop/DesktopLinks</filename>
|
|
|
|
|
(copied)</para></listitem>
|
|
|
|
|
|
|
|
|
|
<listitem><para>Device Icons (dynamically
|
|
|
|
|
merged)</para></listitem>
|
|
|
|
|
|
|
|
|
|
<listitem><para>Distribution Specific SUSE Linux copies certain icons
|
|
|
|
|
in starttde.theme from <filename
|
|
|
|
|
class="directory">/opt/trinity/share/config/SuSE/default/</filename></para></listitem>
|
|
|
|
|
<listitem><para>Distribution Specific</para></listitem>
|
|
|
|
|
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
</para>
|
|
|
|
@ -1683,36 +1671,21 @@ class="directory">/opt/trinity/share/config/SuSE/default/</filename></para></lis
|
|
|
|
|
<sect2 id="how-it-works">
|
|
|
|
|
<title>How it Works</title>
|
|
|
|
|
|
|
|
|
|
<para>In &tde; 3.2 a common menu format is introduced at
|
|
|
|
|
<para>A common menu format is used as defined at
|
|
|
|
|
<ulink
|
|
|
|
|
url="http://freedesktop.org/Standards/menu-spec/">http://freedesktop.org/Standards/menu-spec/</ulink></para>
|
|
|
|
|
<para>Before &tde; 3.2:
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
|
|
|
|
|
<listitem><para>Directory structure under <filename
|
|
|
|
|
class="directory">share/applnk</filename></para></listitem>
|
|
|
|
|
|
|
|
|
|
<listitem><para>Directory structure represents menu
|
|
|
|
|
structure</para></listitem>
|
|
|
|
|
|
|
|
|
|
<listitem><para>Each <literal role="extension">.desktop</literal> file
|
|
|
|
|
represents a single application</para></listitem>
|
|
|
|
|
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
<para>It was difficult to rearrange the structure in &tde; 3.2 so the
|
|
|
|
|
new menu format:
|
|
|
|
|
<para>The menu format:
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
<listitem><para>Defines structure in a single .menu file</para></listitem>
|
|
|
|
|
<listitem><para>Is based on categories</para></listitem>
|
|
|
|
|
<listitem><para>is shared between <acronym>GNOME</acronym> and &tde;</para></listitem>
|
|
|
|
|
<listitem><para>is shared between &tde;, &kde;, <acronym>GNOME</acronym>, and Xfce</para></listitem>
|
|
|
|
|
<listitem><para>Supports applnk style menus as well</para></listitem>
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
<informalexample>
|
|
|
|
|
<para>Example from <filename>kde-applications.menu</filename>:
|
|
|
|
|
<para>Example from <filename>tde-applications.menu</filename>:
|
|
|
|
|
<programlisting>
|
|
|
|
|
<markup>
|
|
|
|
|
<Menu>
|
|
|
|
@ -1747,7 +1720,7 @@ Reader.desktop</filename></para></listitem>
|
|
|
|
|
|
|
|
|
|
<para><literal role="extension">.menu</literal> files describing the
|
|
|
|
|
menu structure. The files are stored in <filename
|
|
|
|
|
class="directory">$<envar>TDEDIR</envar>/etc/xdg/menus</filename> and
|
|
|
|
|
class="directory">$<envar>TDEDIR</envar>/xdg/menus</filename> and
|
|
|
|
|
<filename class="directory">/etc/xdg/menus</filename>. These store the
|
|
|
|
|
system-wide menu structure and are controlled by
|
|
|
|
|
$<envar>XDG_CONFIG_DIRS</envar>. <filename
|
|
|
|
@ -1786,7 +1759,7 @@ These are controlled by $<envar>XDG_DATA_HOME</envar>. For more
|
|
|
|
|
information, see <ulink url="http://www.freedesktop.org/Standards/basedir-spec">http://www.freedesktop.org/Standards/basedir-spec</ulink></para>
|
|
|
|
|
|
|
|
|
|
<informalexample>
|
|
|
|
|
<para>Example from <filename>kde-applications.menu</filename>:
|
|
|
|
|
<para>Example from <filename>tde-applications.menu</filename>:
|
|
|
|
|
<programlisting>
|
|
|
|
|
<markup>
|
|
|
|
|
<Menu>
|
|
|
|
@ -1838,25 +1811,20 @@ role="extension">.directory</literal> file</para>
|
|
|
|
|
<title>Essential Menus</title>
|
|
|
|
|
|
|
|
|
|
<para><filename
|
|
|
|
|
class="directory">$<envar>TDEDIR</envar>/etc/xdg/menus/applications-merged/</filename>
|
|
|
|
|
contains <filename>kde-essential.menu</filename> which includes some
|
|
|
|
|
class="directory">/etc/trinity/xdg/menus/applications-merged/</filename>
|
|
|
|
|
contains <filename>tde-essential.menu</filename> which includes some
|
|
|
|
|
essential menus that are normally not shown in the &tde; menu itself:
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
<listitem><para>Control Center has a hidden Settings menu whose
|
|
|
|
|
contents are defined by <filename>kde-settings.menu</filename> and
|
|
|
|
|
whose icon and name are defined by <filename>kde-settings.directory</filename></para>
|
|
|
|
|
</listitem>
|
|
|
|
|
<listitem><para>Info Center has a hidden Information menu whose
|
|
|
|
|
contents are defined by <filename>kde-information.menu</filename> and
|
|
|
|
|
whose icon and name are defined by <filename>kde-information.directory</filename>.</para>
|
|
|
|
|
contents are defined by <filename>tde-settings.menu</filename> and
|
|
|
|
|
whose icon and name are defined by <filename>tde-settings.directory</filename></para>
|
|
|
|
|
</listitem>
|
|
|
|
|
|
|
|
|
|
<listitem><para>Screensavers contains a hidden System/Screensavers menu,
|
|
|
|
|
whose contents are defined by
|
|
|
|
|
<filename>kde-screensavers.menu</filename> and whose icon and name
|
|
|
|
|
<filename>tde-screensavers.menu</filename> and whose icon and name
|
|
|
|
|
are defined by
|
|
|
|
|
<filename>kde-system-screensavers.directory</filename>.
|
|
|
|
|
<filename>$<envar>TDEDIR</envar>/share/desktop-directories/kde-system-screensavers.directory</filename>
|
|
|
|
|
<filename>tde-system-screensavers.directory</filename>.
|
|
|
|
|
<filename>$<envar>TDEDIR</envar>/share/desktop-directories/tde-system-screensavers.directory</filename>
|
|
|
|
|
contains:
|
|
|
|
|
<programlisting>
|
|
|
|
|
NoDisplay=true
|
|
|
|
@ -1878,8 +1846,8 @@ class="directory">$<envar>HOME</envar>/.trinity/share/applnk</filename>
|
|
|
|
|
</sect2>
|
|
|
|
|
|
|
|
|
|
<sect2 id="tdesycoca">
|
|
|
|
|
<title><application>KSycoca</application></title>
|
|
|
|
|
<para><application>KSycoca</application> caches menu structure and
|
|
|
|
|
<title><application>TDESycoca</application></title>
|
|
|
|
|
<para><application>TDESycoca</application> caches menu structure and
|
|
|
|
|
information about all available applications. You can rebuild the
|
|
|
|
|
database with
|
|
|
|
|
<userinput><command>tdebuildsycoca</command></userinput>. The database
|
|
|
|
@ -1890,7 +1858,7 @@ checked during &tde; login, and <application>KDED</application>
|
|
|
|
|
watches for changes while logged in.</para>
|
|
|
|
|
|
|
|
|
|
<para>To disable watching for changes (since it may hurt over NFS) add
|
|
|
|
|
the following to <filename>kdedrc</filename>:
|
|
|
|
|
the following to <filename>tdedrc</filename>:
|
|
|
|
|
<programlisting>
|
|
|
|
|
[General]
|
|
|
|
|
CheckSycoca=false
|
|
|
|
@ -2014,7 +1982,7 @@ default for multiple users.</para>
|
|
|
|
|
|
|
|
|
|
</chapter>
|
|
|
|
|
|
|
|
|
|
<chapter id="locking-down-kde">
|
|
|
|
|
<chapter id="locking-down-tde">
|
|
|
|
|
<title>Locking Down &tde;</title>
|
|
|
|
|
|
|
|
|
|
<sect1 id="how-it-works-the-basics">
|
|
|
|
@ -2103,8 +2071,9 @@ action="simul">&Alt;<keycap>F2</keycap></keycombo> run
|
|
|
|
|
command</para></listitem>
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
</example>
|
|
|
|
|
<para>Full documentation about available actions can be found on <ulink
|
|
|
|
|
url="http://www.kde.org/areas/sysadmin/">http://www.kde.org/areas/sysadmin/</ulink>.</para>
|
|
|
|
|
<!--<para>Full documentation about available actions can be found on <ulink
|
|
|
|
|
url="http://techbase.kde.org/KDE_System_Administration/Kiosk/Keys">
|
|
|
|
|
http://techbase.kde.org/KDE_System_Administration/Kiosk/Keys</ulink>.</para>-->
|
|
|
|
|
|
|
|
|
|
<para>A few of the more interesting actions are listed below:</para>
|
|
|
|
|
|
|
|
|
@ -2244,7 +2213,7 @@ directory.</para></callout>
|
|
|
|
|
|
|
|
|
|
<para>$<envar>HOME</envar> and $<envar>TMP</envar> are special values to
|
|
|
|
|
indicate the users home directory and the &tde; temporary directory of the
|
|
|
|
|
user, ⪚ <filename class="directory">/tmp/kde-bastian</filename></para>
|
|
|
|
|
user, ⪚ <filename class="directory">/tmp/tde-bastian</filename></para>
|
|
|
|
|
|
|
|
|
|
<para>The following rules makes that the user can no longer open local files
|
|
|
|
|
that are outside his $<envar>HOME</envar> directory:</para>
|
|
|
|
@ -2345,6 +2314,8 @@ as part of the <guilabel>Configure Konqueror</guilabel> dialog in
|
|
|
|
|
<itemizedlist>
|
|
|
|
|
<listitem><para><command>tdecmshell</command>
|
|
|
|
|
<filename>tde-proxy.desktop</filename></para></listitem>
|
|
|
|
|
<listitem><para><command>tdecmshell</command>
|
|
|
|
|
<filename>tde-proxy</filename></para></listitem>
|
|
|
|
|
<listitem><para><command>tdecmshell</command> proxy</para></listitem>
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
|
|
|
|
@ -2362,8 +2333,8 @@ menu.</para>
|
|
|
|
|
have a <literal role="extension">.desktop</literal> file in <filename
|
|
|
|
|
class="directory">$<envar>TDEDIR</envar>/share/applications/tde</filename>
|
|
|
|
|
and are sorted under the hidden <guimenu>Settings-Modules</guimenu> menu by
|
|
|
|
|
the <filename>kde-settings.menu</filename>, included from
|
|
|
|
|
<filename>kde-essential.menu</filename></para>
|
|
|
|
|
the <filename>tde-settings.menu</filename>, included from
|
|
|
|
|
<filename>tde-essential.menu</filename></para>
|
|
|
|
|
<screen><userinput><command>tdebuildsycoca</command> <option>--menutest</option> 2> /dev/null | <command>grep</command> Settings-Modules</userinput></screen>
|
|
|
|
|
</listitem>
|
|
|
|
|
<listitem>
|
|
|
|
@ -2373,15 +2344,15 @@ corresponds to the hidden .hidden menu, included as a result of
|
|
|
|
|
<markup><KDELegacyDirs/></markup></para>
|
|
|
|
|
<screen><userinput><command>tdebuildsycoca</command> <option>--menutest</option> 2> /dev/null | <command>grep</command> .hidden</userinput></screen>
|
|
|
|
|
</listitem>
|
|
|
|
|
<listitem><para>In &tde; 3.3 it is possible to edit the Control Center with
|
|
|
|
|
<listitem><para>It is possible to edit the Control Center with
|
|
|
|
|
<application>kcontroledit</application>.
|
|
|
|
|
<application>kcontroledit</application> works just like
|
|
|
|
|
<application>kcontroledit</application> works like
|
|
|
|
|
<application>kmenuedit</application>, changes for current user only. Use
|
|
|
|
|
<application>kiosktool</application> to make changes for
|
|
|
|
|
everyone.</para></listitem>
|
|
|
|
|
</itemizedlist>
|
|
|
|
|
|
|
|
|
|
<para>Individual configuration modules can be disables by adding the
|
|
|
|
|
<para>Individual configuration modules can be disabled by adding the
|
|
|
|
|
following to <filename>kdeglobals</filename>:</para>
|
|
|
|
|
|
|
|
|
|
<screen>[TDE Control Module Restrictions]
|
|
|
|
@ -2394,17 +2365,7 @@ Konqueror</guilabel> dialog if the proxy configuration is still
|
|
|
|
|
there.</para>
|
|
|
|
|
|
|
|
|
|
</sect1>
|
|
|
|
|
<!--
|
|
|
|
|
<sect1 id="making-it-work">
|
|
|
|
|
<title>Making it Work</title>
|
|
|
|
|
|
|
|
|
|
Making It Work
|
|
|
|
|
TDE 3.2: Set $TDEDIRS from starttde script
|
|
|
|
|
Distribute profiles to all clients
|
|
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
</sect1>
|
|
|
|
|
-->
|
|
|
|
|
</chapter>
|
|
|
|
|
|
|
|
|
|
<chapter id="the-lazy-admin">
|
|
|
|
|