= Manual =



Documentations about SmartClient can be found at source:trunk/documentation.

The voluminous (around 100 pages), always outdated and still incomplete manual (in German !) can be found at here: 
  * LaTeX sources: source:trunk/documentation/betriebshandbuch/
  * PDF: [attachment:SmartClient-main.pdf]

Future documentation work should be done in this wiki.

= Server =

= Client =

== SmartClient Components ==

  * [wiki:common/sc_base]
  * [wiki:client/sc_hardware]
  * [wiki:client/sc_mkwsconfig]
  * [wiki:client/sc_install]
  * [wiki:client/sc_desktop_permissions]
  * [wiki:client/sc_kprofile]
  * [wiki:client/sc_ldap2authorizedkeys]
  * [wiki:client/sc_print]
  * [wiki:client/sc_inventar2ldap]
  * [wiki:client/sc_vmware]
  * [wiki:client/sc_tools_client]

== Configuration ==

  * [wiki:client/init]

=== KDE ===

==== KDE4 ====

While the manual describes KDE3 configuration,
our preliminary results for KDE4 are documented at http://techbase.kde.org/Projects/Plasma/Kiosk


===== adding appications =====

Example application: example

Where possible, we store our stuff in a separate subdirectory {{{smartclient}}}

|| {{{/usr/share/applications/example.desktop}}} || general application description, like Name, Exec(utable), Icon. SmartClient subdirectory {{{/usr/share/applications/smartclient/}}} would by possible, but {{{%suse_update_desktop_file}}} does not support directories || ||
|| {{{/usr/share/pixmap/example.png}}}  || application icon (using /usr/share/icons/default.kde4/48x48/apps/example.png is also possible, but more complicated. Also problems occur, if the user changes the default icon them) || ||


====== testing KDE4 icons ======

to test, if an icon is recognised by the system, act as follow:

{{{
# copy the icon example.png or example.svgz to /usr/share/pixmap/
# if available, choose the svgz image format, otherwise png. (xpm does also work)
cp -a example.svgz /usr/share/pixmap/

# create a directory for testing
mkdir /tmp/test

# copy some .desktop files to the testing directory. At least one should have the line "Icon=example"
cp -a example_working.desktop example_testing.desktop /tmp/test

# remove the users icon cache
rm -r ~/.kde4/cache-*/kpc/

# check if the icons gets displayed correctly
strace -e trace=access -o /tmp/test/konq_icon.strace  -f konqueror /tmp/test

# close konqueror

# in case of problems, analyse the strace log file
less /tmp/test/konq_icon.strace
}}}


===== Restrict Access to Appications =====

[wiki:"kde/Application Access Restrictions"]