Ipe Manual -- 10.2 The <page> element

|  |  | 10.2 The <page> element

## 10.2 The <page> element

#### Attributes

title
  (optional) title of this page (displayed at a fixed location in a format specified by the style sheet),
section
  (optional) Title of document section starting with this page. If the attribute is not present, this page continues the section of the previous page. If the attribute is present, but its value is an empty string, then the contents of the `title` attribute is used instead.
subsection
  (optional) Title of document subsection starting with this page. If the attribute is not present, this page continues the subsection of the previous page. If the attribute is present, but its value is an empty string, then the contents of the `title` attribute is used instead.
marked
  (optional) The page is marked for printing unless the value of this attribute is `no`.

#### Contents

1. An optional `<notes>` element,
2. a possibly empty sequence of `<layer>` elements,
3. a possibly empty sequence of `<view>` elements,
4. a possibly empty sequence of Ipe object elements.

If a page contains no layer element, Ipe automatically adds a default layer named "alpha", visible and editable.

If a page contains no view element, a single view where all layers are visible is assumed.

### 10.2.1 The <notes> element

This element has no attributes. Its contents is plain text, containing notes for this page.

### 10.2.2 The <layer> element

#### Attributes

name
  (required) Name of the layer. It must not contain white space.
edit
  (optional) The value should be `yes` or `no` and indicates whether the user can select and modify the contents of the layer in the Ipe user interface (of course the user can always modify the setting of the attribute).
snap
  (optional) The value should be `never`, `visible`, or `always`, and indicates whether snapping to this layer is enabled. The default is `visible`.
data
  (optional) A free-use string associated with the layer. Ipe makes no use of this string, except for layers it creates itself for group edits.

The layer element must be empty.

### 10.2.3 The <view> element

#### Attributes

layers
  (required) The value must be a sequence of layer names defined in this page, separated by white space.
active
  (required) The layer that is the active layer in this view.
effect
  (optional) The symbolic name of a graphics effect to be used during the PDF page transition. The effect must be defined in the style sheet.
name
  (optional) The name of the view.
marked
  (optional) The view is marked for printing if the value of this attribute is `yes`.

The view element may be empty, or it may contain a sequence of attribute mappings and layer transformations.

An attribute mapping is a `<map>` element with three attributes `kind`, `from`, and `to`. The `kind` attribute must have one of the following values:

    pen, symbolsize, arrowsize, opacity, color, dashstyle, symbol

The attributes `from` and `to` must both be names of symbolic attribute values. The effect is that in this view, the symbolic attribute `from` is replaced by the symbolic attribute `to` for attributes of the given kind.

A layer transformation is a <transform> element. It must have two attributes: `layer` is the name of a layer of the page, `matrix` is a transformation matrix. In the view, all objects on that layer are transformed with this matrix.