|  |  | 14.2 The page element

## 14.2 The `<page>` element

The `<page>` tag has the optional attributes `gridsize`, `title`, `section`, and `subsection`. The `gridsize` indicates the last grid size used on this page--Ipe remembers this as it is often advantageous to have the same grid available that was used when making the page. The title is displayed on the page in a format described in the style sheet. The value of `section` and `subsection` is the title of a section starting on 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.

The contents of the `<page>` element consists, in this order, of possibly empty sequences of `<layer>` elements, `<view>` elements, and Ipe object elements.

The `<layer>` tag takes a required attribute `name`, and two optional attributes `visible` and `edit`. The `name` has to be unique within the page, and must not contain spaces. If the value of `visible` is `dim`, the layer is displayed dimmed on the screen (not in the PDF output). The value of `edit` 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). The layer element must be empty.

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

The `<view>` tag takes a required attribute `layers`, and three optional attributes, `duration`, `transition`, and `effect`. The value of `layers` must be a sequence of layer names defined in this page, separated by white space. The value of `duration` and `transition` must be a real number, the value of `effect` must be an integer between 0 and 16 (see `IpeView::TEffect` for the exact meaning of those). The parameters translated directly into the page transition effect in PDF.

It is okay for a page not to contain any `<view>` element. Such a page will be saved to PDF including all its layers, with no special effect.

The remaining elements of the `<page>` are Ipe objects.

|  |  | 14.2 The page element