.. include:: /urls.rst

.. _pureos_configuration_keyboard:

Keyboard Layout
===============

THis guide describes how to configure your keyboard layout.

Open the **GNOME Control Center** and click **Region & Language**.
Click the **+** button to add another layout:

.. image:: ../img/gnome-control-center/keyboard/add-input-source.png
   :scale: 50%
   :alt: Adding an input source
   :class: no-scaled-link

...for example, another English layout:

.. image:: ../img/gnome-control-center/keyboard/add-input-source-selection-collapsed.png
   :scale: 50%
   :alt: Add an Input Source menu
   :class: no-scaled-link

...for example, Dvorak:

.. image:: ../img/gnome-control-center/keyboard/2.png
   :scale: 50%
   :alt: Input source language selection
   :class: no-scaled-link

Select the layout and click **Add**:

.. image:: ../img/gnome-control-center/keyboard/3.png
   :scale: 50%
   :alt: Selecting the Dvorak keyboard
   :class: no-scaled-link

You can also add other other layouts, click the kebab (⁝) button:

.. image:: ../img/gnome-control-center/keyboard/5.png
   :scale: 50%
   :alt: Kebab button
   :class: no-scaled-link

...and then **Other**:

.. image:: ../img/gnome-control-center/keyboard/add-input-source.png
   :scale: 50%
   :alt: Selecting "Other" input sources
   :class: no-scaled-link

You can either scroll for the language, or simply type into the search bar, select it and click **Add**:

.. image:: ../img/gnome-control-center/keyboard/7.png
   :scale: 50%
   :alt: Adding an input source (Serbian)
   :class: no-scaled-link

The final list of the keyboard layouts:

.. image:: ../img/gnome-control-center/keyboard/8.png
   :scale: 50%
   :alt: Input source was added
   :class: no-scaled-link

You can order them, use the up/down arrow buttons:

.. image:: ../img/gnome-control-center/keyboard/9.png
   :scale: 50%
   :alt: Up/down arrow buttons
   :class: no-scaled-link

You can remove a layout by clicking the **-** button:

.. image:: ../img/gnome-control-center/keyboard/10.png
   :scale: 50%
   :alt: Removing an input source
   :class: no-scaled-link

Click the **Options** button to get more advanced options:

.. image:: ../img/gnome-control-center/keyboard/add-input-source.png
   :scale: 50%
   :alt: Enabling different sources for each window
   :class: no-scaled-link

Additional keyboard layouts
---------------------------

You need to specifically enable additional keyboard layouts in the **GNOME Tweaks** tool:

.. image:: ../img/gnome-tweaks/alt_key.png
   :scale: 50%
   :alt: Show extended input sources
   :class: no-scaled-link

Log out and log back in for the setting to take effect, and open **Region & Language** settings to see additional layouts.
For example, you can click on **English** to list additional language variants that match the US physical keyboard layout:

.. image:: ../img/gnome-tweaks/german_us2.png
   :scale: 50%
   :alt: Adding an input source (German)
   :class: no-scaled-link

Troubleshooting
---------------

I do not see my language on the list
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Edit the file ``/etc/locale.gen`` and uncomment (remove leading ``#``) your language code, for example:

``#de_DE.UTF-8 UTF-8`` change to ``de_DE.UTF-8 UTF-8``

and then run in terminal:

``sudo locale-gen``

Your language (in this case German-Germany) should appear on the list.

Quickly changing keyboard layouts
---------------------------------

Now that you have added multiple keyboard layouts to your user session through the steps above, you can now quicky change between them:

#. Press the layout button in the on the upper right corner of the screen
#. Select the language you want

.. image:: ../img/change-layout-v2.jpg
   :scale: 100%
   :alt: Quickly changing a keyboard layout in GNOME
   :class: no-scaled-link