``profile::gnome``
==================

This module installs and configures the Gnome desktop environment.


Parameters
----------

===============================  ========  ================================================
**Name**                         **Type**  **Default**
-------------------------------  --------  ------------------------------------------------
banner_message                   string
enable_update_notifications      bool
favorites                        list
keyboard_layouts                 list
===============================  ========  ================================================


``banner_message``
~~~~~~~~~~~~~~~~~~

The message displayed above the login prompt.


``enable_update_notifications``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Whether or not ``gnome-software`` is started at the beginning of a session to
notify the user about available updates.


``favorites``
~~~~~~~~~~~~~

The applications/directories/etc to be displayed in the *Favorites* menu and/or
the Gnome dock. Each member of the list must be a string containing the full
name (not path!) of the ``.desktop`` file, eg. ``gnome-terminal.desktop`` for
the Gnome Terminal.


``keyboard_layouts``
~~~~~~~~~~~~~~~~~~~~

A list of the keyboard mappings which should be available on the login screen.
The first mapping in the list is the default.