This file is indexed.

/usr/share/help/C/ubuntu-help/keyboard-layouts.page is in ubuntu-docs 16.04.3.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
<page xmlns="http://projectmallard.org/1.0/"
      type="topic" style="task"
      id="keyboard-layouts">
  <info>
    <link type="guide" xref="prefs-language#textentry"/>
    <link type="guide" xref="keyboard" group="i18n"/>
    <link type="seealso" xref="keyboard-shortcuts-set"/>

    <revision pkgversion="3.8" version="0.3" date="2013-04-30" status="review"/>
    <revision version="16.04" date="2016-03-17" status="review"/>

    <credit type="author copyright">
      <name>Shaun McCance</name>
      <email>shaunm@gnome.org</email>
      <years>2012</years>
    </credit>
    <credit type="author">
       <name>Julita Inca</name>
       <email>yrazes@gmail.com</email>
    </credit>
    <credit type="editor">
      <name>Michael Hill</name>
      <email>mdhillca@gmail.com</email>
    </credit>
    <credit type="editor">
      <name>Juanjo Marín</name>
      <email>juanj.marin@juntadeandalucia.es</email>
    </credit>
    <credit type="editor">
      <name>Ubuntu Documentation Team</name>
    </credit>

    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>

    <desc>Add input sources and switch between them.</desc>
  </info>

  <title>Use alternative input sources</title>

  <p>Keyboards come in hundreds of different layouts for different languages.
  Even for a single language, there are often multiple keyboard layouts, such
  as the Dvorak layout for English. You can make your keyboard behave like a
  keyboard with a different layout, regardless of the letters and symbols
  printed on the keys. This is useful if you often switch between multiple
  languages.</p>

  <p>Some languages, such as Chinese or Korean, require a more complex input
  method than just a simple key to character mapping. Consequently some of
  the input sources you can choose between enable such a method. More about
  that in the section <link xref="#complex">Complex input methods</link>.</p>

  <section id="add">
    <title>Add input sources</title>

    <note style="sidebar">
      <p>You can preview an image of any layout by selecting it in the list and clicking
      <gui><media type="image" src="figures/input-keyboard-symbolic.svg" width="16" height="16">
      preview</media></gui>.</p>
    </note>

    <steps>
      <item>
       <p>Click the icon at the very right of the menu bar and select <gui>System Settings</gui>.</p>
      </item>
      <item>
       <p>In the Personal section, click <gui>Text Entry</gui>.</p>
      </item>
      <item>
       <p>Click the <gui>+</gui> button, select an input source, and click
       <gui>Add</gui>.</p>
      </item>
    </steps>

    <p>The default source is the source at the top of the list. Use the
    <gui></gui> and <gui></gui> buttons to move sources up and down in
    the list.</p>

    <note style="tip">
      <p>If you select a source with an input method, you can click
      <gui><media type="image" src="figures/input-preferences.png" width="18" height="18">
      preferences</media></gui> to access that method's preferences dialog if any.</p>
    </note>
  </section>

  <section id="indicator">
    <title>Input source indicator</title>

    <p>You can quickly switch between selected sources using the input source
    indicator in the menu bar. The menu will display a short identifier for the
    current source, such as <gui>En</gui> for the standard English layout or a
    symbol in case of a source that uses a special input method, e.g. Chinese
    (Chewing). Click the input source indicator and select from the menu the
    source you want to use.</p>
  </section>

  <section id="shortcuts">
    <title>Keyboard shortcuts</title>

    <p>You can also use keyboard shortcuts to quickly switch between your selected
    input sources. By default the shortcut for switching to next source is
    <keyseq><key xref="windows-key">Super</key><key>Space</key></keyseq>, but you
    can change it:</p>

    <steps>
      <item>
       <p>Click the icon at the very right of the menu bar and select <gui>System Settings</gui>.</p>
      </item>
      <item>
       <p>In the Personal section, click <gui>Text Entry</gui>.</p>
      </item>
      <item>
       <p>Click the current shortcut definition below the label <gui>Switch to
       next source using</gui>.</p>
      </item>
      <item>
       <p>When the shortcut definition has changed to <gui>New accelerator...</gui>,
       press the keys you want to use as the new shortcut.</p>
      </item>
    </steps>
  </section>

  <section id="windows">
    <title>Set input source for all windows or individually for each window</title>

    <p>When you use multiple sources, you can choose to have all windows use the
    same source or to set a different source for each window. Using a different
    source for each window is useful, for example, if you're writing an article
    in another language in a word processor window. Your input source selection will
    be remembered for each window as you switch between windows.</p>

    <p>By default, new windows will use the default input source. You can
    instead choose to have them use the source of the window you were last
    using.</p>
  </section>

  <section id="complex">
    <title>Complex input methods</title>

    <p>Recommended frameworks for input methods are <em>IBus</em> and
    <em>Fcitx</em>. The latter is the default framework in Ubuntu for Chinese,
    Japanese, Korean and Vietnamese.</p>

    <p>Input source options with input methods are only available if respective
    input method (IM) engine is installed. When you install a language, a suitable
    IM engine is automatically installed if applicable.</p>

    <p>For example, to prepare for typing Korean (Hangul) on an English system,
    follow these steps:</p>

    <steps>
      <item>
        <p><link xref="prefs-language-install">Install</link> Korean. One of the
        installed packages is <em>fcitx-hangul</em>, the Hangul IM engine for
        Fcitx.</p>
      </item>
      <item>
        <p>Close <gui>Language Support</gui> and open it again.</p>
      </item>
      <item>
        <p>Select <em>fcitx</em> as the <gui>Keyboard input method system</gui>.</p>
      </item>
      <item>
        <p>Log out and log in again.</p>
      </item>
      <item>
       <p>Click the icon at the very right of the menu bar and select <gui>System Settings</gui>.</p>
      </item>
      <item>
       <p>In the Personal section, click <gui>Text Entry</gui>.</p>
      </item>
      <item>
       <p>Click the <gui>+</gui> button, select <em>Hangul (Fcitx)</em>, and click
       <gui>Add</gui>.</p>
      </item>
    </steps>

    <p>This will make <em>Hangul</em> available in the Fcitx input source indicator
    in the menu bar. (The design differs from the IBus equivalent.)</p>

    <p>If you prefer some other IM engine than the one which is installed
    automatically when you install a language, you can
    <link xref="addremove-install">install</link> the IBus or Fcitx IM engine of
    your choice separately.</p>
  </section>

</page>