Shaun McCance
shaunm@gnome.org 2008-2009
Mark up general identifiers found on computer systems.

# System Items

    mal_inline_sys = element sys {
      mal_attr_link ?,
      attribute style { xsd:NMTOKENS } ?,
      attribute * - (mal:* | local:*) { text } *,

      mal_inline
    }

Use the `sys` element to mark up any type of system item that isn't covered by other elements such as `file`, `cmd`, or `code`.

# Notas

The `sys` element can contain a mixture of text and any general inline elements.

The `sys` element can occur in any general inline context, including inside most inline elements, some basic block elements, and certain informational elements.

The `sys` element can link to other pages or documents. See for more information.

The `style` attribute takes a space-separated list of style hints. Processing tools should adjust their behavior according to those style hints they understand.

The `sys` element can have attributes from external namespaces. See for more information on external-namespace attributes.

# Ejemplos

Use `sys` to mark up a domain name:

The Linux kernel is hosted on <sys>git.kernel.org</sys>.

The Linux kernel is hosted on git.kernel.org.

# Processing Expectations

System items are displayed in a fixed-width font. Fixed-width fonts tend to have more distinction between visually similar characters. This is particularly important in system items, since letters often appear without the context of a known word that helps make them discernable in normal prose.

# Comparison to Other Formats

The `sys` element is similar to the `systemitem` element in DocBook. DocBook has gained numerous elements which were once marked using the `class` attribute on the `systemitem` element. Since Mallard does not provide the level of markup specificity that DocBook does, the `sys` element should be used in place of these and various other elements.