Additional Properties

 Folding elements: foldable and not-foldable-child properties

<oXygen/> Author allows you to declare some elements to be foldable (collapsible). This is especially useful when working with large documents organized in logical blocks, editing a large DocBook article or book for instance.

To define the element whose content can be folded by the user, you must use the property: foldable:true;.

When collapsing an element, it is useful to keep some of its content visible, like a short description of the collapsed region. The property not-foldable-child is used to identify the child elements that are kept visible. It accepts as value an element name or a list of comma separated element names. If the element is marked as foldable (foldable:true;) but it doesn't have the property not-foldable-child or none of the specified non-foldable children exists then the element will still be foldable. In this case the element that will be kept visible when folded will be the before pseudo element.

[Note]Note

Both foldable and not-foldable-child are non standard properties and are recognized only by <oXygen/> Author.

 

Example 8.8. Folding DocBook Elements

All the elements below can have a title child element and are considered to be logical sections. You mark them as being foldable leaving the title element visible.

set,
book,
part,
reference,
chapter,
preface,
article,
sect1,
sect2,
sect3,
sect4,
section,
appendix,
figure,
example,
table {
    foldable:true;
    not-foldable-child: title;
}