Amaya

## Entering characters

To enter characters that are not directly available from the keyboard, Amaya uses the standard services provided by the Operating System. An optional multi-key support is also provided for Motif and Windows versions.

Amaya provides a mechanism for assigning keyboard shortcuts to characters that are not directly available from the keyboard. Some of them are pre-defined:

- To enter a non-breaking space, press `Ctrl-space`
  This character is displayed in the source view under the form of the following colored character: ~
- To enter a œ (oelig), press `Ctrl-o Ctrl-e`
- To enter a Œ (OElig), press `Ctrl-Shift-O Ctrl-Shift-E`
- To enter a «, press `Ctrl-[`
- To enter a », press `Ctrl-]`

The input methods for Unix and Mac OS X are presented below.

### About Unix standard multi-key support

If a character is unavailable on the keyboard, you can insert the character by pressing the special `Compose` key followed by a sequence of two other keys. See the table below for the keys used to insert various characters. Note that in Amaya you can change the order of the two keys.

If your keyboard does not contain a `Compose` key, you can attach it to an existing key such as `Alt-Gr` with the following `xmodmap` command:

`keycode 113 = Multi_key`

You can place this command in the `$HOME/.Xmodmap` file, and Amaya will apply it when you will launch your X server.

Name | Code | First key | Second key | Output
AElig | 198 | <Shift> A | <Shift> E | Æ
Aacute | 193 | <Shift> A | quote | Á
Acirc | 194 | <Shift> A | circumflex | Â
Agrave | 192 | <Shift> A | backquote | À
Aring | 197 | <Shift> A | star | Å
Atilde | 195 | <Shift> A | tilde | Ã
Auml | 196 | <Shift> A | double quote | Ä
Ccedil | 199 | <Shift> C | comma | Ç
Eth | 222 | - | D | Ð
Eacute | 201 | <Shift> E | quote | É
Ecirc | 202 | <Shift> E | circonflex | Ê
Egrave | 200 | <Shift> E | backquote | È
Euml | 203 | <Shift> E | double quote | Ë
Iacute | 205 | <Shift> I | quote | Í
Icirc | 206 | <Shift> I | circumflex | Î
Igrave | 204 | <Shift> I | backquote | Ì
Iuml | 207 | <Shift> I | double quote | Ï
Ntilde | 209 | <Shift> N | tilde | Ñ
Oacute | 211 | <Shift> O | quote | Ó
Ocirc | 212 | <Shift> O | circumflex | Ô
Ograve | 210 | <Shift> O | backquote | Ò
Oslash | 216 | <Shift> O | slash | Ø
Otilde | 213 | <Shift> O | tilde | Õ
Ouml | 214 | <Shift> O | double quote | Ö
Thorn | 222 | <Shift> T | <Shift> H | Þ
Uacute | 205 | <Shift> U | quote | Ú
Ucirc | 206 | <Shift> U | circumflex | Û
Ugrave | 204 | <Shift> U | backquote | Ù
Uuml | 207 | <Shift> U | double quote | Ü
Yacute | 221 | <Shift> Y | quote | Ý
aelig | 230 | a | e | æ
aacute | 225 | a | quote | á
acirc | 226 | a | circumflex | â
agrave | 224 | a | backquote | à
aring | 229 | a | star | å
atilde | 227 | a | tilde | ã
auml | 228 | a | double quote | ä
brvbar | 166 | bar (pipe) | bar | ¦
ccedil | 231 | c | comma | ç
cent | 162 | c | slash | ¢
copy | 169 | c | o | ©
current | 164 | x | o | ¤
deg | 176 | ^ | 0 (zero) | °
eacute | 233 | e | quote | é
ecirc | 234 | e | circumflex | ê
egrave | 232 | e | backquote | è
euml | 235 | e | double quote | ë
eth | 240 | - | d | ð
frac12 | 189 | / | 2 | ½
frac14 | 188 | / | 4 | ¼
frac34 | 190 | / | 3 | ¾
hyphen | 173 | - (minus) | - |
iacute | 237 | i | quote | í
icirc | 238 | i | circumflex | î
igrave | 236 | i | backquote | ì
iexcl | 161 | ! | ! | ¡
iquest | 191 | ? | ? | ¿
laquo | 171 | < | < | «
macr | 175 | - (minus) | circumflex | ¯
micro | 181 | / | u | µ
middot | 183 | . | circumflex | ·
nbsp | 160 | <Ctrl> space | (none) |
not | 172 | - (minus) | comma | ¬
ntilde | 241 | n | tilde | ñ
oacute | 243 | o | quote | ó
ocirc | 244 | o | circumflex | ô
ograve | 242 | o | backquote | ò
oslash | 248 | o | slash | ø
otilde | 245 | o | tilde | õ
ouml | 246 | o | double quote | ö
ordf | 170 | a | _ (underscore) | ª
ordm | 186 | o | _ (underscore) | º
para | 182 | <Shift> P | ! | ¶
plusmn | 177 | + | - (minus) | ±
pound | 163 | l | - (minus) | £
raquo | 187 | > | > | »
reg | 174 | <Shift> R | <Shift> O | ®
sec | 167 | s | ! | §
sup1 | 185 | s | 1 | ¹
sup2 | 178 | s | 2 | ²
sup3 | 179 | s | 3 | ³
szlig | 223 | s | s | ß
thorn | 254 | t | h | þ
uacute | 250 | u | quote | ú
ucirc | 251 | u | circumflex | û
ugrave | 249 | u | backquote | ù
uuml | 252 | u | double quote | ü
yacute | 253 | y | quote | ý
yen | 165 | y | - (minus) | ¥
yuml | 255 | y | double quote | ÿ

### How to type accented characters on Mac OS X

With an international US keyboard (qwerty), accented characters are entered with the `Alt` key (aka `Option` key) as follows:

- Acute accent (´): `alt-e`, then the letter
- Grave accent (`): `alt-``, then the letter
- Circumflex accent (ˆ): `alt-i`, then the letter
- Tilde accent (˜): `alt-n`, then the letter
- Umlaut accent (¨): `alt-u`, then the letter
- The letter “c” with a cedilla (ç): `alt-c`

### About white space handling

As required by the HTML specification, Amaya removes insignificant white-space characters when it loads a document. This applies to (X)HTML, MathML, and SVG documents, as well as MathML and SVG elements included in a (X)HTML document,

The following are considered as insignificant white-space characters:

- End of line characters (`#xD` and `#xA`)
- Tab characters (`#x9`)
- Leading spaces of an element
- Trailing spaces of an element
- Contiguous spaces (one space is preserved)

To preserve all characters for some elements, use the `xml:space` attribute or the `pre` element (only in (X)HTML documents). The possible values for the `xml:space` attribute are `default` and `preserve`.

- `default` means that an applications' default white-space treatment is acceptable for these elements. In Amaya, the default treatment removes the insignificant white-space characters for all supported DTDs (see above).
- `preserve` indicates that applications must preserve all the characters, except the first one that immediately follows the end tag of the element where it is specified, if that element is an end of line.

The `xml:space` attribute applies to all elements within the element where it is specified, unless it is overridden with another instance of `xml:space`.

In an XHTML DTD, the `pre` element causes the same behavior as the `xml:space` attribute with the value `preserve`.