diff --git a/_toc.yml b/_toc.yml index 9f8d577e..53fd3053 100644 --- a/_toc.yml +++ b/_toc.yml @@ -94,13 +94,13 @@ chapters: - file: admin-guide/configuration/software/citrix_vda - file: admin-guide/configuration/files sections: + - file: admin-guide/configuration/files/distribute_files - file: admin-guide/configuration/files/windows_drives_in_home - file: admin-guide/configuration/files/central_storage_mount - file: admin-guide/configuration/files/partially_shared_home + - file: admin-guide/configuration/files/mount - file: admin-guide/configuration/files/autofs - file: admin-guide/configuration/files/afs - - file: admin-guide/configuration/files/mount - - file: admin-guide/configuration/files/distribute_files - file: admin-guide/configuration/files/systemd_tmpfiles - file: admin-guide/configuration/files/partitioning - file: admin-guide/configuration/files/resize_vm_disk @@ -117,8 +117,9 @@ chapters: - file: admin-guide/configuration/desktop/autologin - file: admin-guide/configuration/desktop/screen_lock - file: admin-guide/configuration/desktop/banner_message - - file: admin-guide/configuration/desktop/alternative_desktops + - file: admin-guide/configuration/desktop/gnome_extentions - file: admin-guide/configuration/desktop/dconf + - file: admin-guide/configuration/desktop/alternative_desktops - file: admin-guide/configuration/monitoring sections: - file: admin-guide/configuration/monitoring/icinga2 diff --git a/admin-guide/configuration/desktop/gnome_extensions.md b/admin-guide/configuration/desktop/gnome_extensions.md new file mode 100644 index 00000000..0a234c55 --- /dev/null +++ b/admin-guide/configuration/desktop/gnome_extensions.md @@ -0,0 +1,54 @@ +# Gnome Extensions + +Various extensions allow to extend the Gnome Desktop functionality. + +## Installing a Extension + +The systemwide installation directory for extensions is `/usr/share/gnome-shell/extensions/`, but they can also be installed for just a single user in `~/.local/share/gnome-shell/extensions/`. + +Gnome extensions can be installed as software package, via browser and the [Gnome Extensions Website](https://extensions.gnome.org/) or manually. + +## Configure an Extension for all Users + +In Hiera add the identifier/technical name of the desired extension to the `gnome::custom_extensions` list: + +``` +gnome::custom_extensions: + - 'desktop-icons@gnome-shell-extensions.gcampax.github.com' +``` + +You can figure out the technical name by listing the installation directory (see above chapter) or by checking the list of activated extensions before and after enabling it using the GUI (`Tweaks` on RHEL8 and `Extensions` onr RHEL9+): + +``` +$ dconf dump /org/gnome/shell/ | grep enabled-extensions +enabled-extensions=['appindicatorsupport@rgcjonas.gmail.com', 'desktop-icons@gnome-shell-extensions.gcampax.github.com'] +$ +``` + +For the actual configuration of the extension itself, best do it with the GUI tool and then list the configuration of all extensions as follows: + +``` +$ dconf dump /org/gnome/shell/extensions/ +[dash-to-dock] +show-trash=false +dock-fixed=true +dock-position='BOTTOM' +$ +``` +or watch the changes live with + +``` +$ dconf watch /org/gnome/shell/extensions/ +/org/gnome/shell/extensions/desktop-icons/show-trash + false + +/org/gnome/shell/extensions/desktop-icons/show-home + false +``` +and then bring your changes into your default [dconf configuration](dconf). + +Note that users may still override such configuration. +To these settings do +``` +rm ~/.config/dconf/user +``` diff --git a/user-guide/gnome_desktop_icons.md b/user-guide/gnome_desktop_icons.md index 2a44fef8..dc04f405 100644 --- a/user-guide/gnome_desktop_icons.md +++ b/user-guide/gnome_desktop_icons.md @@ -5,7 +5,7 @@ By default Gnome does not show any more icons on the desktop since version 3. This guide will show how to bring them back. ## Enable Desktop Icon Extension -Start the "Tweak" tool: +Start the "Tweak" tool (note in RHEL9+ this functionality move to the "Extensions" tool): ![Start "Tweak"](gnome_desktop_icons/start_tweak.png)