%display-atts;Display attributes is a parameter entity declaration in the topic
DTD that includes attributes whose values may be used for affecting the display
of a topic or its selection by search tools.
[edit] Attributes
| Name
| Description
| Data Type
| Default Value
| Required?
|
| scale
| Specifies a percentage, selected from an enumerated list, that is
used to resize fonts in relation to the normal text size. This
attribute is primarily useful for print-oriented display.
The scale
attribute provides an acknowledged style-based property directly on DITA elements.
For the table and fig elements, the intent of the property is to allow authors
to adjust font sizes on the content of the containing element, primarily for
print accomodation. An image in these contexts is to be scaled only by its
own direct scale property. If not specifically scaled, such an image is unchanged
by the scale property of its parent table or fig.
| 60 | 70 | 80 | 90 | 100 | 110 | 120 | 140 | 160 | 180 | 200
| -dita-use-conref-target)
| #IMPLIED
| No
|
| frame
| Specifies which portion of a border should surround the element.
Allowable values are: top Draw a line before the element bottom Draw a line after the element topbot Draw a line both before and after the element all Draw a box around the element sides Draw a line at each side of the element none Don't draw any lines around this element -dita-use-conref-target See Using the -dita-use-conref-target value for more information.
Some DITA processors or output
formats may not be able to support all values.
| bottom | topbot | all | sides | none | -dita-use-conref-target)
| #IMPLIED
| No
|
| expanse
| Determines the horizontal placement of the element.
Allowable
values are: "page" places the element on the left page margin; "column"
aligns the element with the current column margin; "textline" aligns
the element with the left margin of the current text line and takes indention
into account.
See Using the -dita-use-conref-target value for
more information on the conref value.
For non-paginated output, such
as XHTML, some values may not be supported.
In DITA tables, in place of the expanse attribute used by other DITA elements, the pgwide attribute is
used in order to conform with the OASIS Exchange Table Model. This attribute has a similar semantic
(1=page width; 0=resize to galley or column).
| column | textline | -dita-use-conref-target)
| #IMPLIED
| No
|
[edit] Example
The %display-atts; parameter entity
is used within the DITA dtds as a common definition for attributes that affect
presentation of certain elements. Not all of these capabilities have been
provided yet for DITA topic processing. A typical example might be:
<codeblock scale="90" frame="topbot" expanse="page">
/* a long sample program */
Do forever
Say "Hello, World"
End
</codeblock>
TOC: Language_Specification_1.1
Parent topic: Commonly referenced attributes
Next topic: %global-atts;
|
|
