From Fedora Project Wiki

(transfer the admon about testing different layouts with the same physical keyboard here)
(correct the instructions wrt switched layouts and encryption passphrase in re #681250)
Line 13: Line 13:
# Check the keyboard layout(s) shown under '''KEYBOARD''' on the main screen are appropriate for the language.
# Check the keyboard layout(s) shown under '''KEYBOARD''' on the main screen are appropriate for the language.
# Click '''INSTALLATION DESTINATION''', and check ''Encrypt my data.'' Leave ''Automatically configure partitioning.'' selected. Click ''Done''.
# Click '''INSTALLATION DESTINATION''', and check ''Encrypt my data.'' Leave ''Automatically configure partitioning.'' selected. Click ''Done''.
# Enter an encryption passphrase using characters that are placed differently on the keyboard layout in use than they are on the US keyboard layout. If using a configuration where it is customary to switch between a 'native' layout and the US layout for entering ASCII characters, use at least some characters from the 'native' layout.
# Enter an encryption passphrase using characters that are placed differently on the keyboard layout in use than they are on the US keyboard layout. If using a configuration where it is customary to switch between a 'native' layout and the US layout for entering ASCII characters, use only characters from the '''first''' layout (usually US): due to [[rhbug:681250|#681250]], you cannot use characters from the '''second''' layout when entering the passphrase to decrypt the device.
# If necessary, free up space for the installation via the ''Reclaim space'' screen.
# If necessary, free up space for the installation via the ''Reclaim space'' screen.
# Click ''Begin Installation''.
# Click ''Begin Installation''.

Revision as of 01:07, 29 April 2016

Template documentation [edit]

This documentation is transcluded from Template:Testcase language install/doc. It will not be transcluded on pages that use this template.

This template is used for several of the test cases in Category:I18n Installation, as they are all pretty much identical except for the name of the language or language group to be tested - we want to test install with various languages, and the procedure is the same for each one.

If the test case is to say 'pick a language from (LANGUAGE GROUP), such as (LANGUAGE GROUP MEMBER #1) or (LANGUAGE GROUP MEMBER #2)' it can be invoked thus:

{{Testcase language install|LANGUAGE GROUP|LANGUAGE GROUP MEMBER #1 or LANGUAGE GROUP MEMBER #2}}

If the test case is to say 'pick the specific language (LANGUAGE)', it can be invoked thus:

{{Testcase language install|LANGUAGE}}
Associated release criterion
This test case is associated with the Fedora_42_Final_Release_Criteria#installer-translations release criterion. If you are doing release validation testing, a failure of this test case may be a breach of that release criterion. If so, please file a bug and nominate it as blocking the appropriate milestone, using the blocker bug nomination page.
Associated release criterion
This test case is associated with the Fedora_42_Final_Release_Criteria#keyboard-layout-configuration release criterion. If you are doing release validation testing, a failure of this test case may be a breach of that release criterion. If so, please file a bug and nominate it as blocking the appropriate milestone, using the blocker bug nomination page.


Description

This test case tests installation using the LANGUAGE (GROUP) language. Testing also includes verifying a good keymap is selected during installation and used for all purposes in the installed system.

Testing with just a US keyboard?
You do not need different physical keyboard layouts to complete this test. Logical keyboard layouts are applied independent of physical keyboard hardware; if you test with a US-marked keyboard but pick, e.g., the French keyboard layout, the key marked 'Q' will now produce the character 'A'. Of course, it helps to know how the layout you test with actually looks.

Setup

  1. Prepare a test system with a working, supported storage device of sufficient size for a Fedora install, and a Fedora installation medium that uses the GTK-based installer. Do not use Fedora Workstation live on Fedora 41+, as that uses the webui-based installer.

How to test

  1. Boot the installer using any available means.
  2. On the Welcome screen, choose the LANGUAGE (GROUP) language, and click Continue.
  3. Check the keyboard layout(s) shown under KEYBOARD on the main screen are appropriate for the language.
  4. Click INSTALLATION DESTINATION, and check Encrypt my data. Leave Automatically configure partitioning. selected. Click Done.
  5. Enter an encryption passphrase using characters that are placed differently on the keyboard layout in use than they are on the US keyboard layout. If using a configuration where it is customary to switch between a 'native' layout and the US layout for entering ASCII characters, use only characters from the first layout (usually US): due to #681250, you cannot use characters from the second layout when entering the passphrase to decrypt the device.
  6. If necessary, free up space for the installation via the Reclaim space screen.
  7. Click Begin Installation.
  8. While installation proceeds, create a user account, using characters that are placed differently on the keyboard layout in use than they are on the US keyboard layout in the username and/or password. If using a configuration where it is customary to switch between a 'native' layout and the US layout for entering ASCII characters, use at least some characters from the 'native' layout.
  9. Boot the installed system. When prompted, enter the encryption passphrase.
  10. Log in to the booted system using the user you created.
  11. Check the keyboard layout in use in the user's session.

Expected Results

  1. The correct character set is displayed in the language selection step.
  2. An appropriate keymap is selected based on the language and location selected.
  3. Text input using the selected keymap works as expected.
  4. Text for which a translation is available is shown translated.
  5. The encryption passphrase entered during installation works on boot of the installed system (i.e. the correct keymap is used when decrypting encrypted partitions).
  6. The username and password entered during installation work to log in to the installed system (i.e. the correct keymap is used when logging in).
  7. The correct keymap is used as the default when logged in to the system.
  8. If using a configuration where it is customary to switch between a 'native' layout and the US layout for entering ASCII characters, switching works at all points (passphrase entry, login, and when logged in).