Amaya

Inline markup

Text within a paragraph, heading, or other block element can be marked up in a variety of ways, for example to emphasise it, or to highlight text that should be entered by a user into a computer. Most of these inline elements are described in this page, although links, which are inline elements, are described separately.

Definitions

The dfn element is used to mark an inline definition (a word which is given as a defining instance)

Style sheets can be used to change the presentation of inline definitions.

Inline quotations

Quotations which are inline can be marked using the information type "quotation" - the HTML element q. This element is selected from the Character elements submenu of the Insert menu, or with the keyboard shortcut Ctrl i Ctrl q. It is possible to give a URI source for the quotation, using the cite attribute.

Style sheets can be used to change the presentation of inline quotations. The HTML specification states that inline quotation should be rendered with the appropriate punctuation marks for the language being represented.

Sample input, output and computer code

Elements are provided to mark computer code, such as statement:do-something, with separate markup for variables, as well as user input and program output - the elements code, var, kbd and samp. These elements are found in the Information types submenu of the Insert menu, and there are keyboard shortcuts for all of them - Ctrl i followed by Ctrl t for code, Ctrl v for variables, Ctrl k for user input and Ctrl m for sample output.

Style sheets can be used to change the presentation of these elements.

Acronyms and abbreviations

Acronyms and abbreviations should be marked as such, using the abbr and acronym elements available in the Information types submenu of the Insert menu. There is also the shortcut Ctrl i Ctrl y for acronym. This allows recognition for different types of systems.

The title attribute can also be used to specify the expansion of the acronym. Select the text to be marked, for example W3C, select the Insert menu, the information types submenu, and the option acronym. Then select the entire element (F2 key), open the Attributes menu, select title, enter World Wide Web Consortium, and apply it.

Style sheets can be used to change the presentation of acronyms or abbreviations.

Insertions and deletions

The del and ins elements are available in the Information types submenu of the Insert menu to mark text which ought to be deleted or which has already been inserted.

Style sheets can be used to change the presentation of insertions and deletions.

Emphasis elements

HTML has elements to define two levels of emphasis:

  1. Ordinary emphasis, using the em element and
  2. Strong emphasis, using the strong element.

Both types of emphasis can be applied from the toolbar using the Emphasis and Strong buttons, or from the Information types submenu of the Insert menu. There are also standard keyboard shortcuts - Ctrl i Ctrl e  for emphasis (because the default rendering is often italicised text) and Ctrl i Ctrl s for strong emphasis (becuase the default rendering is often bold text). If there is a current selection, the emphaisis is applied to that, otherwise the appropriate element is created, as a child of the current element.

The emphasis elements are toggled in Amaya - to remove an emphasis select the element and reapply the appropriate emphasis. For example place the cursor somewhere in a strong element, use the F2 key to select the element, and then use the keyboard shortcut, menu item, or the Strong button - the strong element will be removed.

Style sheets can be used to change the presentation of both types of emphasis.

Span element

The span element in conjunction with a id (style or class) attribute offers a generic mechanism for adding structure to a document. This element is generated by Amaya when the user applies an attribute to a piece of text. It's removed when the attribute is deleted.